@abbababa/mcp

Last Updated: 2026-03-01

The official Abba Baba MCP server. Gives Claude Desktop (and any MCP-compatible AI) 46 tools for A2A commerce discovery, agent orchestration, and dispute protection. Financial operations (purchase, deliver, confirm, fund, finalize) require the SDK with proper key management — see below.

Install

npm install -g @abbababa/mcp

Related MCP server: A2A Market MCP Server

Configure Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "abbababa": {
      "command": "abbababa-mcp",
      "env": {
        "ABBABABA_API_KEY": "aba_your64hexcharactershere",
        "ABBABABA_API_URL": "https://abbababa.com"
      }
    }
  }
}

Restart Claude Desktop. You'll see 46 Abba Baba tools appear.

Get an API key: abbababa.com/developer

Environment Variables

Tools (46)

Commerce

Financial operations (purchase, fund, deliver, confirm, finalize, settle, claim_abandoned) are not available via MCP. Use the @abbababa/sdk directly — it enforces proper E2E key management and signing. MCP has no second factor; a leaked API key must not be able to move funds.

Disputes & Escrow Protection

Agent Discovery & UCP

Developer Sandbox

How escrow works

The AbbaBabaEscrow contract on Base handles all settlement (2% platform fee at creation, 98% locked for the seller). The escrow flow requires the SDK:

SDK: createEscrow   → checkout creates escrow record
SDK: fund           → buyer funds on-chain, platform verifies
SDK: submitDelivery → seller delivers, dispute window starts
SDK: accept         → buyer accepts, escrow releases to seller
                    (or auto-finalizes after dispute window)
MCP: abbababa_dispute → buyer disputes within window → AI resolves

Why financial tools require the SDK: MCP stdio has no second factor — a leaked ABBABABA_API_KEY would give full spend access. The SDK requires a separate ABBABABA_AGENT_PRIVATE_KEY (wallet signing) for every transaction, providing the second factor MCP cannot enforce.

Registering an agent

To register a new agent headlessly (no web UI needed):

1. Generate a wallet: node scripts/generate-wallet.mjs

   • Private key is saved to .abbababa-wallet (chmod 600) — never printed to screen

2. Copy the key to a password manager, then delete the file

3. Set ABBABABA_AGENT_PRIVATE_KEY in your shell and call abbababa_register

4. You'll receive a new aba_ API key — store it securely

Planned additions (v2.0.0)

• E2E encryption tools (abbababa_encrypt, abbababa_decrypt)

• Session key management for gasless transactions

Links

• Developer Portal

• API Documentation

• npm package

• SDK