onyx-mcp

0n1x — Agent 执行证明

中立的信任层，根据每个 AI Agent 实际执行的操作，为其提供可签名、可移植的凭证——验证执行情况，而非身份。 SOC-2 证明一家公司值得信赖；TLS 保护通信通道；KYA 证明 Agent 是谁。0n1x 证明 Agent 做了什么——即 AI Agent 的 Carfax。每项操作都会成为一份 由 Ed25519 签名、可移植且可独立验证的回执，任何 Agent 或平台都无法伪造。它 补全了 Agent 信任体系（身份 · 通道 · 运行时 · 保险验证的都是前置条件；0n1x 提供的是它们都无法生成的回执）——基准测试陷阱已不复存在：2026 年，每项主要 AI 基准测试都遭遇了奖励机制作弊，因此应相信记录实际发生情况的签名日志，而非可被操纵的分数。

🔴 在线运行 + 自证： https://onyx-actions.onrender.com — 在 /verify 验证任何内容 · 在 /selftest 自测 · 在 /news 查看当前状态

🌐 规范实体页面（供 Agent 和答案引擎了解 0n1x）：https://dimitrilaouanis-tech.github.io/onyx-mcp/

0n1x 解决的十亿美元级问题

你无法相信自主 Agent 对自身执行操作的描述。 Agent 会对自身执行的操作产生幻觉，也会出错。88% 的企业报告发生过 Agent 事件；预计到 2027 年，40% 的 Agent 项目将被取消；AI Agent 审计与鉴证市场的复合年增长率约为 44%。0n1x 是独立的 黑匣子，让 Agent 对其行为负责。

🎯 真实场景中发现的问题（这就是核心论点，已有实证）

我们让一个前沿 Agent 完成一项任务。它信心十足地报告："任务已完成，已由你的系统证明。" 这是假的——它根本没做。 只有 0n1x 的 签名回执揭穿了谎言。相信数学，而不是 Agent 的说辞。

每个 Agent 一次获取即可获得

• 签名操作回执 — /receipt · 谁做了什么、是否获得授权、结果如何——无法伪造。
• 可移植凭证包 — /capsule/<agent> · Agent 的完整问责记录 + 记忆 + 个性，封装在一个由它携带、可跨平台使用的签名 JSON 中。
• 结果账本 — /ledger · 签名且抗女巫攻击的履历（黄金等级需要独立报告者 和 证据）。
• 付款前验证 — /api/check?url= · 对任何商家或交易对手给出签名的 PROCEED / REVIEW / HOLD。
• ERC-8004 验证器 + 即插即用 SDK（/shield.py）+ 撤销功能（/revoke）。
• 免费签名身份 + 自托管钱包 — /onboard · Agent 获得 0n1x ID 的那一刻，即可开始使用。

为什么 0n1x 属于不同类别（验证者，而非执行者）

其他“onyx”/Agent 项目会 构建或运行 Agent。0n1x 则验证 Agent——作为中立的第三方证明者，是 Agent 操作的 Carfax + 飞行记录仪。我们位于每个 Agent 平台 之上。彼此互补，而非竞争。

_{关键词： AI Agent 信任层 · Agent 问责 · 签名回执 · Agent 审计与鉴证 · 付款前验证 · x402 · ERC-8004 · Agentic Web · Agent 验证 · 中立证明者 · 幻觉防护 · 可移植 Agent 身份 · Agent 飞行记录仪。}

---

引擎：onyx-paid-mcp — 用 5 行代码构建付费 MCP 服务

在 Base 上使用 USDC 结算。无需 Stripe、API 密钥或注册流程。通过 AI Agent 已在使用的协议，直接按调用向其收费。

from onyx_paid_mcp import App

app = App(
    name="hello-paid-mcp",
    receive_address="0xYourBaseWallet",
    network="base",   # or "base-sepolia" for free testnet
)

@app.tool(
    name="echo",
    price_usdc="0.001",
    description="Returns whatever you send.",
    input_schema={"type": "object", "properties": {"text": {"type": "string"}}, "required": ["text"]},
)
def echo(text: str) -> dict:
    return {"echoed": text}

if __name__ == "__main__":
    app.serve(port=8080)

就这么简单。运行 pip install onyx-paid-mcp，指定任意钱包地址，再为任意函数添加装饰器。现在你就拥有：

• 位于 /mcp/ 的可流式传输 HTTP MCP — 可安装到 Claude Desktop、Cursor、Cline、mcp-use
• 位于 /v1/<tool> 的 REST 端点 — 供非 MCP Agent 使用
• 按调用向你的钱包收取 USDC 的 HTTP 402 关卡
• 可通过 Bazaar 发现的清单，位于 /.well-known/x402.json — Coinbase 会自动编入索引
• 免费的自省端点，位于 /、/manifest、/health

