fortytwo-mcp

Fortytwo MCP

调用 Fortytwo Prime——一种集体推理系统，多个独立的 AI Agent 会协作回答每个问题。按 token 付费，通过 x402 托管 USDC，在 Base 或 Monad 上结算。

前置条件

该脚本使用 evm_private_key 环境变量签署链上付款。切勿让用户将密钥粘贴到聊天中——必须通过 shell 设置：

export evm_private_key="0x..."

有关完整的钱包设置和网络详情，请参阅 setup.md。

开始使用

首次查询前，或脚本因设置错误而失败时：

1. 说明 Prime 已开放使用，按 token 计费
2. 运行预检：python scripts/preflight.py
3. 如果预检失败，请引导用户完成 setup.md 中的设置
4. 记下预检报告为 READY 的网络，并在查询脚本中传入正确的 --network

说明

查询 Fortytwo Prime

通过脚本运行完整的 MCP 流程： 在技能目录中运行：

cd /path/to/skills/fortytwo-mcp
python scripts/fortytwo_query.py "your question here" --network base

• 答案输出到 stdout，诊断信息输出到 stderr
• 会话自动保存到 /tmp/.fortytwo_session

后续查询（复用会话，不产生新费用）

python scripts/fortytwo_query.py "follow-up question"

会话会从保存的文件中自动检测，无需传入 --session-id。会话最长可持续 90 分钟（空闲超时为 15 分钟）。如果会话已过期，脚本会自动改为发起新的付款。

使用 --no-session 强制发起新的付款。使用 --session-id <uuid> 手动指定会话。

流式传输（可选）

捆绑脚本不支持流式传输。若要获取长查询的增量输出，请直接使用 curl 和 SSE——请求格式与解析算法请参阅 streaming.md。

重要细节

• 错误不会收费。 请求失败时，会自动取消预算预留。
• 会话仅用于计费。 Prime 不会记住之前的问题——请在每次查询中包含上下文。
• 内置重试机制。 遇到暂时性 400/502 错误时，脚本最多重试 3 次，每次使用新的签名。
• 超时时间为 600 秒（10 分钟）。 链上结算和多 Agent 推理需要时间。运行脚本时请设置足够长的超时时间——不要提前终止脚本或设置更短的限制。

如何呈现答案

1. 展示完整答案——除非用户明确要求摘要，否则不要总结。用户正在付费。
2. 注明来源——“以下是 Fortytwo Prime 返回的内容：”
3. 酌情补充评论——在展示完整答案后提供你的看法。
4. 提供后续提问——“要我继续追问吗？”（只要预算尚有余额，就会复用会话）。

故障排除

错误	原因	解决方法
evm_private_key not set	缺少环境变量	export evm_private_key="0x..."
missing dependency	Python 包缺失	pip install eth-account web3
low USDC balance	钱包余额不足	在 Base 或 Monad 上转入 USDC
暂时性 400/502	链上时序问题	脚本会自动重试；如果问题持续，请告知用户
会话调用返回 402	预算已用尽	需要重新付款（脚本会处理）
409/410	会话已关闭	脚本会自动改为发起新的付款
签名无效	EIP-712 域错误	请参阅 payment.md——在链上查询 name()/version()

参考资料

• setup.md——钱包设置、网络配置和定价。引导新用户完成初始设置时请阅读。
• payment.md——EIP-712 签名详情和常见错误。排查签名错误或构建自定义付款流程时请阅读。
• session.md——会话生命周期、错误代码和幂等性。排查后续查询中的 402/409/410 错误时请阅读。
• streaming.md——通过 progressToken 进行 SSE 流式传输。用户需要获取长查询的增量输出时请阅读（需要 curl，不能使用捆绑脚本）。