NEAR Wallet Server

An MCP (Model Context Protocol) server that enables Claude and other AI assistants to interact with NEAR Protocol wallets and blockchain data.

Features

• Account Operations: Query balances, account info, access keys
• Token Operations: FT (NEP-141) balance and metadata queries
• Staking: Check staking pool positions and rewards
• Contract Interaction: Call view methods on any NEAR smart contract
• Network Info: Block data, validators, gas prices, protocol config
• Transaction Tracking: Look up transaction status and details
• Explorer URLs: Generate NearBlocks links for any entity

Tools

Tool	Description
get_account_balance	Get NEAR balance (available, staked, storage)
get_account_info	Detailed account info (code hash, storage)
get_transaction_status	Transaction details by hash
get_access_keys	List account access keys
view_contract_method	Call read-only contract methods
get_block_info	Block details (latest or by ID)
get_validators	Current validator set and stakes
get_gas_price	Current gas price
get_protocol_config	Protocol parameters
get_ft_balance	Fungible token balance
get_ft_metadata	Token metadata (name, symbol, decimals)
get_staking_info	Staking pool position
near_explorer_url	Generate NearBlocks URLs

Installation

npm install
npm run build

Configuration

Set environment variables:

export NEAR_NETWORK=mainnet  # or testnet
export NEAR_NODE_URL=https://rpc.mainnet.near.org  # optional, auto-detected from network

Usage with Claude Desktop

Add to your claude_desktop_config.json:

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

Example Queries

Once configured, you can ask Claude:

• "What's the balance of alice.near?"
• "Show me the validators on NEAR mainnet"
• "Check the USDT balance of bob.near on usdt.tether-token.near"
• "What's the latest block on NEAR?"
• "Look up transaction 8xK2... from alice.near"

License

MIT