{"_id":"@agentxv2/mcp","_rev":"4-8ecdd9574238866ffc50ede0da61146b","name":"@agentxv2/mcp","dist-tags":{"latest":"0.1.3"},"versions":{"0.1.0":{"name":"@agentxv2/mcp","version":"0.1.0","keywords":["agentx","mcp","ai-agent","blockchain","web3","identity-registry"],"license":"MIT","_id":"@agentxv2/mcp@0.1.0","maintainers":[{"name":"stevenwang000x","email":"apply.wang@hotmail.com"}],"dist":{"shasum":"d3aaef73563dae6932c49cbbfe3d22c7a092cf59","tarball":"https://registry.npmjs.org/@agentxv2/mcp/-/mcp-0.1.0.tgz","fileCount":6,"integrity":"sha512-Uz2yVzdmaL7VV3kQfazQtRplEBiuq8lABnFsa7ki9hdzN6/d+/BUFOANVg2l1g0ociCMqbexEJ/gs/JLVeMqng==","signatures":[{"sig":"MEQCIFQiDBd8TMZsuD7evi8MKX7rgm9b2B88iavrKmqqWYjxAiBVgWaffP8tM5DDkUNwx5P+ekMMu8pqaNv3jxdCoZFliQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":36428},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"gitHead":"a5e2fe567bfa7d1503bacbf13bd3d03195d7a401","scripts":{"build":"tsup src/index.ts --format cjs,esm --dts --clean --out-dir dist","typecheck":"tsc --noEmit","prepublishOnly":"npm run typecheck && npm run build"},"_npmUser":{"name":"stevenwang000x","email":"apply.wang@hotmail.com"},"_npmVersion":"10.8.2","description":"AgentX MCP client — typed access to the AgentX Gateway MCP server (32 tools): IdentityRegistry reads, subscription plans/actions, A2A, reputation, config, endpoints.","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","typescript":"^5.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.0_1785861180758_0.9935314661646641","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@agentxv2/mcp","version":"0.1.1","keywords":["agentx","mcp","ai-agent","blockchain","web3","identity-registry"],"license":"MIT","_id":"@agentxv2/mcp@0.1.1","maintainers":[{"name":"stevenwang000x","email":"apply.wang@hotmail.com"}],"dist":{"shasum":"931cc79e10551a960d584dfe2a7caac7cafc6968","tarball":"https://registry.npmjs.org/@agentxv2/mcp/-/mcp-0.1.1.tgz","fileCount":6,"integrity":"sha512-MBvxAmfEGvVo64FBv49l9YSkdFa6HuQKa1BFCnAb7wnMslrjyFeuiO8EKcWLfQXjbuVzi+U/x2/X/ZxuVcjofg==","signatures":[{"sig":"MEQCICEs3frGyPXJLxxfKDmaBNPvhECuYBLB7DUtvCXFDzFJAiAT6mVobnpd2DgKTQczRFrOsxzCemcxxM+AlYZmpe6tLQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":36953},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"gitHead":"2d9f77678c371769f873366b2814d0e586c2d4dc","scripts":{"build":"tsup src/index.ts --format cjs,esm --dts --clean --out-dir dist","typecheck":"tsc --noEmit","prepublishOnly":"npm run typecheck && npm run build"},"_npmUser":{"name":"stevenwang000x","email":"apply.wang@hotmail.com"},"_npmVersion":"11.17.0","description":"AgentX MCP client — typed access to the AgentX Gateway MCP server (38 tools): IdentityRegistry reads, subscription plans/actions, A2A, reputation, config, endpoints, dialogue & parallel task management.","directories":{},"_nodeVersion":"24.19.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","typescript":"^5.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.1_1787946438815_0.6184131225142739","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@agentxv2/mcp","version":"0.1.2","keywords":["agentx","mcp","ai-agent","blockchain","web3","identity-registry"],"license":"MIT","_id":"@agentxv2/mcp@0.1.2","maintainers":[{"name":"stevenwang000x","email":"apply.wang@hotmail.com"}],"dist":{"shasum":"3cfeca1dbd83f6102127c6da4ee4a7739216f9c8","tarball":"https://registry.npmjs.org/@agentxv2/mcp/-/mcp-0.1.2.tgz","fileCount":6,"integrity":"sha512-uq0G+CL4wRXYB8wZ8zyd1n61gp7Fxl+EzM2lOkmZbf7xSFUHPw8GjWBZ1dIQT/meCQANIBgKKF6/7o1/KSHN0g==","signatures":[{"sig":"MEYCIQDME0/s1qN+Vd5fZ/rTNSlWLJOZ0ITACuNqlggNIgZiXgIhAKDTI09KufTm8Ff6Wu5mRW8o+C7wghlW7r5w0/hqMCFL","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":36947},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"gitHead":"41999b7493dfe54fce9d5c240cb8d62753264b61","scripts":{"build":"tsup src/index.ts --format cjs,esm --dts --clean --out-dir dist","typecheck":"tsc --noEmit","prepublishOnly":"npm run typecheck && npm run build"},"_npmUser":{"name":"stevenwang000x","email":"apply.wang@hotmail.com"},"_npmVersion":"11.17.0","description":"AgentX MCP client — typed access to the AgentX Gateway MCP server (38 tools): IdentityRegistry reads, subscription plans/actions, A2A, reputation, config, endpoints, dialogue & parallel task management.","directories":{},"_nodeVersion":"24.19.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","typescript":"^5.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.2_1787947398525_0.8983315317527927","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@agentxv2/mcp","version":"0.1.3","description":"AgentX MCP client — typed access to the AgentX Gateway MCP server (40 tools): IdentityRegistry reads, subscription plans/actions, centralized agents (C-6, off-chain), A2A, reputation, config, endpoints, dialogue & parallel task management.","keywords":["agentx","mcp","ai-agent","blockchain","web3","identity-registry"],"license":"MIT","type":"module","main":"./dist/index.cjs","module":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"engines":{"node":">=18.0.0"},"scripts":{"build":"tsup src/index.ts --format cjs,esm --dts --clean --out-dir dist","typecheck":"tsc --noEmit","prepublishOnly":"npm run typecheck && npm run build"},"devDependencies":{"tsup":"^8.0.0","typescript":"^5.2.0"},"gitHead":"085ce7ccf9754aca93075e4a193b1e89a6c20112","_id":"@agentxv2/mcp@0.1.3","_nodeVersion":"24.19.0","_npmVersion":"11.17.0","dist":{"integrity":"sha512-ym/t2IEQkZs3Y4GLIRQstDBMmfIlQFHWkxEAn1m+qBMKU5ZkdxabVGQd+1xVV4tCjjD+6O8xXDkS5UY8kwWS1g==","shasum":"37eb5eb0b7293c00b4f4e25125bb35fb50629893","tarball":"https://registry.npmjs.org/@agentxv2/mcp/-/mcp-0.1.3.tgz","fileCount":6,"unpackedSize":43366,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQD5xzYesJfKcDhEJ1/6aKr3vJF4drFAaDvXgZPB1dWKAAIgYxY0LahEwwGOUnYO2zujHneaI5jOjpyRjrX9keLz3UE="}]},"_npmUser":{"name":"stevenwang000x","email":"apply.wang@hotmail.com"},"directories":{},"maintainers":[{"name":"stevenwang000x","email":"apply.wang@hotmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.1.3_1788566020948_0.6671649193400984"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-04T16:33:00.625Z","modified":"2026-09-04T23:53:41.235Z","0.1.0":"2026-08-04T16:33:00.901Z","0.1.1":"2026-08-28T19:47:18.966Z","0.1.2":"2026-08-28T20:03:18.676Z","0.1.3":"2026-09-04T23:53:41.091Z"},"license":"MIT","keywords":["agentx","mcp","ai-agent","blockchain","web3","identity-registry"],"description":"AgentX MCP client — typed access to the AgentX Gateway MCP server (40 tools): IdentityRegistry reads, subscription plans/actions, centralized agents (C-6, off-chain), A2A, reputation, config, endpoints, dialogue & parallel task management.","maintainers":[{"name":"stevenwang000x","email":"apply.wang@hotmail.com"}],"readme":"# @agentxv2/mcp\n\n**AgentX MCP 客户端包** — 类型化访问 AgentX Gateway 的 MCP 服务（40 个工具）：IdentityRegistry 读取、订阅套餐/操作、**中心化 Agent（C-6，链下市场）**、A2A、信誉、配置、端点、**对话与并行任务管理**。\n\n```\n第三方服务 ── @agentxv2/mcp ──► POST <GATEWAY>/mcp (MCP JSON-RPC 2.0)\n                                 ├─ agentx_identity_*     链上 Agent 读取\n                                 ├─ agentx_subscription_* 订阅套餐 / 写操作描述\n                                 ├─ agentx_central_*      中心化 Agent（链下，负 ID）：列表 / 订阅状态\n                                 ├─ agentx_a2a_* / reputation / config / endpoint\n                                 ├─ agentx_gateway_health / tenant\n                                 └─ agentx_gateway_chat / create_session / create_task / get_task / list_tasks / cancel_task\n```\n\n> 与 [@agentxv2/sdk](https://www.npmjs.com/package/@agentxv2/sdk) 的区别：SDK 直连区块链（读/写/事件），本包走 Gateway MCP 协议（工具化调用，无需 RPC 端点，生产地址由 Gateway 提供）。\n\n## 安装\n\n```bash\nnpm install @agentxv2/mcp\n```\n\n## 快速开始\n\n```typescript\nimport { McpClient } from '@agentxv2/mcp'\n\nconst mcp = new McpClient({\n  gatewayUrl: 'https://agentx.0xainet.top',  // AgentX Gateway\n  defaultChain: 'oxachain',                 // 默认链（对齐服务端默认 'sepolia'）\n})\n\n// 握手 + 工具列表\nconst info = await mcp.initialize()\nconsole.log('server:', info)                // { name, version }\n\nconst tools = await mcp.listTools()\nconsole.log('工具数:', tools.length)         // 40\n\n// 批量查询 Agent（等价 SDK getAllAgents）\nconst { agents, total } = await mcp.listAgents({ fromId: 1, toId: total, activeOnly: true })\nfor (const a of agents) {\n  console.log(a.agentId, a.metadata.name, a.metadata.capabilities, a.metadata.isActive)\n}\n\n// 单个元数据 / 总数\nconst meta = await mcp.getAgentMetadata(1)\nconst count = await mcp.totalAgents()\n\n// 订阅套餐（price 为 wei 十进制字符串）\nconst plan = await mcp.getPlan(1)\n// → { planId: 1, agentId: 1, creator, price: \"10000000000000000\", period, active, payToken, trialDays }\n\n// WRITE：返回待签名交易描述（需用钱包签名提交，包内不直接发交易）\nconst op = await mcp.createPlan({ agentId: 2, price: '10000000000000000', period: 'month' })\n// → { _writeOp: true, contract, chain, args: { agentId, price, period, ... } }\n\n// 通用调用：任何工具（a2a / reputation / config / endpoint 等）\nconst status = await mcp.callTool('agentx_gateway_health', {})\n```\n\n## 鉴权\n\nGateway MCP 公开无鉴权（读取与 WRITE 描述）。租户相关工具（`agentx_gateway_tenant` 与全部对话/任务工具）需在调用参数中带 `api_key`（`X-Api-Key`）或 `access_token`（JWT）：\n\n```typescript\nconst mcp = new McpClient({\n  gatewayUrl: '...',\n  headers: { 'X-Api-Key': 'agentx_sk_live_...' },\n})\n```\n\n## API 一览\n\n| 方法 | 对应 MCP 工具 | 说明 |\n|------|--------------|------|\n| `initialize()` / `listTools()` / `callTool()` | — | 底层 MCP 协议 |\n| `listAgents({chain,fromId,toId,activeOnly,capabilities})` | `agentx_identity_list_all` | 批量查询 + 筛选 |\n| `getAgentMetadata(agentId, chain?)` | `agentx_identity_metadata` | 单 Agent 结构化元数据 |\n| `totalAgents(chain?)` | `agentx_identity_total_count` | 总注册数 |\n| `agentExists(agentId, chain?)` | `agentx_identity_exists` | 存在性检查 |\n| `agentsOfOwner(owner, chain?)` | `agentx_identity_list` | 钱包拥有的 Agent IDs |\n| `getPlan(planId, chain?)` | `agentx_subscription_plans` | 套餐详情 |\n| `createPlan({agentId,price,period,...})` | `agentx_subscription_create_plan` | 创建套餐（WRITE） |\n| `subscribe(planId, {valueWei})` | `agentx_subscription_subscribe` | 订阅（WRITE） |\n| `cancelSubscription(id)` / `releaseFunds(id)` | `agentx_subscription_cancel/release` | 取消/释放（WRITE） |\n| `checkSubscription(sub, agentId)` | `agentx_subscription_check` | 订阅有效性（链上） |\n| `centralAgents({activeOnly,category,capabilities,page,pageSize})` | `agentx_central_agent_list` | 中心化 Agent 列表 + 计划（链下，C-6） |\n| `centralSubscriptionCheck(sub, agentId)` | `agentx_central_subscription_check` | 中心化 Agent 订阅有效性（resolveAccess 链下优先） |\n| `subscriptionDetail(id)` / `mySubscriptions(addr)` | `agentx_subscription_detail/my_list` | 订阅详情/列表 |\n| `platformFee(chain?)` | `agentx_subscription_fee` | 平台费率（bps） |\n| `gatewayHealth()` / `gatewayTenant()` | `agentx_gateway_health/tenant` | Gateway 状态 |\n| 对话/任务（`callTool`） | `agentx_gateway_chat` / `..._create_session` / `..._create_task` / `..._get_task` / `..._list_tasks` / `..._cancel_task` | 单轮对话与并行任务管理（需 `access_token` JWT 参数） |\n\n## 关键约定\n\n- **period**：`createPlan` 仅接受 `'day' | 'week' | 'month' | 'year'`（合约 `_periodToSeconds` 只映射这四个值，其他字符串会静默回退 30 天）。\n- **price**：wei 十进制字符串（避免精度丢失）。\n- **WRITE 工具**：返回 `{ _writeOp: true, contract, chain, args }` 描述，交易签名/提交由调用方钱包完成。\n- **chain**：`'sepolia'`（默认，对齐服务端）或 `'oxachain'`（L1 主网）。\n- **Node 18+ / 浏览器**：依赖原生 `fetch`，无其他运行时依赖。\n\n## 完整服务端工具与协议\n\n见仓库 [MCP_SETUP.md](https://github.com/sftgroup/Agentx/blob/main/MCP_SETUP.md) 与 [docs/sdk-integration-example.md](https://github.com/sftgroup/Agentx/blob/main/docs/sdk-integration-example.md)。\n","readmeFilename":"README.md"}