mcpField
N
near-wallet-manager

near-wallet-manager

Local
github.com/mastrophotFinance0Updated 33w ago
Repository

About near-wallet-manager

near-wallet-manager is an MCP server for agents that need to create NEAR wallets, inspect balances, and sign transactions. It supports generated or imported keys and returns signed transaction data.

Key features

  1. 01Create wallets with generated or imported keys
  2. 02Check total, locked, and available balances
  3. 03Sign transfer and function-call transactions

Use cases

  1. 01Provision a NEAR wallet for an agent workflow
  2. 02Review an account balance before an operation
  3. 03Sign a NEAR transaction with a dedicated account

MCP support

Exposes three MCP tools: `create_wallet`, `check_balance`, and `sign_transaction`. Clients can launch it with the `mcp-near-wallet-manager` command.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "mastrophot-near-wallet-manager": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-near-wallet-manager"
      ]
    }
  }
}
Run commandnpx -y mcp-near-wallet-manager

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmmcp-near-wallet-manager0.1.1

Tools

3

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
networkenumNomainnet | testnet | custom
account_idstringNoOptional named/implicit account id to associate
private_keystringNoOptional: import existing ed25519 private key
include_private_keybooleanNo

Details

From the project README

mcp-near-wallet-manager

MCP server for NEAR wallet operations with three production tools:

  • create_wallet
  • check_balance
  • sign_transaction

Designed for agent workflows where wallets must be provisioned, checked, and used for deterministic signing.

What This Delivers (Job Mapping)

  1. Wallet creation
  • Generates ED25519 keypair or imports existing private key
  • Returns public key + implicit account id
  1. Balance checking
  • Fetches account balance over NEAR JSON-RPC
  • Returns total/locked/available balances and key count
  1. Transaction signing
  • Signs NEAR transaction payloads with transfer/function_call actions
  • Returns transaction hash, signature, and base64 signed transaction blob

Install

npm install -g mcp-near-wallet-manager

MCP Config Example (Claude Desktop)

{
  "mcpServers": {
    "near-wallet-manager": {
      "command": "mcp-near-wallet-manager"
    }
  }
}

Tool Inputs

create_wallet
{
  "network": "testnet",
  "include_private_key": true
}
check_balance
{
  "account_id": "near",
  "network": "mainnet"
}
sign_transaction
{
  "signer_id": "alice.testnet",
  "signer_private_key": "ed25519:...",
  "receiver_id": "bob.testnet",
  "nonce": "7",
  "recent_block_hash": "11111111111111111111111111111111",
  "actions": [
    {
      "type": "transfer",
      "deposit_yocto": "1"
    }
  ]
}

Development

npm install
npm run check

Security Notes

  • create_wallet may return a private key: treat as sensitive secret.
  • Never store private keys in plaintext logs.
  • Use dedicated signer accounts and minimal permissions.

Publish Targets

  • npm package: mcp-near-wallet-manager
  • Agent framework integration notes: deliverables/agent-framework-integration.md
  • MCP Registry metadata: server.json

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.