Skip to content
MCP server

Keyban Agent Wallet

Gives an AI agent its own non-custodial wallet with spending rules and USDC payments

Runs locallyStatus and history
Install
Pricing
Free trial
Platforms
CLI, API
Runs
Locally
Version
0.3.0
Listing updated
3 days ago

About Keyban Agent Wallet

Keyban Agent Wallet is an MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Each agent gets a blockchain account of its own, and payment rules set by the organisation decide what it may spend. The registry entry lists balances, USDC transfers and x402 payments made under policy, so an agent can pay for services as it works instead of borrowing a human's card.

The server runs locally over stdio through the @keyban/cli package and needs a Keyban API key and application ID, plus a network such as base or xdc. In wallet mode it drives a deployed account whose signing key is shared through FROST signing; in prepaid mode the organisation's prepaid credit pays instead. The API key is kept away from the model.

Keyban's site pitches this for finance teams who want to cap a mission rather than a single transaction, and says it is non-custodial. It also offers Trust and Digital Passport products, which are separate from this server.

Install

Run in a terminal

claude mcp add agent-wallet --env KEYBAN_API_KEY='<KEYBAN_API_KEY>' --env KEYBAN_APP_ID='<KEYBAN_APP_ID>' --env KEYBAN_INVITE_KEY='<KEYBAN_INVITE_KEY>' --env KEYBAN_NETWORK='<KEYBAN_NETWORK>' --env KEYBAN_DKG_BLOB='<KEYBAN_DKG_BLOB>' -- npx -y @keyban/cli

Add to claude_desktop_config.json

{
  "mcpServers": {
    "agent-wallet": {
      "command": "npx",
      "args": [
        "-y",
        "@keyban/cli"
      ],
      "env": {
        "KEYBAN_API_KEY": "<KEYBAN_API_KEY>",
        "KEYBAN_APP_ID": "<KEYBAN_APP_ID>",
        "KEYBAN_INVITE_KEY": "<KEYBAN_INVITE_KEY>",
        "KEYBAN_NETWORK": "<KEYBAN_NETWORK>",
        "KEYBAN_DKG_BLOB": "<KEYBAN_DKG_BLOB>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "agent-wallet": {
      "command": "npx",
      "args": [
        "-y",
        "@keyban/cli"
      ],
      "env": {
        "KEYBAN_API_KEY": "<KEYBAN_API_KEY>",
        "KEYBAN_APP_ID": "<KEYBAN_APP_ID>",
        "KEYBAN_INVITE_KEY": "<KEYBAN_INVITE_KEY>",
        "KEYBAN_NETWORK": "<KEYBAN_NETWORK>",
        "KEYBAN_DKG_BLOB": "<KEYBAN_DKG_BLOB>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "agent-wallet": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@keyban/cli"
      ],
      "env": {
        "KEYBAN_API_KEY": "<KEYBAN_API_KEY>",
        "KEYBAN_APP_ID": "<KEYBAN_APP_ID>",
        "KEYBAN_INVITE_KEY": "<KEYBAN_INVITE_KEY>",
        "KEYBAN_NETWORK": "<KEYBAN_NETWORK>",
        "KEYBAN_DKG_BLOB": "<KEYBAN_DKG_BLOB>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "agent-wallet": {
      "command": "npx",
      "args": [
        "-y",
        "@keyban/cli"
      ],
      "env": {
        "KEYBAN_API_KEY": "<KEYBAN_API_KEY>",
        "KEYBAN_APP_ID": "<KEYBAN_APP_ID>",
        "KEYBAN_INVITE_KEY": "<KEYBAN_INVITE_KEY>",
        "KEYBAN_NETWORK": "<KEYBAN_NETWORK>",
        "KEYBAN_DKG_BLOB": "<KEYBAN_DKG_BLOB>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "agent-wallet": {
      "command": "npx",
      "args": [
        "-y",
        "@keyban/cli"
      ],
      "env": {
        "KEYBAN_API_KEY": "<KEYBAN_API_KEY>",
        "KEYBAN_APP_ID": "<KEYBAN_APP_ID>",
        "KEYBAN_INVITE_KEY": "<KEYBAN_INVITE_KEY>",
        "KEYBAN_NETWORK": "<KEYBAN_NETWORK>",
        "KEYBAN_DKG_BLOB": "<KEYBAN_DKG_BLOB>"
      }
    }
  }
}

Configuration

  • KEYBAN_API_KEYKeyban API key of the application the wallet belongs to. Never exposed to the model.Required
  • KEYBAN_APP_IDIdentifier of the Keyban application.Required
  • KEYBAN_INVITE_KEYWallet 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_ADDRESSWallet mode only. Address of the deployed SchnorrAccount this server drives (0x + 40 hex).
  • KEYBAN_FUNDINGWho 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_NETWORKBlockchain network the wallet operates on, for example base or xdc.Required
  • KEYBAN_BASE_URLBase URL of the Keyban backend. Accepts a full URL, or one of the environment aliases dev, testing, staging, prod and sandbox.
  • KEYBAN_DKG_BLOBOptional 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_FILEPath the server writes its log to.
  • MCP_LOG_LEVELLog verbosity.

What it does

Agent wallet
Opens a blockchain wallet dedicated to one AI agent, held non-custodially.
USDC transfers
Lets the agent send USDC and check balances on the configured network.
x402 payments
Pays for services that request payment over the x402 protocol, under policy.
Funding modes
Pays from the agent's own wallet or from the organisation's prepaid credit.
Secret handling
The Keyban API key is documented as never exposed to the model.

Good for

  • Let an agent pay per call for APIs and data
  • Set spending rules for an agent before it buys
  • Run agents on prepaid credit with no wallet address
  • Check an agent's balance on Base or XDC

Pricing

Free trial

Agent Wallet free for three months, no card; later prices not published

Prices change. Check keyban.io before you buy.

Keyban Agent Wallet FAQ

Which networks does it support?

The network is set through KEYBAN_NETWORK, with base and xdc given as examples.

What does it cost?

Keyban's site says Agent Wallet is free for three months with no card; later pricing is not published.

How does it run?

Locally over stdio via the npm package @keyban/cli, with a Keyban API key and app ID.

Is it custodial?

The site describes it as non-custodial.

What is the prepaid mode?

With KEYBAN_FUNDING set to prepaid, payments come from the organisation's prepaid credit, with no wallet address or invite key.

Is Keyban Agent Wallet free?

Keyban Agent Wallet is a paid product with a free trial.

How do I add Keyban Agent Wallet to Claude Code?

Run this command in your terminal: claude mcp add agent-wallet --env KEYBAN_API_KEY='<KEYBAN_API_KEY>' --env KEYBAN_APP_ID='<KEYBAN_APP_ID>' --env KEYBAN_INVITE_KEY='<KEYBAN_INVITE_KEY>' --env KEYBAN_NETWORK='<KEYBAN_NETWORK>' --env KEYBAN_DKG_BLOB='<KEYBAN_DKG_BLOB>' -- npx -y @keyban/cli

What are the best alternatives to Keyban Agent Wallet?

The closest alternatives to Keyban Agent Wallet are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

Alternatives to Keyban Agent Wallet

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government