WritersLogic AI Agents (x402)

@writerslogic/ai-agents-mcp

一个 MCP 服务，可将 WritersLogic x402 agent hub 作为工具提供。Hub 中的每个 Agent 都会变成一个工具。调用以 USDC 计价，并通过 Base 上的 x402 支付，买方无需支付 Gas 费。

该服务是一个轻量级客户端：它会获取 Hub 目录，为每个 Agent 注册一个工具，通过 HTTPS 转发调用，并在 Hub 要求付款授权且未超出您的支出上限时签署该授权。

安装

需要 Node.js 20 或更高版本。无需全局安装；MCP 客户端会使用 npx 运行，并在首次运行时从此仓库构建。

{
  "mcpServers": {
    "writerslogic-ai-agents": {
      "command": "npx",
      "args": ["-y", "@writerslogic/ai-agents-mcp"],
      "env": {
        "AGENT_PRIVATE_KEY": "0x...",
        "MAX_USDC_PER_CALL": "1.00"
      }
    }
  }
}

将该代码块放入客户端的 MCP 配置中：

客户端	配置文件
Claude Desktop	claude_desktop_config.json（Settings，Developer，Edit Config）
Cursor	~/.cursor/mcp.json（或项目中的 .cursor/mcp.json）
Windsurf	~/.codeium/windsurf/mcp_config.json
Cline	cline_mcp_settings.json（MCP Servers，Configure MCP Servers）
Claude Code	claude mcp add writerslogic-ai-agents -e AGENT_PRIVATE_KEY=0x... -- npx -y @writerslogic/ai-agents-mcp

省略 AGENT_PRIVATE_KEY 即可浏览并查看价格：此时，付费工具会返回付款说明，而不会执行付款。

配置

变量	默认值	用途
AGENT_PRIVATE_KEY	未设置	付款钱包的私钥。需要在 Base 上持有 USDC，无需 ETH。请使用余额较低的专用钱包。
MAX_USDC_PER_CALL	1.00	单次调用的支出上限。价格超出上限的调用会在签署任何内容前被拒绝。
AGENTS_API_KEY	未设置	以 X-API-KEY 发送。可绕过付款。
AGENTS_BASE_URL	https://agents.writerslogic.com	Hub URL。必须使用 https；仅 localhost 接受普通 http。
AGENTS_TIMEOUT_MS	120000	工具调用超时时间（1000 至 600000）。目录获取最多使用 15 秒。
AGENTS_PACKAGES	未设置	all，或以逗号分隔的软件包 ID 列表；指定后，会将这些软件包中的检查项分别列为独立工具，而不是每个软件包列为一个工具。

工具

服务器启动时会从中心目录（GET /api/v1/catalog?view=tools）和软件包索引（GET /api/v1/packages）发现工具；十分钟后，tools/list 会刷新工具列表，因此实时列表具有权威性。工具名称由 Agent 或软件包 ID 组成，其中所有不属于 A-Za-z0-9_ 的字符都会替换为 _。每个 Agent 工具都采用该 Agent 自己的输入架构。

价格低廉的单用途检查（每项 $0.005）会按软件包合并为一个工具，例如 money_math_kit，以缩短工具列表。软件包工具接受以下其中一种输入：

• {"describe": true, "check": "<id>"}：免费。通过 GET /api/v1/packages/<id> 返回该检查的输入架构和示例输入。不提供 check 时，则列出软件包中的检查项。
• {"check": "<id>", "input": {...}}：按单项检查的价格运行一项检查。
• {"calls": [{"check": "<id>", "input": {...}}, ...]}：通过 /api/v1/micro-batch，一次支付 $0.02，运行该软件包中最多 20 项检查。有状态检查和网络检查会在付款前被拒绝。

参数会先在本地验证，因此，软件包之外的检查或格式错误的调用都不会到达中心。没有软件包索引的中心会为每个 Agent 提供一个工具。本文撰写时可用的 Agent：

