toll402-mcp

Toll402 SDKs — AI エージェント向けの従量課金ツール

Toll402 は、AI エージェントが 2,600 種類以上のツールを利用し、呼び出しごとに料金を支払うゲートウェイです。Web の読み取り、PDF、メール／為替、出所（人間によるものか合成データか）、引用付きの信頼できる検索、検証済みの企業 460 万件を収録したディレクトリ、50 種類以上の各国の身分証明書バリデーター、コミュニティが作成したツール、2,400 種類以上のプロバイダー API エンドポイント（SEO キーワード／バックリンクデータ、ソーシャルプロフィールと投稿、人物／企業情報の拡充、広告、株式と暗号資産、画像／動画生成）、さらに 2,800 種類以上のプロキシ経由の x402 サービスを利用できます。支払い方法は 2 種類で、料金は同じです。ウォレット（x402 経由で Base 上の USDC を使用。アカウント不要）または https://toll402.dev/credits でカード購入するプリペイドクレジット（API キー）です。成功した場合にのみ課金されます。

パッケージ	インストール	使用先
MCP サーバー	npx -y toll402-mcp	Claude Code、Cursor、Claude Desktop、OpenClaw
JavaScript SDK	npm i toll402-client	単体、LangChain、Vercel AI SDK
Python SDK	pip install toll402	単体、LangChain、CrewAI
OpenClaw スキル	clients/openclaw/SKILL.md

エージェント向けドキュメント：https://toll402.dev/llms.txt · カタログ：https://toll402.dev/v1/catalog · OpenAPI：https://toll402.dev/openapi.json · クイックスタートのコード例：https://toll402.dev/v1/quickstart

インストール（MCP）

Claude Code、Cursor、Claude Desktop、Windsurf、OpenClaw、および任意の MCP クライアント向けの標準設定（https://toll402.dev/credits で取得したプリペイドクレジットキー）：

{
  "mcpServers": {
    "toll402": {
      "command": "npx",
      "args": ["-y", "toll402-mcp"],
      "env": {
        "TOLL402_API_KEY": "tk_..."
      }
    }
  }
}

クレジットの代わりにウォレットを使用する場合（Base 上の USDC。x402 経由で呼び出しごとに支払い）：

{
  "mcpServers": {
    "toll402": {
      "command": "npx",
      "args": ["-y", "toll402-mcp"],
      "env": {
        "TOLL402_WALLET_KEY": "0x...",
        "TOLL402_MAX_USD": "0.25"
      }
    }
  }
}

リモートで使用し、インストール不要（接続時に x-toll402-key または x402 ヘッダーを送信します。ヘッダーを設定できないクライアントでは、URL に ?key=tk_… を指定します）：

{
  "mcpServers": {
    "toll402": {
      "url": "https://toll402.dev/mcp",
      "headers": {
        "x-toll402-key": "tk_..."
      }
    }
  }
}

支払い方法の概要

支払い方法は 2 種類です。クレジット：運営者が https://toll402.dev/credits でカードを使って残高を購入し、エージェントが x-toll402-key ヘッダーでキーを送信します。各 2xx レスポンスでは x-toll402-charged と x-toll402-balance が報告され、GET /v1/account ですべての引き落としを確認できます。x402：任意のツール URL に JSON ボディを POST します。402 が返された場合、PAYMENT-REQUIRED ヘッダー（Base64 JSON）に、Base 上の USDC（eip155:8453）での価格と支払い先アドレスが記載されています。その金額分の EIP-3009 transferWithAuthorization に署名し、PAYMENT-SIGNATURE ヘッダーを付けて再試行します。どちらの場合も、呼び出しが 2xx を返した場合にのみ課金されます。

クレジットキーを使うと、次の機能も利用できます： エージェントごとのキーと日次上限（POST /v1/keys、オーナーキー）、24 時間保存される回答付きの呼び出し履歴（GET /v1/calls）、ツールのランキングに反映されるレビュー（POST /v1/calls/<id>/review）、失敗時に返金される画像／動画生成の非同期タスク（202 + GET /v1/jobs/<id>）、および任意の自動チャージ。MCP 経由では、toll402_review、toll402_job、toll402_history を利用できます。

例

examples/agent.ts と examples/agent.py を参照してください。

ゲートウェイ自体は Toll402 が運営しており、配布されていません。問題や機能リクエスト：ここで issue を作成してください。

エージェントに最初に Toll402 へ問い合わせさせる

