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

2. Balance checking

• Fetches account balance over NEAR JSON-RPC

• Returns total/locked/available balances and key count

3. 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