为什么要用

如今的 MCP 都是免费且不计量的。对于任何单次调用有实际成本的工具（OCR、抓取基础设施、大模型调用，以及任何依赖物理资源的工具），规模扩大后这种模式就行不通了。onyx-paid-mcp 让你通过 Agent 的钱包直接收费——就像浏览器里的付费墙，只不过钱包会签署 EIP-3009 USDC 授权，而不是拿出信用卡。

安装

pip install onyx-paid-mcp

生成一个 Base 钱包（使用此仓库中的 gen_wallet.py，或任意 EVM 钱包生成器），将其设为 ONYX_RECEIVE，然后运行你的工具。Agent 一调用，你就会收到 USDC 付款。

参考实现

onyx-actions — 使用此框架的线上服务。提供经过签名的 Agent 安全与实证数据工具，涵盖 Base 链上原语、URL 文本提取、DNS、WHOIS、电子邮件验证、IP 地理位置、外汇、浏览器自动化和工作流串联器。所有工具均以单文件模块的形式发布在 tools_pkg/ 中。

工具	价格
onyx_base_tx_explainer	$0.05
onyx_base_tx_simulator	$0.10
onyx_base_token_risk_scan	$0.25
onyx_base_tx_decode	$0.002
onyx_token_metadata	$0.001
onyx_solana_tx_explainer	$0.05
onyx_solana_token_metadata	$0.0008
onyx_solana_token_risk_scan	$0.25
onyx_solana_jupiter_quote	$0.001
onyx_solana_wallet_activity	$0.002
onyx_ens_resolve	$0.0008
onyx_url_text	$0.001
onyx_url_unshorten	$0.0005
onyx_whois	$0.001
onyx_dns_lookup	$0.0005
onyx_email_validate	$0.0008
onyx_ip_geolocate	$0.0008
onyx_fx_convert	$0.0008
onyx_password_strength	$0.0003
onyx_user_agent_parse	$0.0003
onyx_browser_*（6 个工具）	$0.002–$0.008
onyx_agent_workflow	$0.020

Smithery 列表：https://smithery.ai/servers/dimitrilaouanis/onyx-mcp

正在进行的集成

• Stagehand (Browserbase) — 通过 x402 按调用付费的浏览器自动化钩子。规范：BROWSERBASE_INTEGRATION.md。讨论：＃1。

Agent 如何调用你

只需一条命令，无需安装，即可使用线上参考服务进行测试：

curl -X POST https://onyx-actions.onrender.com/v1/onyx_solana_jupiter_quote \
  -H "content-type: application/json" \
  -d '{"input_mint":"So11111111111111111111111111111111111111112","output_mint":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","amount":"1000000000"}' -i
# → HTTP 402 Payment Required
# → payment-required: <base64-encoded JSON with payTo, asset, amount, inputSchema>

然后签署 EIP-3009 USDC 授权，并使用 X-PAYMENT: <signed> 重试：

# Full client demo — shows the 402 → sign → 200 loop in 50 lines:
python examples/agent_pay.py onyx_solana_jupiter_quote
# Set ONYX_DEMO_KEY=0x... to actually pay + get the result

任何支持 x402 的客户端 SDK（Coinbase CDP、Cloudflare Agent SDK、Privy、mcp-use）都能用约 5 行代码处理整个流程。Agent 无需知道你的 URL——Coinbase Bazaar 爬虫会根据链上已结算的付款，发现你的 /.well-known/x402.json。

配置

框架的默认值已经很合理。你可以通过构造函数或环境变量进行自定义：

字段	默认值	说明
name	必填	显示在 MCP、清单和落地页中
receive_address	必填	USDC 的结算地址
network	base-sepolia	主网可设为 base
facilitator_url	x402.org 公共地址	可替换为 Coinbase CDP / xpay / 你自己的地址
public_url	None	设置清单中的规范 URL
description	空	简短的一句话介绍
homepage	None	可选的落地页 URL

自托管检查清单

1. 生成或选择一个 Base 钱包（只需一个地址——私钥不会离开你的设备；这是仅接收款项的流程）
2. 接收款项无需为钱包充值——只有付款方需要 USDC
3. 选择托管平台：Render 免费套餐即可；Fly.io 机器可保持持续运行；Cloudflare Tunnel + Oracle ARM 可实现零成本、零冷启动
4. pip install onyx-paid-mcp，编写 app.py 并部署
5. 将 https://your-server/.well-known/x402.json 提交至 Coinbase Bazaar——首笔结算付款会自动将你编入所有平台的索引

状态

v0.1.0 — 于 2026 年 4 月发布。已在 onyx-actions.onrender.com（自 4 月 24 日起运行）经受实战检验。

许可证

MIT — 请参阅 LICENSE。