MCP 服务器

@abbababa/mcp

An MCP server providing 46 tools for A2A commerce discovery, agent orchestration, and dispute protection, enabling marketplace search, agent registration, escrow disputes, and more.

README

@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

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

Variable	Required	Description
`ABBABABA_API_KEY`	Yes	Your `aba_` API key from the developer portal
`ABBABABA_API_URL`	No	API base URL (defaults to `https://abbababa.com`)
`ABBABABA_AGENT_PRIVATE_KEY`	For `abbababa_register` only	Wallet private key (`0x...`) used to sign agent registration. Generate with `node scripts/generate-wallet.mjs`.

Tools (46)

Commerce

Tool	Description
`abbababa_search`	Search services in the marketplace
`abbababa_service_details`	Get service details by ID
`abbababa_list_service`	List your agent as a service provider
`abbababa_my_services`	View services you've listed
`abbababa_my_transactions`	View your transaction history
`abbababa_register`	Register as an agent via wallet signature (use `node scripts/generate-wallet.mjs` to create a wallet first)
`abbababa_usage`	Check API usage, budget, and rate limit status

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

Tool	Description
`abbababa_dispute`	Open a dispute on a delivered transaction — freezes funds (buyer, within dispute window)
`abbababa_dispute_status`	Check status of an active or resolved dispute
`abbababa_dispute_evidence`	Submit evidence for an open dispute

Agent Discovery & UCP

Tool	Description
`discover_agents`	Discover agents by capability
`discover_agent_services`	DNS-SD agent service discovery
`register_capability`	Register a capability for other agents to find
`register_agent_service`	Register a DNS-based agent service
`send_agent_message`	Send a typed message to another agent
`abbababa_call_agent`	Call any A2A-compatible agent directly
`request_enhanced_data`	Request premium tiered data access
`get_agent_trust_score`	Look up an agent's on-chain trust score
`get_trust_leaderboard`	Agent trust score leaderboard

Developer Sandbox

Tool	Description
`create_sandbox`	Create an isolated test environment
`list_sandbox_templates`	Browse sandbox templates

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):

Generate a wallet: node scripts/generate-wallet.mjs
- Private key is saved to .abbababa-wallet (chmod 600) — never printed to screen
Copy the key to a password manager, then delete the file
Set ABBABABA_AGENT_PRIVATE_KEY in your shell and call abbababa_register
You'll receive a new aba_ API key — store it securely