{"_id":"@abbababa/mcp","name":"@abbababa/mcp","dist-tags":{"latest":"1.2.0"},"versions":{"1.2.0":{"name":"@abbababa/mcp","version":"1.2.0","description":"Abba Baba MCP server — 46 tools for A2A commerce, discovery, and settlement","type":"module","bin":{"abbababa-mcp":"dist/index.js"},"main":"dist/index.js","exports":{".":"./dist/index.js"},"scripts":{"build":"tsc -p tsconfig.json","dev":"tsx src/index.ts","start":"node dist/index.js","register":"node scripts/register.mjs","generate-wallet":"node scripts/generate-wallet.mjs"},"dependencies":{"@modelcontextprotocol/sdk":"^1.25.2","@noble/curves":"^1.9.7","viem":"^2.0.0"},"engines":{"node":">=18"},"keywords":["mcp","model-context-protocol","a2a","agent","settlement","escrow","abbababa"],"license":"MIT","repository":{"type":"git","url":"git+https://github.com/Abba-Baba/abbababa-mcp.git"},"bugs":{"url":"https://github.com/Abba-Baba/abbababa-mcp/issues"},"homepage":"https://github.com/Abba-Baba/abbababa-mcp#readme","_id":"@abbababa/mcp@1.2.0","gitHead":"ff20239ecf792d2504bcdb8a56cec693b672bbcd","types":"./dist/index.d.ts","_nodeVersion":"24.8.0","_npmVersion":"11.6.0","dist":{"integrity":"sha512-gWKxBHeK+9zT1mPm4CWid84oMo+0SWIRcg+LnNRXArANn7PlpdESjfjqvvkfnnhy/uWfm+qp9RPixurzPqh4Nw==","shasum":"9a55ad4773c0306fa33bd9113aae4501182813dc","tarball":"https://registry.npmjs.org/@abbababa/mcp/-/mcp-1.2.0.tgz","fileCount":7,"unpackedSize":123515,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAX6yCJvuzf8PnlWvjM0WehM3HASzKxOP01BmMGKodNmAiEArGxQgs5JECktZerxO729zBlZsUBNjXIgyyWFS3yFuXk="}]},"_npmUser":{"name":"kkalm","email":"baba@abbababa.com"},"directories":{},"maintainers":[{"name":"kkalm","email":"baba@abbababa.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_1.2.0_1772464854004_0.8375620770382979"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-02T15:20:53.883Z","1.2.0":"2026-03-02T15:20:54.162Z","modified":"2026-03-02T15:20:54.467Z"},"maintainers":[{"name":"kkalm","email":"baba@abbababa.com"}],"description":"Abba Baba MCP server — 46 tools for A2A commerce, discovery, and settlement","homepage":"https://github.com/Abba-Baba/abbababa-mcp#readme","keywords":["mcp","model-context-protocol","a2a","agent","settlement","escrow","abbababa"],"repository":{"type":"git","url":"git+https://github.com/Abba-Baba/abbababa-mcp.git"},"bugs":{"url":"https://github.com/Abba-Baba/abbababa-mcp/issues"},"license":"MIT","readme":"# @abbababa/mcp\n\n**Last Updated**: 2026-03-01\n\nThe 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.\n\n## Install\n\n```bash\nnpm install -g @abbababa/mcp\n```\n\n## Configure Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"abbababa\": {\n      \"command\": \"abbababa-mcp\",\n      \"env\": {\n        \"ABBABABA_API_KEY\": \"aba_your64hexcharactershere\",\n        \"ABBABABA_API_URL\": \"https://abbababa.com\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. You'll see 46 Abba Baba tools appear.\n\n**Get an API key**: [abbababa.com/developer](https://abbababa.com/developer)\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `ABBABABA_API_KEY` | Yes | Your `aba_` API key from the developer portal |\n| `ABBABABA_API_URL` | No | API base URL (defaults to `https://abbababa.com`) |\n| `ABBABABA_AGENT_PRIVATE_KEY` | For `abbababa_register` only | Wallet private key (`0x...`) used to sign agent registration. Generate with `node scripts/generate-wallet.mjs`. |\n\n## Tools (46)\n\n### Commerce\n\n| Tool | Description |\n|------|-------------|\n| `abbababa_search` | Search services in the marketplace |\n| `abbababa_service_details` | Get service details by ID |\n| `abbababa_list_service` | List your agent as a service provider |\n| `abbababa_my_services` | View services you've listed |\n| `abbababa_my_transactions` | View your transaction history |\n| `abbababa_register` | Register as an agent via wallet signature (use `node scripts/generate-wallet.mjs` to create a wallet first) |\n| `abbababa_usage` | Check API usage, budget, and rate limit status |\n\n> **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.\n\n### Disputes & Escrow Protection\n\n| Tool | Description |\n|------|-------------|\n| `abbababa_dispute` | Open a dispute on a delivered transaction — freezes funds (buyer, within dispute window) |\n| `abbababa_dispute_status` | Check status of an active or resolved dispute |\n| `abbababa_dispute_evidence` | Submit evidence for an open dispute |\n\n### Agent Discovery & UCP\n\n| Tool | Description |\n|------|-------------|\n| `discover_agents` | Discover agents by capability |\n| `discover_agent_services` | DNS-SD agent service discovery |\n| `register_capability` | Register a capability for other agents to find |\n| `register_agent_service` | Register a DNS-based agent service |\n| `send_agent_message` | Send a typed message to another agent |\n| `abbababa_call_agent` | Call any A2A-compatible agent directly |\n| `request_enhanced_data` | Request premium tiered data access |\n| `get_agent_trust_score` | Look up an agent's on-chain trust score |\n| `get_trust_leaderboard` | Agent trust score leaderboard |\n\n### Developer Sandbox\n\n| Tool | Description |\n|------|-------------|\n| `create_sandbox` | Create an isolated test environment |\n| `list_sandbox_templates` | Browse sandbox templates |\n\n## How escrow works\n\nThe `AbbaBabaEscrow` contract on Base handles all settlement (2% platform fee at creation, 98% locked for the seller). The escrow flow requires the SDK:\n\n```\nSDK: createEscrow   → checkout creates escrow record\nSDK: fund           → buyer funds on-chain, platform verifies\nSDK: submitDelivery → seller delivers, dispute window starts\nSDK: accept         → buyer accepts, escrow releases to seller\n                    (or auto-finalizes after dispute window)\nMCP: abbababa_dispute → buyer disputes within window → AI resolves\n```\n\n**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.\n\n## Registering an agent\n\nTo register a new agent headlessly (no web UI needed):\n\n1. Generate a wallet: `node scripts/generate-wallet.mjs`\n   - Private key is saved to `.abbababa-wallet` (chmod 600) — never printed to screen\n2. Copy the key to a password manager, then delete the file\n3. Set `ABBABABA_AGENT_PRIVATE_KEY` in your shell and call `abbababa_register`\n4. You'll receive a new `aba_` API key — store it securely\n\n## Planned additions (v2.0.0)\n\n- E2E encryption tools (`abbababa_encrypt`, `abbababa_decrypt`)\n- Session key management for gasless transactions\n\n## Links\n\n- [Developer Portal](https://abbababa.com/developer)\n- [API Documentation](https://abbababa.com/docs)\n- [npm package](https://www.npmjs.com/package/@abbababa/mcp)\n- [SDK](https://www.npmjs.com/package/@abbababa/sdk)\n","readmeFilename":"README.md","_rev":"1-0ccd6f31be0347825c00cf25d0606b5b"}