MCP NEAR Wallet (Read-Only)

An MCP server providing read-only access to NEAR blockchain wallet information. Perfect for checking balances, viewing transactions, and inspecting accounts without any signing capabilities.

Features

• check_balance - Get available, staked, and total NEAR balance
• view_transactions - View recent transaction history
• get_account_info - Detailed account information (storage, code hash, etc.)
• list_access_keys - List all access keys with permissions

Installation

npm install
npm run build

Configuration

Set environment variables:

# Network selection (mainnet or testnet)
export NEAR_NETWORK=mainnet

# Optional: Custom RPC URL
export NEAR_RPC_URL=https://rpc.mainnet.near.org

Usage with Claude Desktop

Add to your Claude Desktop configuration (~/.config/claude/claude_desktop_config.json):

{
  "mcpServers": {
    "near-wallet": {
      "command": "node",
      "args": ["/path/to/mcp-near-wallet-readonly/dist/index.js"],
      "env": {
        "NEAR_NETWORK": "mainnet"
      }
    }
  }
}

Example Queries

Once connected, you can ask Claude:

• "Check the balance of alice.near"
• "Show me the access keys for my-account.testnet"
• "Get account info for aurora.pool.near"
• "View recent transactions for example.near"

Security

This server is read-only by design. It cannot:

• Sign transactions
• Transfer funds
• Modify access keys
• Deploy contracts

Safe to use with any account ID - it only queries public blockchain data.

License

MIT