Give an AI agent its own blockchain wallet: balances, USDC transfers, x402 payments under policy.
Connect Runs on your machine
claude mcp add agent-wallet -e KEYBAN_API_KEY=<KEYBAN_API_KEY> -e KEYBAN_APP_ID=<KEYBAN_APP_ID> -e KEYBAN_INVITE_KEY=<KEYBAN_INVITE_KEY> -e KEYBAN_WALLET_ADDRESS=<KEYBAN_WALLET_ADDRESS> -e KEYBAN_FUNDING=<KEYBAN_FUNDING> -e KEYBAN_NETWORK=<KEYBAN_NETWORK> -e KEYBAN_BASE_URL=<KEYBAN_BASE_URL> -e KEYBAN_DKG_BLOB=<KEYBAN_DKG_BLOB> -e MCP_LOG_FILE=<MCP_LOG_FILE> -e MCP_LOG_LEVEL=<MCP_LOG_LEVEL> -- npx -y @keyban/[email protected]{
"mcpServers": {
"agent-wallet": {
"command": "npx",
"args": [
"-y",
"@keyban/[email protected]"
],
"env": {
"KEYBAN_API_KEY": "<KEYBAN_API_KEY>",
"KEYBAN_APP_ID": "<KEYBAN_APP_ID>",
"KEYBAN_INVITE_KEY": "<KEYBAN_INVITE_KEY>",
"KEYBAN_WALLET_ADDRESS": "<KEYBAN_WALLET_ADDRESS>",
"KEYBAN_FUNDING": "<KEYBAN_FUNDING>",
"KEYBAN_NETWORK": "<KEYBAN_NETWORK>",
"KEYBAN_BASE_URL": "<KEYBAN_BASE_URL>",
"KEYBAN_DKG_BLOB": "<KEYBAN_DKG_BLOB>",
"MCP_LOG_FILE": "<MCP_LOG_FILE>",
"MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>"
}
}
}
}{
"mcpServers": {
"agent-wallet": {
"command": "npx",
"args": [
"-y",
"@keyban/[email protected]"
],
"env": {
"KEYBAN_API_KEY": "<KEYBAN_API_KEY>",
"KEYBAN_APP_ID": "<KEYBAN_APP_ID>",
"KEYBAN_INVITE_KEY": "<KEYBAN_INVITE_KEY>",
"KEYBAN_WALLET_ADDRESS": "<KEYBAN_WALLET_ADDRESS>",
"KEYBAN_FUNDING": "<KEYBAN_FUNDING>",
"KEYBAN_NETWORK": "<KEYBAN_NETWORK>",
"KEYBAN_BASE_URL": "<KEYBAN_BASE_URL>",
"KEYBAN_DKG_BLOB": "<KEYBAN_DKG_BLOB>",
"MCP_LOG_FILE": "<MCP_LOG_FILE>",
"MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>"
}
}
}
}{
"servers": {
"agent-wallet": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@keyban/[email protected]"
],
"env": {
"KEYBAN_API_KEY": "<KEYBAN_API_KEY>",
"KEYBAN_APP_ID": "<KEYBAN_APP_ID>",
"KEYBAN_INVITE_KEY": "<KEYBAN_INVITE_KEY>",
"KEYBAN_WALLET_ADDRESS": "<KEYBAN_WALLET_ADDRESS>",
"KEYBAN_FUNDING": "<KEYBAN_FUNDING>",
"KEYBAN_NETWORK": "<KEYBAN_NETWORK>",
"KEYBAN_BASE_URL": "<KEYBAN_BASE_URL>",
"KEYBAN_DKG_BLOB": "<KEYBAN_DKG_BLOB>",
"MCP_LOG_FILE": "<MCP_LOG_FILE>",
"MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
KEYBAN_API_KEYRequired, secret | Keyban API key of the application the wallet belongs to. Never exposed to the model. |
KEYBAN_APP_IDRequired | Identifier of the Keyban application. |
KEYBAN_INVITE_KEYOptional, secret | Wallet mode only. One-shot ECDSA private key (0x + 64 hex) authorizing the first-boot registration of this client as a FROST signer of the wallet. |
KEYBAN_WALLET_ADDRESSOptional | Wallet mode only. Address of the deployed SchnorrAccount this server drives (0x + 40 hex). |
KEYBAN_FUNDINGOptional | Who pays for the payments: wallet (the agent's own wallet) or prepaid (the organization's prepaid credit, with no wallet address or invite key). |
KEYBAN_NETWORKRequired | Blockchain network the wallet operates on, for example base or xdc. |
KEYBAN_BASE_URLOptional | Base URL of the Keyban backend. Accepts a full URL, or one of the environment aliases dev, testing, staging, prod and sandbox. |
KEYBAN_DKG_BLOBOptional, secret | Optional pre-generated FROST client share, base64-encoded JSON. Used by hosted runtimes whose disk does not last; it does not replace the invite key. |
MCP_LOG_FILEOptional | Path the server writes its log to. |
MCP_LOG_LEVELOptional | Log verbosity. |
Details
| Package | @keyban/[email protected] (NPM, stdio) |
| First published | 13 Nov 2026 |
| Last updated | 13 Nov 2026 |
| Registry name | io.keyban.mcp/agent-wallet |
More finance and crypto servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.