工具	价格（USDC）	描述
abandoned_compound_miner	2.00	废弃 Compound 与未商业化试验挖掘器
accessibility_patcher	0.75	ADA / WCAG 诉讼防护与 DOM 自动修补器
arxiv_to_code	1.00	从 arXiv 到生产代码的超参数编译器
token_trap_detector	0.25	链上字节码与未经验证代币陷阱检测器
chargeback_fighter	2.50	电商拒付申诉材料构建器
clarification_impact	0.50	预测市场澄清影响定价器
competitor_battlecard	1.50	SaaS 定价与竞争对手情报卡探查器
contract_auditor	1.00	智能合约审计器
contract_terminator	1.00	暗黑模式合同与订阅退出律师
cover_claim	5.00	DeFi 保障理赔裁定器
diff_gatekeeper	0.50	PR / 依赖项破坏性变更与漏洞把关器
dispute_ev	0.50	UMA 争议预期价值分析台
foreignResearchScout	1.50	跨语言暗黑科学套利探查器
lead_enrichment	0.50	自动潜在客户信息补全工具
market_predictor	0.10	预测市场分析器
medical_bill_auditor	3.00	医疗账单过度编码与超额收费削减器
milestone_verifier	2.00	带签名发布证明的资助里程碑验证器
patent_design_around	2.00	专利规避设计与自由实施架构师
prior_art_invalidator	2.50	全球专利现有技术无效化工具
replication_auditor	0.75	科学共识与复现失败审计器
arbitrage_lawyer	0.75	跨平台套利与结算规则律师
heal_scraper	0.40	自修复抓取器与 DOM 到 JSON 编译器
tariff_engineer	1.50	全球海关与关税工程优化器
vault_exit_lawyer	0.25	金库退出律师

以下工具也始终可用，且免费：

工具	描述
verify_provenance	向 /api/v1/verify-provenance 发送 POST 请求，以检查付费结果中的 _provenance 记录。

付费结果是中心返回的 JSON 响应，会原样作为文本内容返回。

付款方式

1. 工具会将你的参数 POST 到 Agent 端点。
2. 如果 Hub 返回 402，它会发送一个 base64 PAYMENT-REQUIRED 标头（x402 v2），列出 exact 方案要求：网络 eip155:8453、USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913、原子单位的 amount（6 位小数）、payTo，以及代币的 EIP-712 名称和版本。
3. 如果设置了 AGENT_PRIVATE_KEY，且 amount 不超过 MAX_USDC_PER_CALL，客户端会为恰好该金额签署 EIP-3009 TransferWithAuthorization（EIP-712，链 8453 上的 USDC 域），并将款项支付至 payTo，有效期为要求指定的超时时间，使用随机 nonce。
4. 客户端会使用 base64 PAYMENT-SIGNATURE 标头重试相同请求一次。Hub 的支付中介会提交转账并支付 Gas 费。
5. 返回结果。如果重试未获接受，则返回错误，不会再发送任何内容。

如果未配置密钥，或价格超过上限，工具会返回错误，说明价格、网络、资产和 payTo，且不会生成签名。

来源信息

付费结果会在 data 旁附带一条 _provenance 记录。将整个 {data, _provenance} 对象传递给 verify_provenance，即可向 Hub 验证该记录。请求正文会按原样转发。

安全性

• 密钥留在本地。 AGENT_PRIVATE_KEY 只会从环境变量中读取一次，仅用于签署类型化数据，绝不会记录日志或发送到任何地方。授权内容是签名；客户端不会广播交易。
• 上限针对单次调用，而非整个会话。 在循环中调用工具的 Agent 每次都可能花费 MAX_USDC_PER_CALL。请只向钱包注入你愿意损失的金额，并将上限调低至你实际希望允许的最贵工具价格。
• 只会签署 Base 上的 USDC。 如果请求指定其他网络、资产或转账方式，客户端会拒绝，因此恶意或遭到入侵的 Hub 无法要求使用其他代币。测试时也接受 Base Sepolia（eip155:84532）上的 USDC。
• 目录条目不可信。 端点必须解析到 Hub 自身的源站；ID 和价格都会经过验证；客户端绝不会跟随重定向，因此凭据和签名不会发送到其他主机。
• 限制。 请求大小上限为 1 MiB，响应大小上限为 2 MiB，且每个请求都有超时时间。
• 标准输出是 MCP 数据流。 日志只会写入标准错误；日志会包含付款地址和每笔付款金额，但绝不会包含密钥。
• 任何人在签名授权过期前持有它，都可以提交该授权，但金额不得超过签名金额，且只能支付至 payTo。

开发

npm install
npm run build
npm test

测试会使用本地模拟 Hub，并通过恢复签署者来验证 EIP-3009 签名，还会测试上限值减 1、上限值和上限值加 1 的情况，以及针对 dist/index.js 的端到端标准输入/输出会话。测试不涉及网络访问或资金。

许可证

Apache-2.0。版权所有 2026 WritersLogic。