MCP Toolkit
Build MCP servers that give AI agents self-custodial WDK wallets
The MCP Toolkit lets AI agents interact with self-custodial WDK wallets. It creates an MCP server that exposes wallet operations (checking balances, sending transactions, swapping tokens, bridging assets, and more) as structured tools that any MCP-compatible AI client can call.
Powered by @tetherto/wdk-mcp-toolkit.
Source preview - These pages describe repository revision 0640ef2, which declares v1.0.0-beta.1. That version is not published on npm; the npm 0.0.0 placeholder does not provide the toolkit. Use the source setup. APIs may change.
Features
- MCP Server Extension - Extends the official
@modelcontextprotocol/sdkMcpServer with WDK-specific capabilities - Multi-Chain - Support for 13 blockchains out of the box, including EVM chains, Bitcoin, Solana, Spark, TON, and Tron
- 35 Built-in Tools - Ready-to-use tools for wallets, pricing, indexer queries, swaps, bridges, lending, and fiat on/off-ramps
- Configurable Confirmation - Tools that request confirmation use MCP elicitation when enabled; disabling it automatically accepts confirmation requests
- Extensible - Register custom tools alongside built-in ones using standard MCP SDK patterns
- Tool Selection - Register read-only or write tools for your application. Tool selection does not isolate the server's seed or enforce limits against code with access to its environment. See confirmation and agent access.
Built-in Chain Identifiers
The pinned source exports identifiers for 13 built-in chains. Common identifiers used across these docs include:
| Chain | Identifier |
|---|---|
| Ethereum | ethereum |
| Arbitrum | arbitrum |
| Plasma | plasma |
| Bitcoin | bitcoin |
| Solana | solana |
| Spark | spark |
| TON | ton |
| Tron | tron |
Read the package's CHAINS export when your application needs the complete pinned registry. You can register any blockchain name - the constants are for convenience only. For custom chains, register tokens manually with registerToken().
Get Started
Install and run your first MCP server in minutes
Configuration
Wallets, capabilities, tokens, protocols, and custom tools
API Reference
All 35 built-in MCP tools and the WdkMcpServer class
LangChain Integration
Use WDK tools in LangChain agents via the serve CLI
WDK CLI
Use a ready-made local wallet CLI, daemon, and MCP server when you do not need to build a custom MCP server