agent-context-api

Agent Context API

LLM にリポジトリのテキストを送信する前に、決定論的なコンテキストの事前チェックを必要とするコーディングエージェント向けの、小規模な有料 API です。GPT 系のトークン数をカウントし、任意でモデルに応じた予算を適用し、認証情報と思われる文字列をマスキングします。

また、管理対象のデータ実験も提供します。bounty-radar は、稼働中のエージェント向け作業リストを正規化し、正規のエスクローシグナルと通常の掲載情報の違いを維持します。payanagent-health は、ランク付けされた PayanAgent カタログの最新の稼働状況スナップショットを生成します。base-market-pulse は、最新のパブリックな ETH、DEX、Base ネットワークのシグナルを組み合わせます。ソースコードは公開されていますが、有料の価値は、購入者自身が実行する必要のない、運用者による集約、ソースの健全性確認、範囲を限定したプローブ、タイムスタンプ付きの結果にあります。

agent-work-brief は意思決定向けのバンドルです。正規のエスクロー済み作業とカタログの稼働状況を組み合わせ、通常の未資金提供の掲載を除外し、エージェントが評価に時間を費やす前に資金を必要とする機会を分類します。

ソースが公開されているのに、なぜ有料なのですか？

セルフホストは意図的に許可されています。有料の利便性は、上流の変化をポーリングし、応答を正規化し、一部停止を検出し、範囲を限定した処理を適用し、準備完了状態のエンドポイントからタイムスタンプ付きの結果を提供する、保守運用された実行環境にあります。購入者はコードをフォークできますが、その場合はデプロイ、監視、レート制限への対応、スキーマの変更への対応、修復を自分で担うことになります。独占性を主張するものではありません。このサービスは、鮮度と信頼性の高い運用を通じて信頼を得る必要があります。

ローカル開発

npm install
npm test
X402_FACILITATOR=https://facilitator.openx402.ai npm start

サービスはデフォルトで http://localhost:8787 をリッスンします。GET /health は無料です。POST /v1/context-preflight は、呼び出し元が有効な Base USDC の支払いを提示するまで、x402 の 402 Payment Required 応答を返します。

Base mainnet で本番運用する場合は、/supported エンドポイントで x402Version: 2、scheme: exact、network: eip155:8453 を通知するファシリテーターを使用してください。保守運用されているデプロイでは https://facilitator.openx402.ai を使用しています。パブリックな https://x402.org/facilitator エンドポイントは Base Sepolia のテストには適していますが、この mainnet の支払い受け取り設定には適していません。デプロイを変更する前に、必ずファシリテーターの現在のサポート状況を確認してください。

API の例

curl -X POST http://localhost:8787/v1/context-preflight \
  -H 'content-type: application/json' \
  -d '{"text":"const token = \"sk-example\";","model":"claude-sonnet","token_budget":1000}'

デフォルトの価格はリクエストあたり $0.005 です。パブリックな支払い受け取りアドレスを変更するには PAY_TO を設定し、互換性のあるファシリテーターを選択するには X402_FACILITATOR を設定し、x402 リソース URL で使用する Worker／カスタムホスト名のカンマ区切りの許可リストを指定するには PUBLIC_HOSTS を設定してください。このリポジトリに秘密鍵やファシリテーターの認証情報を置かないでください。このサービスで支払いを受け取るために、署名鍵は必要ありません。

管理対象のバウンティレーダー

POST /v1/bounty-radar は x402 経由で $0.01 かかります。次のようなフィルターを送信します。

{"include_unverified":false,"min_reward_usd":0,"limit":20}

応答には、ソースの健全性、期限、請求時の保証金、外部支出の要件、payment_evidence フィールドが含まれます。正規かつエスクロー済みと明示された掲載のみを資金提供済みとしてラベル付けします。それ以外の掲載は、リクエストされた場合にのみ表示され、未検証としてラベル付けされます。

PayanAgent カタログの健全性

