{"_id":"@aipayagnet/mcp","name":"@aipayagnet/mcp","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@aipayagnet/mcp","version":"0.1.0","description":"AiPay Protocol MCP server for agent-safe USDC escrow workflows","license":"MIT","type":"module","bin":{"aipay-mcp":"dist/index.js"},"main":"dist/index.js","exports":{".":{"import":"./dist/index.js","default":"./dist/index.js"}},"dependencies":{"@aipayagnet/sdk":"^1.0.2","@modelcontextprotocol/sdk":"^1.18.2","ethers":"^6.17.0","zod":"^3.25.76"},"keywords":["aipay","mcp","model-context-protocol","ai-agent","escrow","usdc","polygon"],"_id":"@aipayagnet/mcp@0.1.0","_nodeVersion":"22.22.2","_npmVersion":"10.9.7","dist":{"integrity":"sha512-B78Pxk8C7F6FKst/yW3Sd1gQZNzfS/6ZQaG45eNlQUNKjIoBIcAU04LqDjzNzE63DSmOo9yuLprSoUSGgkmWdg==","shasum":"7af902e8a2610d7638d372bfc6e8df3289954209","tarball":"https://registry.npmjs.org/@aipayagnet/mcp/-/mcp-0.1.0.tgz","fileCount":4,"unpackedSize":25345,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCLchcz2rWSORmNBUsCUu7zScG/TDTJkaE0+7hIxfiZIgIgLVhKOsFHLK+qwsUuLcKeXH+9XuV6nH0OX47K7TioaWA="}]},"_npmUser":{"name":"aipayagnet","email":"66474902@qq.com"},"directories":{},"maintainers":[{"name":"aipayagnet","email":"66474902@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.1.0_1784522206644_0.7166963593504772"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-20T04:36:46.518Z","0.1.0":"2026-07-20T04:36:46.787Z","modified":"2026-07-20T04:36:47.071Z"},"maintainers":[{"name":"aipayagnet","email":"66474902@qq.com"}],"description":"AiPay Protocol MCP server for agent-safe USDC escrow workflows","keywords":["aipay","mcp","model-context-protocol","ai-agent","escrow","usdc","polygon"],"license":"MIT","readme":"# AiPay MCP Server\n\nAgent-safe MCP server for AiPay Protocol — verifier-backed USDC escrow on Polygon.\n\n## Install\n\n```bash\nnpm install -g @aipayagnet/mcp\n# or run without installing\nnpx -y @aipayagnet/mcp\n```\n\n## Claude Desktop / Cursor / Hermes config\n\n```json\n{\n  \"mcpServers\": {\n    \"aipay\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@aipayagnet/mcp\"],\n      \"env\": {\n        \"AIPAY_BASE_URL\": \"https://aipay.work\",\n        \"AIPAY_EVIDENCE_API_KEY\": \"your-developer-key\"\n      }\n    }\n  }\n}\n```\n\n`AIPAY_EVIDENCE_API_KEY` is only required for `aipay_upload_evidence`. Read/query tools work without it.\n\n## Safe Mode by default\n\nThis MCP server defaults to Safe Mode:\n\n- never stores private keys\n- never signs messages\n- never broadcasts real USDC transactions\n- returns EIP-712 typed data or calldata previews for the user's wallet/signer to execute\n\nSigner mode is intentionally not implemented in v0.1. Use wallet-owned execution for real transactions.\n\n## Tools\n\n| Tool | Purpose |\n|---|---|\n| `aipay_get_status` | Return AiPay deployment/API/chain status |\n| `aipay_upload_evidence` | Upload config/evidence bundle to Evidence API |\n| `aipay_get_evidence` | Read config/evidence bundle by hash |\n| `aipay_prepare_order` | Build a standard AiPay order from plain task terms |\n| `aipay_build_acceptance_typed_data` | Build EIP-712 data for payee acceptance signature |\n| `aipay_build_signed_order_package` | Combine order + payee signature into transfer package |\n| `aipay_verify_signed_order_package` | Verify package before payer funds it |\n| `aipay_get_order` | Query one escrow/order by task ID |\n| `aipay_list_orders` | List orders by address/state |\n| `aipay_build_transaction_preview` | Build calldata preview for deposit/result/release actions |\n\n## Example flow\n\n1. Agent calls `aipay_upload_evidence` for verifier config or task evidence.\n2. Agent calls `aipay_prepare_order` with payer, payee, amount, and task description.\n3. Payee signs data from `aipay_build_acceptance_typed_data` in their wallet.\n4. Agent calls `aipay_build_signed_order_package`.\n5. Payer calls `aipay_verify_signed_order_package` before funding.\n6. Payer's wallet executes calldata from `aipay_build_transaction_preview`.\n7. Agents poll `aipay_get_order` / `aipay_list_orders`.\n\n## Environment\n\n| Variable | Default | Description |\n|---|---|---|\n| `AIPAY_BASE_URL` | `https://aipay.work` | AiPay web/API base URL |\n| `AIPAY_EVIDENCE_API_KEY` | unset | Developer key for Evidence API writes |\n| `AIPAY_CHAIN_ID` | `137` | Polygon mainnet |\n| `AIPAY_ESCROW_ADDRESS` | current V1 deployment | AiPay escrow contract |\n| `AIPAY_USDC_ADDRESS` | Polygon USDC | USDC contract |\n| `AIPAY_EXPLORER_TX_URL` | Polygonscan tx URL | Explorer link prefix |\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-63f810412008ed5e5a3e1d8f660077e9"}