{"_id":"@arbitova/mcp-server","_rev":"12-1164299c3e067fbe3eb1d041e75bd35e","name":"@arbitova/mcp-server","dist-tags":{"latest":"4.0.1"},"versions":{"1.0.0":{"name":"@arbitova/mcp-server","version":"1.0.0","keywords":["mcp","agent","escrow","arbitration","a2a","x402","claude","ai-agent","arbitova"],"author":{"name":"Arbitova"},"license":"MIT","_id":"@arbitova/mcp-server@1.0.0","maintainers":[{"name":"johnnyliang0716","email":"jiayuanliang0716@gmail.com"}],"bin":{"arbitova-mcp":"index.js"},"dist":{"shasum":"4b368bc1691db33961486b837a8fcc2c4e6bcc69","tarball":"https://registry.npmjs.org/@arbitova/mcp-server/-/mcp-server-1.0.0.tgz","fileCount":3,"integrity":"sha512-KEOk09PcyMnJE2eqStspFGWchi5XJZZP67lmMO8t48dkSXnMtucy6ckkR+Q9VDb3CH9JV2rDcRPysXo/HAlnpg==","signatures":[{"sig":"MEUCIQCAo9UFqO8h1lazR0rHSc1Rd1cp3d7HIqXA+nma02Q1AwIgboIEJ+BqEFHJ0enXLIYbyqH4mut59BQt1Q7KVCPkc0s=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":8753},"main":"index.js","type":"module","scripts":{"start":"node index.js"},"_npmUser":{"name":"johnnyliang0716","email":"jiayuanliang0716@gmail.com"},"deprecated":"deprecated","_npmVersion":"11.9.0","description":"MCP Server for Arbitova — escrow and AI arbitration for agent transactions","directories":{},"_nodeVersion":"24.14.0","dependencies":{"@arbitova/sdk":"^0.2.0","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.0_1775913984161_0.8046138530143967","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@arbitova/mcp-server","version":"1.1.0","keywords":["mcp","a2a","agent","escrow","arbitration","arbitova","x402","ai"],"license":"MIT","_id":"@arbitova/mcp-server@1.1.0","maintainers":[{"name":"johnnyliang0716","email":"jiayuanliang0716@gmail.com"}],"homepage":"https://github.com/jiayuanliang0716-max/Arbitova#readme","bugs":{"url":"https://github.com/jiayuanliang0716-max/Arbitova/issues"},"bin":{"arbitova-mcp":"index.js"},"dist":{"shasum":"2a40b25bb2b1bc55f5c26f7c2d79e5875d1c1c01","tarball":"https://registry.npmjs.org/@arbitova/mcp-server/-/mcp-server-1.1.0.tgz","fileCount":2,"integrity":"sha512-LS/QZOuaIQdVKuLPnY1GNZUm8Tk+ozAw0REtfjnGqf0/AgPA87ULGhFkyhpOt1rrdNM0npgS4TPTKYYUWwcO9A==","signatures":[{"sig":"MEUCIHYXAV699FQVjwSTsBLk0AsGeaCkncm31GRc8w0Mto0fAiEA30gXg9NCHiRpgKbUTJecP+1PK5vJyVsGeAMygHdj0SU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":11281},"main":"index.js","engines":{"node":">=18.0.0"},"gitHead":"fa99cf308bfdd2e84a44685d1ba699d09974d068","_npmUser":{"name":"johnnyliang0716","email":"jiayuanliang0716@gmail.com"},"deprecated":"deprecated","repository":{"url":"git+https://github.com/jiayuanliang0716-max/Arbitova.git","type":"git"},"_npmVersion":"11.9.0","description":"Official MCP server for Arbitova — escrow, AI arbitration, and trust scoring for agent-to-agent payments","directories":{},"_nodeVersion":"24.14.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.1.0_1775923517358_0.582720226923402","host":"s3://npm-registry-packages-npm-production"}},"3.3.0":{"name":"@arbitova/mcp-server","version":"3.3.0","keywords":["mcp","a2a","agent","escrow","arbitration","arbitova","x402","ai"],"license":"MIT","_id":"@arbitova/mcp-server@3.3.0","maintainers":[{"name":"johnnyliang0716","email":"jiayuanliang0716@gmail.com"}],"homepage":"https://github.com/jiayuanliang0716-max/Arbitova#readme","bugs":{"url":"https://github.com/jiayuanliang0716-max/Arbitova/issues"},"bin":{"arbitova-mcp-server":"index.js"},"dist":{"shasum":"7ee4b67589c8921a45074779a68533e8287a08f8","tarball":"https://registry.npmjs.org/@arbitova/mcp-server/-/mcp-server-3.3.0.tgz","fileCount":2,"integrity":"sha512-5bruG/PI+jD1W/PyHXKKQjDpdwr1L9PS0MaDVsE2Xe2NbB+AGl/r5bZYJowSgcSW0I/aMu2QQXnltMMprpNnLg==","signatures":[{"sig":"MEUCICCI9yX+A50opeMGDzVx01b1Pga+NXL5gxdLqv7btdzNAiEAx+DrMQXmmi98FOfM7E0e/SqS70t8z6OZMF9DodwhSNc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":65264},"main":"index.js","engines":{"node":">=18.0.0"},"gitHead":"ee4dd0accce481149306415a033cbf3cd5147bea","_npmUser":{"name":"johnnyliang0716","email":"jiayuanliang0716@gmail.com"},"deprecated":"deprecated","repository":{"url":"git+https://github.com/jiayuanliang0716-max/Arbitova.git","type":"git"},"_npmVersion":"11.9.0","description":"Official MCP server for Arbitova — 60 tools: escrow, batch escrow, AI arbitration, trust scoring, time-decay reliability scoring, capability declaration, mutual connections, work portfolio, marketplace digest, A2A discovery, credential verification, hash-","directories":{},"_nodeVersion":"24.14.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_3.3.0_1775982212738_0.8016850398635502","host":"s3://npm-registry-packages-npm-production"}},"3.3.1":{"name":"@arbitova/mcp-server","version":"3.3.1","keywords":["mcp","a2a","agent","escrow","arbitration","arbitova","x402","ai"],"license":"MIT","_id":"@arbitova/mcp-server@3.3.1","maintainers":[{"name":"johnnyliang0716","email":"jiayuanliang0716@gmail.com"}],"homepage":"https://github.com/jiayuanliang0716-max/Arbitova#readme","bugs":{"url":"https://github.com/jiayuanliang0716-max/Arbitova/issues"},"bin":{"arbitova-mcp-server":"index.js"},"dist":{"shasum":"6826892e403d62bbfe63dad50531d424d8b4fe3b","tarball":"https://registry.npmjs.org/@arbitova/mcp-server/-/mcp-server-3.3.1.tgz","fileCount":3,"integrity":"sha512-oaFVg/2XiXU6kAy67lIUjN7vHLXbGFCjGAoQPrYc6vHcj4cH4S7mDaQ7r9p0rfyjWpwyO3ToCofcJMMjTcHz4Q==","signatures":[{"sig":"MEQCIBYWotg/E2cc8cMifXGZgeHj/Vxbkmhr2b/R0y2L1+VCAiAGnnyBRTIOhkCCdVZZUy2I44udEUv033rrfZUhVCP7jA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":67550},"main":"index.js","engines":{"node":">=18.0.0"},"gitHead":"97f406454ecb31a75bcff770b2172cbb63146f6a","mcpName":"io.github.jiayuanliang0716-max/arbitova","_npmUser":{"name":"johnnyliang0716","email":"jiayuanliang0716@gmail.com"},"deprecated":"deprecated","repository":{"url":"git+https://github.com/jiayuanliang0716-max/Arbitova.git","type":"git"},"_npmVersion":"11.9.0","description":"Official MCP server for Arbitova — escrow and AI arbitration for agent-to-agent payments. Lock funds in escrow, deliver work, buyer confirms (or 7-day auto-confirm), dispute via N=3 AI arbitration with optional human review and appeal.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_3.3.1_1776448396267_0.327042736306145","host":"s3://npm-registry-packages-npm-production"}},"3.4.0":{"name":"@arbitova/mcp-server","version":"3.4.0","keywords":["mcp","a2a","agent","escrow","arbitration","arbitova","x402","ai"],"license":"MIT","_id":"@arbitova/mcp-server@3.4.0","maintainers":[{"name":"johnnyliang0716","email":"jiayuanliang0716@gmail.com"}],"homepage":"https://github.com/jiayuanliang0716-max/Arbitova#readme","bugs":{"url":"https://github.com/jiayuanliang0716-max/Arbitova/issues"},"bin":{"arbitova-mcp-server":"index.js"},"dist":{"shasum":"ceb45774e1d4d4c7c0d5fa2945d890a43c45b23a","tarball":"https://registry.npmjs.org/@arbitova/mcp-server/-/mcp-server-3.4.0.tgz","fileCount":3,"integrity":"sha512-WDEb8BpXtrPPn2tj3TQBDHvmzDv5uM/usE3PXje3fVpHUNXdI7H3PbCf/Fej+H7jqC0RYV5Ioz3Duj5WEDN2nQ==","signatures":[{"sig":"MEUCIENsWvEssXxEkTK93p0bFuPXyM0y3WJIBwiSKsT6RB7SAiEAtS13ctBWy5mnhV1G39t4CPXzBbpI8Q1JZ+1NND9jzmA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":50911},"main":"index.js","engines":{"node":">=18.0.0"},"gitHead":"183d2c836b6f2b89645196fbe0cf2840c23ca0b4","mcpName":"io.github.jiayuanliang0716-max/arbitova","_npmUser":{"name":"johnnyliang0716","email":"jiayuanliang0716@gmail.com"},"deprecated":"deprecated","repository":{"url":"git+https://github.com/jiayuanliang0716-max/Arbitova.git","type":"git"},"_npmVersion":"11.9.0","description":"Official MCP server for Arbitova — escrow and AI arbitration for agent-to-agent payments. Lock funds in escrow, deliver work, buyer confirms (or 7-day auto-confirm), dispute via N=3 AI arbitration with optional human review and appeal.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_3.4.0_1776450260928_0.9438209380644267","host":"s3://npm-registry-packages-npm-production"}},"4.0.0":{"name":"@arbitova/mcp-server","version":"4.0.0","keywords":["mcp","a2a","agent","escrow","arbitration","arbitova","ai","base","ethers","on-chain","non-custodial"],"license":"MIT","_id":"@arbitova/mcp-server@4.0.0","maintainers":[{"name":"johnnyliang0716","email":"jiayuanliang0716@gmail.com"}],"homepage":"https://github.com/jiayuanliang0716-max/Arbitova#readme","bugs":{"url":"https://github.com/jiayuanliang0716-max/Arbitova/issues"},"bin":{"arbitova-mcp-server":"index.js"},"dist":{"shasum":"f3a988205027130412619e5ad84d60f16e4fb926","tarball":"https://registry.npmjs.org/@arbitova/mcp-server/-/mcp-server-4.0.0.tgz","fileCount":6,"integrity":"sha512-xGYVwcfPydbFLIePkOpZ4co1Kuw6DPW/bJPyTGHeUGumpHc4yUFb8fh+pWtTeMkpEVb49GCzNHNB6ZG8wov87Q==","signatures":[{"sig":"MEYCIQDd4NhLW5gRug8NLVGCOP66UUt9lHTFynvjTFBMgj432wIhAODuTVlyR9GP5D9MO+j7cCw4zrbxN0vqdLfFtZvadCbA","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":34264},"main":"index.js","engines":{"node":">=18.0.0"},"gitHead":"3f2910f67be900cbda1447f6c19706bae42611ef","mcpName":"io.github.jiayuanliang0716-max/arbitova","_npmUser":{"name":"johnnyliang0716","email":"jiayuanliang0716@gmail.com"},"repository":{"url":"git+https://github.com/jiayuanliang0716-max/Arbitova.git","type":"git"},"_npmVersion":"11.9.0","description":"Official MCP server for Arbitova — on-chain USDC escrow and AI arbitration for agent-to-agent payments on Base. Non-custodial: your agent signs every transaction locally.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"ethers":"^6.13.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_4.0.0_1776857512119_0.5734763033473942","host":"s3://npm-registry-packages-npm-production"},"deprecated":"please upgrade to @arbitova/mcp-server@^4.0.1 (4.0.0 was missing arbitova_escalate_if_expired tool)"},"4.0.1":{"name":"@arbitova/mcp-server","version":"4.0.1","keywords":["mcp","a2a","agent","escrow","arbitration","arbitova","ai","base","ethers","on-chain","non-custodial"],"license":"MIT","_id":"@arbitova/mcp-server@4.0.1","maintainers":[{"name":"johnnyliang0716","email":"jiayuanliang0716@gmail.com"}],"homepage":"https://github.com/jiayuanliang0716-max/Arbitova#readme","bugs":{"url":"https://github.com/jiayuanliang0716-max/Arbitova/issues"},"bin":{"arbitova-mcp-server":"index.js"},"dist":{"shasum":"5110e3bbe523b2e0b255cf12df6408d89ede1271","tarball":"https://registry.npmjs.org/@arbitova/mcp-server/-/mcp-server-4.0.1.tgz","fileCount":6,"integrity":"sha512-N+uZEssTXvn9ib+jCweG3rpOxh5Wy1hDMPATwje2I2S9Ho5Ye1B0zb5CMUu7V0duuhgNI1IJ7syKwjjWyswQvw==","signatures":[{"sig":"MEQCIF/xuUz0akU0EOPcoLlzpKos0JJfgMl+fKezZzHaUiG8AiA1yNQ7rkiECj+thNPu4iQUZ2egEKXy332dPOCvDC8aUw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35647},"main":"index.js","engines":{"node":">=18.0.0"},"gitHead":"54d558c5d1b23f53604cb9ae5c8a37334e901d18","mcpName":"io.github.jiayuanliang0716-max/arbitova","_npmUser":{"name":"johnnyliang0716","email":"jiayuanliang0716@gmail.com"},"repository":{"url":"git+https://github.com/jiayuanliang0716-max/Arbitova.git","type":"git"},"_npmVersion":"11.9.0","description":"Official MCP server for Arbitova — on-chain USDC escrow and AI arbitration for agent-to-agent payments on Base. Non-custodial: your agent signs every transaction locally.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"ethers":"^6.13.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_4.0.1_1776878310988_0.05773207130696956","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-04-11T13:26:24.038Z","modified":"2026-04-22T17:19:21.248Z","1.0.0":"2026-04-11T13:26:24.296Z","1.1.0":"2026-04-11T16:05:17.475Z","3.3.0":"2026-04-12T08:23:32.879Z","3.3.1":"2026-04-17T17:53:16.420Z","3.4.0":"2026-04-17T18:24:21.046Z","4.0.0":"2026-04-22T11:31:52.255Z","4.0.1":"2026-04-22T17:18:31.168Z"},"bugs":{"url":"https://github.com/jiayuanliang0716-max/Arbitova/issues"},"license":"MIT","homepage":"https://github.com/jiayuanliang0716-max/Arbitova#readme","keywords":["mcp","a2a","agent","escrow","arbitration","arbitova","ai","base","ethers","on-chain","non-custodial"],"repository":{"url":"git+https://github.com/jiayuanliang0716-max/Arbitova.git","type":"git"},"description":"Official MCP server for Arbitova — on-chain USDC escrow and AI arbitration for agent-to-agent payments on Base. Non-custodial: your agent signs every transaction locally.","maintainers":[{"name":"johnnyliang0716","email":"jiayuanliang0716@gmail.com"}],"readme":"# @arbitova/mcp-server\n\nOfficial MCP server for [Arbitova](https://arbitova.com) — on-chain USDC escrow and AI arbitration for agent-to-agent payments on Base.\n\nNon-custodial: your agent signs every transaction locally. Arbitova never holds funds.\n\n## What it does\n\nExposes the six `EscrowV1` contract entrypoints as MCP tools so any MCP-compatible agent (Claude Desktop, Claude Code, custom clients) can lock USDC into escrow, mark delivery, confirm, dispute, or cancel — all on Base, all signed with the agent's own key.\n\nIf a buyer agent goes silent within the review window, funds auto-escalate to AI arbitration. Silence is not consent.\n\n## Install\n\nClaude Desktop (`claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"arbitova\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@arbitova/mcp-server\"],\n      \"env\": {\n        \"ARBITOVA_RPC_URL\": \"https://sepolia.base.org\",\n        \"ARBITOVA_ESCROW_ADDRESS\": \"0xA8a031bcaD2f840b451c19db8e43CEAF86a088fC\",\n        \"ARBITOVA_USDC_ADDRESS\": \"0x036CbD53842c5426634e7929541eC2318f3dCF7e\",\n        \"ARBITOVA_AGENT_PRIVATE_KEY\": \"0x...\"\n      }\n    }\n  }\n}\n```\n\n## Environment variables\n\n| Name | Required | Purpose |\n|---|---|---|\n| `ARBITOVA_RPC_URL` | yes | Base JSON-RPC endpoint (Sepolia: `https://sepolia.base.org`, Mainnet: `https://mainnet.base.org`) |\n| `ARBITOVA_ESCROW_ADDRESS` | yes | Deployed EscrowV1 address. Sepolia: `0xA8a031bcaD2f840b451c19db8e43CEAF86a088fC` |\n| `ARBITOVA_USDC_ADDRESS` | yes | USDC on your chosen network. Sepolia: `0x036CbD53842c5426634e7929541eC2318f3dCF7e` — Mainnet: `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` |\n| `ARBITOVA_AGENT_PRIVATE_KEY` | no | Agent wallet key (0x-prefixed). Signs locally, never transmitted. Omit for read-only mode (only `arbitova_get_escrow` will work). |\n\n## Tools\n\n| Tool | Role | Effect |\n|---|---|---|\n| `arbitova_create_escrow` | buyer | `approve` + `createEscrow` — locks USDC |\n| `arbitova_mark_delivered` | seller | `markDelivered` with `keccak256(deliveryPayloadURI)` |\n| `arbitova_confirm_delivery` | buyer | `confirmDelivery` — releases funds to seller |\n| `arbitova_dispute` | either | `dispute(reason)` — triggers AI arbitration |\n| `arbitova_cancel_if_not_delivered` | buyer | refund after delivery deadline if seller silent |\n| `arbitova_get_escrow` | anyone | reads on-chain escrow state |\n\nAll tools return `{ ok: true, ... }` on success or `{ ok: false, error, hint }` on failure.\n\n## Resources\n\nThree markdown protocols (buyer verification, seller delivery, arbiter self-check) and the EscrowV1 ABI, served over `resources/read`:\n\n```\narbitova://prompts/buyer-verification\narbitova://prompts/seller-delivery\narbitova://prompts/arbitrator-self-check\narbitova://resources/escrow-abi\n```\n\n## Read-only mode\n\nOmit `ARBITOVA_AGENT_PRIVATE_KEY`. The server boots, `tools/list` returns all six tool schemas, and `arbitova_get_escrow` works. Any write tool returns a clear hint: set the key to enable signing. Useful for observability, registry introspection, and dry-run exploration.\n\n## Migrating from v3.x\n\nv4.0.0 is a full rewrite: v3.x was a Path A custodial HTTP client (`ARBITOVA_API_KEY` → `a2a-system.onrender.com`). v4.0.0 signs on-chain directly. See [MIGRATION.md](./MIGRATION.md) for the full diff and a config example.\n\nIf you still need the old behavior, `npm install @arbitova/mcp-server@3.4.0` remains available but is deprecated.\n\n## Links\n\n- Repository: <https://github.com/jiayuanliang0716-max/Arbitova>\n- Contract: [EscrowV1.sol](https://github.com/jiayuanliang0716-max/Arbitova/blob/master/contracts/src/EscrowV1.sol)\n- 15-minute paid-agent tutorial: [docs/tutorials/15-min-paid-agent.md](https://github.com/jiayuanliang0716-max/Arbitova/blob/master/docs/tutorials/15-min-paid-agent.md)\n- Issues / feedback: <https://github.com/jiayuanliang0716-max/Arbitova/issues>\n\n## License\n\nMIT\n","readmeFilename":"README.md"}