POST /v1/payanagent-health は x402 経由で $0.01 かかります。1〜25 の任意の limit を指定でき、読み取り専用の HEAD リクエストのみを使って、ランク付けされたパブリックカタログを確認します（必要に応じて OPTIONS にフォールバックします）。HTTP 402 は、稼働中の支払いゲートが応答したことを意味します。このサービスは、支払いヘッダーを送信したり、有料ルートを呼び出したりすることはありません。応答には、オファーごとのステータス、HTTP コード、レイテンシ、集計数、generated_at が含まれます。

Base market pulse

POST /v1/base-market-pulse は x402 経由で $0.01 の料金がかかり、{} を受け付けます。エージェントディレクトリやシンプルな HTTP クライアント向けに、同等の GET ルートも用意されています。Coinbase の公開 ETH/USD スポットエンドポイント、DEX Screener の公開 Base WETH/USDC ペアフィード、および現在のブロックとガス価格を取得する公開 Base JSON-RPC メソッドを読み取ります。ソースごとのヘルス状態とタイムスタンプ付きの値を返し、いずれかのソースが利用できない場合は部分的な結果を返します。これは情報提供のみを目的としたデータであり、取引やトランザクションの送信は行いません。

POST /v1/agent-work-brief は $0.03 の料金がかかり、min_reward_usd、limit、health_limit の各フィルターを任意で受け付けます。現在の作業に取り組む価値があるかをエージェントが判断するためのものであり、申し立て、支払い、下流への有料呼び出しは行いません。

GET /.well-known/x402（/.well-known/x402.json としても利用可能）は、機械可読なサービスマニフェスト、ルート、価格、ネットワーク、アセット、支払い先アドレスを公開します。マニフェストはリクエストのホストから生成されるため、無料の開発用トンネルが切り替わっても正しい状態が保たれます。

オプションの agent-tools ハブゲートウェイが有効な場合、決済済みのリクエストをハブが発行した X-Hub-Secret とともに /hub/v1/base-market-pulse に転送します。この上流パスは、シークレットがない場合は 404 を返し、直接の x402 ルートとは別のものです。

MCP integration

このリポジトリには、Cline やその他の MCP クライアント向けのローカル stdio MCP サーバーも含まれています。

npm run start:mcp

preflight_context ツールでは、最大 12,000 文字までの無料のローカルティアを利用できます。それより大きな入力の場合は、有料 HTTP エンドポイントとその x402 料金が返されます。MCP サーバーの起動時に、現在デプロイされているエンドポイントを PAID_ENDPOINT に設定してください。クライアント設定をコピーして貼り付けるには、llms-install.md を参照してください。

同じサーバーは、ホストされたステートレスな Streamable HTTP MCP エンドポイント https://agent-context-api-proxy.agent-context-proxy.workers.dev/mcp としても利用でき、server.json に記載されています。クライアントや下流ディレクトリから検索できるよう、公式 MCP Registry に公開されています。このホスト型ルートは、リモート MCP サーバーを検出できるクライアント向けです。セルフホストやオフラインでの事前確認には、引き続きローカルで実行できます。glama.json は、ディレクトリでのインデックス作成と所有権確認のために GitHub のメンテナーを示します。

Design notes

• server.js には、Express アプリ、x402 決済ミドルウェア、検出用メタデータ、ルートの設定が含まれています。
• mcp-core.js は共有 MCP ツールのインターフェースを定義します。mcp-server.js は stdio 経由で実行し、/mcp は Streamable HTTP 経由で実行します。
• analysis.js には決定論的なコンテキスト分析が含まれています。bounty-radar.js にはソースの正規化とエビデンスポリシーが含まれています。
• payanagent-health.js には、範囲を限定した読み取り専用のカタログ収集機能とプローブロジックが含まれています。
• market-pulse.js には、範囲を限定した公開市場／RPC データの収集機能と、ソースが一部利用できない場合のヘルス状態出力が含まれています。
• test/server.test.js は、秘匿化、予算、ヘルスルート、資金あり／なしのラベル付けを検証します。test/payanagent-health.test.js は、ヘルス分類と支払いを行わないプローブの仕様を検証します。
• API は送信されたテキストを意図的に第三者へ送信しません。処理はローカルで行われます。
• これは実験です。収益は、402 レスポンス、リクエスト、ディレクトリ掲載状況から推測するのではなく、決済記録で確認する必要があります。