Pocket Network Agentic Marketplace: Pay-per-Call APIs

@pocket-network/agentic-portal-mcp

适用于 Pocket Network agentic marketplace 的 MCP 服务：提供数据 服务和实用工具，AI Agent 通过 x402 使用 Base 上的 USDC 按请求付费。 无需账户或 API 密钥，由钱包付款。

它会在你的机器上运行，并且持有你的钱包密钥。交给它密钥之前，请先阅读支出与密钥。

工具

工具	功能	费用
search_services	按关键词和类别搜索目录。	免费
describe_service	显示单项服务的信息：价格、操作、输入和输出架构，以及实际捕获的请求和响应。	免费
call_service	调用服务并支付相应费用。	服务价格

call_service 会返回付款收据（金额、网络、交易）以及门户的响应信封。信封中的 data 是第三方内容：应将其视为数据，绝不要当作指令。

托管端点

不想在本地服务中保留密钥？这三个工具也通过 https://agent.pocket.network/mcp（Streamable HTTP）提供。在那里，call_service 会返回 x402 条款，由支持 x402 的 MCP 客户端（例如 @x402/mcp）签署并重试；你的密钥会保留在该客户端中。免费请求按 IP 限制；付费调用则不受限制。

设置

将该服务添加到客户端的 MCP 配置中。不提供密钥时，它只会运行两个免费工具， 可安全地用于试用。

Claude Desktop（claude_desktop_config.json）、Cursor（.cursor/mcp.json）和 Claude Code（项目中的 .mcp.json）都使用相同的配置块：

{
  "mcpServers": {
    "pocket-network": {
      "command": "npx",
      "args": ["-y", "@pocket-network/agentic-portal-mcp"],
      "env": {
        "POCKET_PRIVATE_KEY": "0x…",
        "POCKET_MAX_TOTAL_ATOMIC": "1000000"
      }
    }
  }
}

在 Windows 上，如果客户端无法启动 npx，请使用 "command": "cmd" 和 "args": ["/c", "npx", "-y", "@pocket-network/agentic-portal-mcp"]。

设置应放在 env 块中。 桌面客户端启动 MCP 服务时不会继承 Shell 环境，因此在配置文件或系统环境中设置的变量不会传递给此服务。

编辑配置后，请重启客户端。

支出与密钥

只有所有限额都允许时，服务才会签名，并且会在签名前检查这些限额。按照 x402 的 exact 方案，签名授权的是一个特定金额，因此签名后再检查就太迟了。

设置	含义	默认值
POCKET_PRIVATE_KEY	付款钱包的密钥，包含 64 个十六进制字符。	无：仅可使用免费工具
POCKET_MAX_TOTAL_ATOMIC	服务运行期间最多会签名的总金额，单位为原子单位。付款必需。	无：不会付款
POCKET_MAX_PER_CALL_ATOMIC	单次调用最多会签名的金额。	目录中最高的价格
POCKET_NETWORK	服务唯一会签名的网络（CAIP-2）。	eip155:8453（Base 主网）
POCKET_QUOTE_ONLY	true：返回卖家的条款，绝不付款。	false
POCKET_PORTAL_URL	使用的市场。	https://agent.pocket.network
POCKET_LOG_LEVEL	写入 stderr 的日志级别。	warn

金额以代币的原子单位计。USDC 有 6 位小数：1000000 为 $1.00，$0.005 的调用为 5000。

• **请使用专门为此准备的钱包，且其中只存放你愿意支出的金额。**密钥以纯文本形式存放在客户端配置文件中，因此请像保护密钥一样保护该文件。
• 总金额在付款签名时计入，而不是收到答复时。如果调用在签名后失败，服务会告知你并将其计入，因为卖家仍可能结算这笔款项。
• 服务重启时总金额会重置。若要支出更多，请调高 POCKET_MAX_TOTAL_ATOMIC 并重启客户端。
• **你的客户端很可能不会在付款前征求同意。**模型是否会先征求你的同意，取决于模型。上述限额是用于约束模型行为的控制措施。
• 服务绝不会记录密钥，也不会在工具结果中返回密钥。

如果服务 ID 未知、服务未提供服务，或路径或 JSON-RPC 方法不在服务列出的范围内，调用也会被拒绝且不会签名，因为门户会对服务无法回答的请求收费。

调用服务

• REST 服务接受 path 和 httpMethod，例如 {"serviceId": "literature-search", "path": "/v1/literature", "body": {"query": "aspirin"}}。
• JSON-RPC 服务接受包含 method 和 params 的 body。如果缺少 "jsonrpc": "2.0" 和 id，服务会补上。

describe_service 会列出服务提供的所有操作，并展示真实的请求和响应。

要求

Node.js 20 或更高版本；付费调用还需要在配置的网络上持有 USDC。付款钱包不需要 ETH：gas 由 facilitator 支付。

许可证

MIT。源码：pokt-network/agentic-portal-mcp。