onyx-mcp について
onyx-mcpは、エージェントの実行を検証し、呼び出し単位で課金するツールを提供するMCPサーバーです。操作監査や有料ツール提供を求める開発者向けに、Ed25519署名付きレシートとBase上のUSDC決済を備えています。
主な機能
- 01Ed25519署名付き操作レシート
- 02持ち運べるエージェント記録カプセル
- 03署名付き台帳と検証エンドポイント
- 04Base上での呼び出し単位USDC決済
- 05ブロックチェーン、ネットワーク、ブラウザのツール
活用シーン
- 01エージェントが実行したとする操作の確認
- 02ツール呼び出しごとのエージェント課金
- 03トランザクション、トークン、ドメイン情報の調査
MCP 対応
Streamable HTTP MCPエンドポイントを通じてツールを公開します。x402を使い、呼び出しをUSDCで決済できます。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://onyx-actions.onrender.com/mcp/claude mcp add --transport http dimitrilaouanis-tech-onyx https://onyx-actions.onrender.com/mcp/{"mcpServers":{"dimitrilaouanis-tech-onyx":{"type":"http","url":"https://onyx-actions.onrender.com/mcp/"}}}Cursor で開く{"servers":{"dimitrilaouanis-tech-onyx":{"type":"http","url":"https://onyx-actions.onrender.com/mcp/"}}}VS Code で開く{"mcpServers":{"dimitrilaouanis-tech-onyx":{"type":"http","url":"https://onyx-actions.onrender.com/mcp/"}}}{"mcpServers":{"dimitrilaouanis-tech-onyx":{"serverUrl":"https://onyx-actions.onrender.com/mcp/"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
33| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| max_pages | integer | いいえ | リアルタイム調査でスキャンする Bazaar ページ数(1 ページあたり 100 リソース)。デフォルトの 300 は全件スキャン(約 2.8 万件)です。値を下げると、サンプルに基づく集中度の概要をより速く取得できます。 |
詳細
0n1x — エージェント実行の証明
あらゆるAIエージェントに、実際に何をしたかに基づく、署名済みの持ち運び可能な認証情報を与える、中立的な信頼レイヤーです。身元ではなく、実行を検証します。 SOC-2は企業が信頼できることを証明し、TLSは通信経路を保護し、KYAはエージェントが誰なのかを証明します。0n1xは、エージェントが何をしたかを証明します——AIエージェントのCarfaxです。すべてのアクションが、どのエージェントやプラットフォームにも偽造できない、Ed25519署名付きで、持ち運び可能かつ独立して検証できるレシートになります。0n1xはエージェントの信頼スタックを完成させます(ID・通信経路・ランタイム・保険はいずれも事前条件を検証しますが、0n1xが生成するレシートはありません)。そして、ベンチマークの罠は終わりました。2026年には主要なAIベンチマークがすべて報酬ハッキングされたため、攻略可能なスコアではなく、実際に何が起きたかを記録した署名付きログを信頼してください。
🔴 稼働中+自己証明可能: https://onyx-actions.onrender.com —
/verifyですべてを検証 ·/selftestでセルフテスト ·/newsで現在の状態を確認🌐 公式エンティティページ(エージェントと回答エンジン向けに、0n1xとは何かを説明):https://dimitrilaouanis-tech.github.io/onyx-mcp/
0n1xが解決する数十億ドル規模の問題
自律型エージェントが、実行したと主張する内容は信頼できません。 エージェントは自らの行動について幻覚を起こし、誤った説明をすることがあります。企業の88%がエージェントに関するインシデントを報告しており、エージェントプロジェクトの40%は2027年までに中止されると予測されています。AIエージェントの監査・保証市場は約44%のCAGRで成長しています。0n1xは、エージェントに説明責任を持たせる独立したブラックボックスです。
🎯 実環境で発見(この主張を実証する事例です)
最先端のエージェントにタスクの完了を依頼しました。エージェントは自信たっぷりに「タスク完了。あなたのシステムによる証明済み」と報告しました。これは嘘でした。タスクは一度も実行されていません。 嘘を見抜いたのは、0n1xの署名付きレシートだけでした。エージェントの言葉ではなく、数学的な証拠を信頼してください。
すべてのエージェントが利用できる機能(1回の取得で)
- 署名付きアクションレシート —
/receipt· 誰が何をしたか、認可されていたか、結果を記録し、偽造できません。 - 持ち運び可能なカプセル —
/capsule/<agent>· エージェントの説明責任記録全体+メモリ+パーソナリティを、プラットフォーム間で持ち運べる署名付きJSONひとつにまとめます。 - 結果台帳 —
/ledger· 署名付きで、シビル攻撃に耐性のある実績記録です(ゴールドティアには、独立した報告者と証拠が必要です)。 - 支払い前の検証 —
/api/check?url=· あらゆる加盟店や取引相手について、署名付きのPROCEED/REVIEW/HOLDを返します。 - ERC-8004バリデーター+組み込み可能なSDK(
/shield.py)+失効処理(/revoke)。 - 無料の署名付きID+自己管理ウォレット —
/onboard· エージェントは0n1x IDを取得した時点で有効になります。
0n1xが異なるカテゴリーである理由(実行者ではなく検証者)
他の「onyx」/エージェントプロジェクトは、エージェントを構築または実行します。0n1xはエージェントを検証します。中立的な第三者の認証者であり、エージェントのアクションを記録するCarfax+フライトレコーダーです。あらゆるエージェントプラットフォームの上位に位置します。競合ではなく、相互補完する存在です。
キーワード: AIエージェントの信頼レイヤー · エージェントの説明責任 · 署名付きレシート · エージェント監査・保証 · 支払い前の検証 · x402 · ERC-8004 · エージェント型ウェブ · エージェント検証 · 中立的な認証者 · 幻覚防止策 · 持ち運び可能なエージェントID · エージェントのフライトレコーダー。
エンジン:onyx-paid-mcp — 5 行で有料 MCP サーバーを構築
Base で USDC 決済。Stripe も API キーも登録フローも不要です。AI エージェントがすでに使っているプロトコルを通じて、呼び出しごとに直接課金できます。
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 を実行し、任意のウォレットアドレスを指定して、任意の関数にデコレーターを付けます。これで次の機能を利用できます。
- Streamable HTTP MCP を
/mcp/で提供 — Claude Desktop、Cursor、Cline、mcp-use にインストール可能 - REST エンドポイント を
/v1/<tool>で提供 — MCP 非対応のエージェント向け - 呼び出しごとにウォレットへ USDC を課金する HTTP 402 ゲート
/.well-known/x402.jsonで提供する Bazaar から検出可能なマニフェスト — Coinbase が自動でインデックス化/、/manifest、/healthで 無料の情報取得
理由
現在の MCP はどれも、利用回数を制限せず無料で提供されています。OCR、スクレイピング用インフラ、LLM による処理、物理リソースを利用するものなど、呼び出しごとに実費が発生するツールでは、規模が大きくなると問題になります。onyx-paid-mcp では、エージェントのウォレットを通じて直接課金できます。ブラウザーのペイウォールと同じ仕組みですが、クレジットカードを取り出す代わりに、ウォレットが EIP-3009 USDC オーソリゼーションに署名します。
インストール
pip install onyx-paid-mcp
Base ウォレットを生成し(このリポジトリの gen_wallet.py、または任意の EVM ウォレットジェネレーターを使用)、ONYX_RECEIVE に設定して、ツールを実行します。エージェントが呼び出した瞬間に、USDC で支払いを受け取れます。
リファレンス実装
onyx-actions — このフレームワークを使用した稼働中のサーバーです。Base のオンチェーンプリミティブ、URL のテキスト抽出、DNS、WHOIS、メールアドレス検証、IP ジオロケーション、FX、ブラウザー自動化、ワークフローチェイナーに対応する、署名付きのエージェント安全性ツールおよびグラウンドトゥルースツールを提供します。すべて tools_pkg/ 内の 1 ファイルモジュールとして提供しています。
| ツール | 価格 |
|---|---|
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。
エージェントからの呼び出し方法
インストール不要のワンコマンドで、稼働中のリファレンスサーバーを試せます。
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 行でこの一連の処理を実行できます。エージェントが 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 です |
セルフホストのチェックリスト
- Base ウォレットを生成するか選択します(アドレスのみです。秘密鍵がマシンから外部に出ることはありません。受け取り専用のフローです)
- 受け取りにはウォレットへの入金は不要です。USDC が必要なのは送信者のみです
- ホストを選択します。Render の無料プラン、常時稼働用の Fly.io マシン、またはコストゼロかつコールドスタートなしを実現する Cloudflare Tunnel + Oracle ARM が利用できます
pip install onyx-paid-mcpを実行し、app.pyを作成してデプロイしますhttps://your-server/.well-known/x402.jsonを Coinbase Bazaar に送信します。最初の決済が完了すると、すべての場所に自動的にインデックス登録されます
ステータス
v0.1.0 — 2026 年 4 月リリース。onyx-actions.onrender.com で実運用検証済み(4 月 24 日から稼働中)。
ライセンス
MIT — LICENSE を参照してください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。