Tired of leaving your AI conversation to check your wallet balance? walletgetbalance, walletpreparetransfer and more — now available as MCP tools. Works with Claude Desktop, Cursor, Copilot. Zero backend. No private keys.
MCP server for EVM wallet operations — balance queries, transfer preparation, gas estimation, and transaction tracking across Ethereum, Polygon, and Base.
Developer Tooling / AI Agent Infrastructure
Overview
@spntn/wallet-mcp is an open-source Model Context Protocol (MCP) server that gives AI agents native EVM wallet capabilities. It enables agents running in Claude Desktop, Cursor, GitHub Copilot, and any MCP-compatible client to query balances, prepare transfers, estimate gas, and track transactions across Ethereum, Polygon, and Base — all through natural language.
No backend required. No private keys held. The server runs locally via stdio and communicates directly with public RPC endpoints.
The Problem It Solves
AI agents today can reason about blockchain data but cannot act on it. Asking Claude "what is my USDC balance on Polygon?" requires the user to leave the conversation, open a block explorer, and copy-paste results back. Asking an agent to "prepare a transfer of 10 USDC to this address" is simply not possible without a tool layer.
@spntn/wallet-mcp closes this gap by exposing wallet operations as first-class MCP tools — letting agents handle the blockchain interaction layer while the user retains full control over transaction signing.
Tools
walletgetbalance Get native or ERC-20 token balance for any wallet
walletgetall_balances Get balances across all supported chains at once
walletpreparetransfer Prepare a transfer transaction (unsigned) for user to sign
walletgetgas_price Get current gas price on any supported chain
walletgettransaction Check status and details of any transaction
Supported Chains
Ethereum Mainnet (ETH, USDC, USDT, WETH)
Polygon Mainnet (POL, USDC, USDT, WMATIC)
Base Mainnet (ETH, USDC, WETH)
Fee Model
A 0.2% platform fee is included in transfer transactions. The fee is prepared as a separate transaction step — no hidden deductions.
Quick Start
# One-time run
FEE_WALLET=0xYOUR_WALLET npx @spntn/wallet-mcpConfigure in Claude DesktopSecurity
{
"mcpServers": {
"wallet": {
"command": "npx",
"args": ["-y", "@spntn/wallet-mcp"],
"env": {
"FEE_WALLET": "0xYOUR_WALLET_ADDRESS",
"POLYGON_RPC_URL": "https://polygon.llamarpc.com",
"ETH_RPC_URL": "https://eth.llamarpc.com",
"BASE_RPC_URL": "https://mainnet.base.org"
}
}
}
}Environment Variables
Variable - Required - Description
FEE_WALLET - ✅ - Your wallet address to receive 0.2% platform fees
POLYGONRPCURL - ❌ - Custom Polygon RPC (default: llamarpc)
ETHRPCURL - ❌ - Custom Ethereum RPC (default: llamarpc)
BASERPCURL - ❌ - Custom Base RPC (default: mainnet.base.org)
Example Agent Prompts
"What is my USDC balance on Polygon? Wallet: 0x..." "Show all my balances across all chains" "Prepare a transfer of 10 USDC to 0x... on Base" "What's the current gas price on Ethereum?" "Check the status of transaction 0x..."
Security
This server never holds private keys
Transfer tool prepares unsigned transactions only — user must sign with their own wallet
RPC calls are read-only for balance/gas queries