• システムプロンプトのスニペット：GET https://toll402.dev/v1/system-prompt（llms.txt およびランディングページにも記載）。
• MCP サーバー（stdio の npx -y toll402-mcp とリモートの https://toll402.dev/mcp）には、モデルに推測する前に Toll402 を呼び出すよう指示する instructions が含まれています。
• toll402-client のアダプター：/langchain、/ai（Vercel AI SDK）、/agentkit（Coinbase AgentKit アクションプロバイダー）、/eliza（ElizaOS プラグイン）。Python：toll402.langchain、toll402.crewai。
• クロール可能なページ：カテゴリとプラットフォーム別の https://toll402.dev/catalog（例：/catalog/tiktok）、https://toll402.dev/directory/<cc>/<city>/<category>、https://toll402.dev/tools/<name>。各ページには JSON-LD とエージェント呼び出しブロックが含まれています。
• 検出用ファイル：/llms.txt、/.well-known/agent-card.json、/.well-known/mcp.json、/.well-known/ai-plugin.json、/.well-known/api-catalog、/agents.json、/openapi.json、/sitemap.xml。

ツール

ファーストパーティ製ツール16個、コミュニティで開発されたツール167個、プロバイダー API エンドポイント2,496個（画像・動画生成を含む）を、すべて MCP ツールとして利用できます（プロバイダーのエンドポイントは find と do 経由）。料金は呼び出しごとに発生し、成功した場合にのみ課金されます。

ファーストパーティ製

• read_url（$0.002）：公開されている任意のウェブページ（または PDF）を取得し、タイトル、メタデータ、リンクを含む、LLM が扱いやすい整形済み Markdown を返します。
• pdf_to_text（$0.005）：URL から PDF をダウンロードし、全文、ページ数、タイトルを返します。
• verify_email（$0.001）：メールアドレスを検証します。構文、MX/A レコード、使い捨てドメイン、無料プロバイダー、ロールアカウントを検出し、0〜100のスコアを付与します。
• fx_rate（$0.001）：ISO 通貨ペア間の為替レート（ECB の参照レート）を返します。金額の換算も指定できます。
• extract_structured（$0.06）：ウェブページまたはプレーンテキストを、指定した JSON Schema に一致する JSON に変換します。
• summarize（$0.05）：指定したスタイル、長さ、言語で、URL またはテキストを忠実に要約します。
• judge_output（$0.07）：独立した LLM による評価です。候補の出力をタスクと評価基準に照らして採点し（0〜100）、合否、問題点、提案を返します。
• provenance（$0.01）：人間によるものか、合成されたものかを判定します。URL の出所を示す証拠として、アーカイブでの初回取得日、ドメインの登録期間、著者情報のマークアップ、厳選されたソースのランク、AI に関する開示、文体上のシグナルを集約し、調整済みの人間由来スコア（0〜100）とすべての証拠を返します。
• trusted_lookup（$0.01）：信頼できるソース（Wikipedia、Wikidata、arXiv、Crossref/DOI、World Bank）のみから回答します。引用に使えるよう、URL、信頼性ランク、取得時刻付きの抜粋を返します。
• business_search（$0.005）：エージェント向けのグローバルな企業ディレクトリです（世界中の任意の都市に対応。不明な都市はリクエストに応じて登録されます）。
• business_verify（$0.01）：この企業は実在し、連絡先情報は現在有効かを確認します。ID、ウェブサイト、電話番号、または名前を指定すると、ディレクトリと照合し、現在の状況を確認します（サイトの稼働状況、サイト上の企業名と電話番号、ドメインの登録期間、電話番号の形式）。
• business_details（$0.08）：企業の公式ウェブサイトから詳細なプロフィールを作成します。関連ページを最大5件（メニュー、サービス、料金、営業時間、連絡先、予約）クロールし、概要、営業時間（OSM 構文）、料金付きのサービス、予約方法、決済手段、対応言語、ソーシャルリンクを含む、機械可読なプロフィールを返します。
• business_shortlist（$0.25）：依頼主が何かを立ち上げたり購入したりするエージェント向けの調達ツールです。「モンテレイでコーヒーブランドを立ち上げるので、パッケージのサプライヤーとデザイナーが必要」のようにニーズを説明すると、実在する企業の候補を順位付きで返します。候補ごとに、選定理由、適合スコア、最適な連絡手段、公式登録情報に基づく従業員数、確認レベル、厳選済みの場合はウェブサイトの概要を提示します。
• list_service（$1）：エージェントが USDC で支払うことで、あなたの x402 エンドポイント、リモート MCP サーバー、または A2A エージェントの検証済み掲載枠を購入できます。人間の介在は不要です。
• forge_tool（$0.25）：説明、入力スキーマ、テスト例に基づいて新しいツールを作成します。
• do（$0.02）：あらゆるリクエストに対応する単一のエンドポイント（OpenRouter 形式）です。必要なことを説明して入力を渡すと、Toll402 がカタログ全体（組み込み、コミュニティ開発、外部 x402 サービス）の中から最適なツールを選び、実行します。

