What is an MCP wallet server?

A technical primer on connecting AI agents to onchain operations

MCP Protocol

Definition

An MCP wallet server is a software service that exposes cryptocurrency wallet operations—such as checking balances, sending transactions, signing messages, and swapping tokens—through the Model Context Protocol (MCP). MCP is an open standard, originally developed by Anthropic, that lets AI agents discover and call external tools through a standardized interface. The wallet server acts as a bridge: on one side, it holds or manages private keys and connects to blockchains; on the other, it presents wallet functions as named tools that any MCP-compatible client can invoke with structured parameters.

How it works

The mechanism has three layers. First, the transport layer: the server runs as a local process or remote service and communicates with the AI agent via stdio, HTTP with Server-Sent Events, or WebSockets. The agent and server exchange JSON-RPC messages following MCP conventions. When the agent starts, it requests a list of available tools from the server.

Second, the tool layer: the wallet server registers each operation as a tool with a name, description, and input schema. For example, a tool called send_transaction might accept parameters for recipient address, amount, and token identifier. The agent's language model uses these descriptions to decide which tool to call based on the user's natural language request. The model does not hold keys or construct raw transactions itself—it only generates the tool call with the correct arguments.

Third, the execution layer: the server receives the tool call, validates the parameters, performs the cryptographic signing with its managed keys, broadcasts the transaction to the appropriate blockchain network, and returns the result to the agent. This separation means the AI agent handles intent and reasoning while the wallet server handles security-critical key operations and chain communication. Custody models vary: some servers use MPC (multi-party computation) to distribute key shares, others use smart accounts with programmable permissions, and some operate as fully custodial services.

Examples on agentwallet.md

The following entries in the agentwallet.md directory implement or support MCP-based wallet access for AI agents:

🔧

Coinbase AgentKit

Open-source toolkit with MCP server support for Base, Ethereum, Polygon, Arbitrum, and Solana. Uses MPC custody. Best for getting started fast with agent wallets.

🔐

MetaMask Smart Accounts

User-delegated agent actions with scoped permissions via smart accounts on Ethereum, Polygon, Arbitrum, and Optimism. Closed source.

💰

Circle Programmable Wallets

MPC-based wallets optimized for USDC operations across Ethereum, Polygon, Solana, and Avalanche.

⚡

Skyfire

Custodial wallets for agent micropayments and agent-to-agent payments on Ethereum and Base.

🛡️

Crossmint

MPC wallets with built-in KYC and fiat on-ramp for compliance-first agents. Supports Ethereum, Polygon, Solana, and Base.

Frequently asked questions

What does MCP stand for in wallet servers?

MCP stands for Model Context Protocol, an open protocol developed by Anthropic that standardizes how AI agents connect to external tools and data sources. An MCP wallet server uses this protocol to expose blockchain wallet operations as callable functions.

Which AI agents can connect to MCP wallet servers?

Any MCP-compatible client can connect, including Claude Desktop, Cursor, GitHub Copilot, and OpenAI's Codex CLI. The agent discovers available tools automatically from the server and calls them with natural language prompts.

What operations can an MCP wallet server perform?

Common operations include checking balances, sending transactions, signing messages, swapping tokens, and reading on-chain data. The specific tools available depend on which wallet server implementation you connect to.

Is an MCP wallet server the same as a regular crypto wallet?

No. A regular crypto wallet is designed for human users with a graphical interface. An MCP wallet server is headless software that exposes wallet functions through the Model Context Protocol, designed specifically for AI agents to call programmatically.

How do I choose between different MCP wallet servers?

Key factors include custody model (self-custodial, MPC, or custodial), supported blockchains, whether the code is open source, and specific use cases like stablecoin operations, micropayments, or compliance requirements. The agentwallet.md directory lists verified options with these details.