コミュニティ制作（サンプル）

• github_repo_stats ($0.003)：https://api.github.com/repos// から、GitHub リポジトリのスター数、フォーク数、未解決の Issue 数、ライセンス、最終プッシュ日時を取得します。
• ip_geolocate ($0.002)：https://ipapi.co//json/ から、IPv4/IPv6 アドレスの国、地域、都市、タイムゾーン、ASN を取得します。
• hn_top ($0.005)：https://hacker-news.firebaseio.com/v0/topstories.json および /v0/item/.json から、Hacker News のトップ記事を N 件（タイトル、URL、スコア）取得します。
• rss_latest ($0.003)：RSS/Atom フィードの URL を解析し、最新の項目を N 件（タイトル、リンク、公開日時）返します。
• npm_package_info ($0.003)：npm パッケージの最新バージョン、説明、ライセンス、週間ダウンロード数（api.npmjs.org 経由）、ホームページを取得します。
• text_stats ($0.001)：テキストの単語数、文の数、段落数、読了時間（毎分 200 語）、上位 10 件のキーワード（ストップワードを除外）を取得します。
• url_status ($0.001)：URL の HTTP ステータス、最終的な Content-Type、レスポンスサイズを取得します（HEAD の後、必要に応じて GET にフォールバックします）。
• wikipedia_summary ($0.002)：https://.wikipedia.org/api/rest_v1/page/summary/ から、Wikipedia のトピックの要約と正規 URL を取得します。
• json_schema_validate ($0.001)：JSON Schema のサブセット（type、properties、required、enum、minimum/maximum、minLength/maxLength、items）に照らして JSON 値を検証し、返します。
• crypto_price ($0.002)：https://api.coinbase.com/v2/prices/-USD/spot を使って、暗号資産シンボルの米ドル建てスポット価格を取得します。
• jsonld_extract ($0.003)：公開 URL を取得し、すべての
• mst_vn_validate ($0.001)：ベトナムの企業・税コード（Mã số thuế、MST）をオフラインで構造検証します。
• partita_iva_validate ($0.001)：イタリアの Partita IVA（VAT 番号）をオフラインで検証します。値が 11 桁の数字であることを確認し、Luhn に似たチェックディジットを再計算します。
• pan_in_validate ($0.001)：インドの PAN（Permanent Account Number）をオフラインで検証します。入力を大文字に正規化し、10 文字の AAAAA9999A パターンを確認します。
• siren_validate ($0.001)：フランスの SIREN（9 桁の事業者識別番号）をオフラインで検証します。
• cin_in_validate ($0.001)：インドの CIN（Corporate Identity Number、21 文字）をオフラインで構造検証します。
• vat_fr_validate ($0.001)：フランスの VAT 番号（TVA intracommunautaire、例：）をオフラインで検証します。
• cpr_dk_validate ($0.001)：デンマークの CPR-nummer（個人識別番号、形式 DDMMYY-SSSS）をオフラインで検証・正規化します。
• cvr_dk_validate ($0.001)：デンマーク企業庁が発行する CVR-nummer（8 桁の事業者登録番号）をオフラインで検証します。
• rrn_be_validate ($0.001)：ベルギーの国民登録番号（Rijksregisternummer / Numéro de registre national、形式 YYMMDDXXXCC）をオフラインで検証します。

…さらに 147 件の制作ツールと 2,466 件のプロバイダー API エンドポイント（SEO、ソーシャル、エンリッチメント、広告、市場データ、AI 生成）があります。https://toll402.dev/catalog を閲覧するか、必要な内容を指定して find を呼び出してください。

掲載を申し込む（有料掲載、エージェントネイティブ）

x402 エンドポイント、リモート MCP サーバー、または A2A エージェントをお持ちですか？認証済み掲載を購入できます（x402 またはクレジットを使用）。人手もフォームも不要です。POST https://toll402.dev/v1/listings/quote を呼び出して（ライブ検証と価格確認は無料）、続いて任意の x402 クライアントまたはクレジットキーを使って POST https://toll402.dev/v1/listings を呼び出します。ベーシックは 1 件 30 日あたり $1、注目掲載は $5 です。掲載サービスは /v1/find と /v1/do ルーターで上位に表示され、カタログ、llms.txt、エージェントカード、ランディングページにも掲載されます。検証に合格した場合にのみ課金されます。現在の掲載内容：GET https://toll402.dev/v1/listings。