Ai Agent Api

AI Agent API — USDC のマイクロペイメントで利用できる 25 の REST サービスと 30 の MCP サービス

DeepSeek V4 Pro（100 万トークンのコンテキスト） · x402 マイクロペイメント · AI エージェント向け MCP · 人間向け API キー

Web3 エージェント向けに構築された、初の従量課金制 AI API です。サブスクリプションは不要です。API プランもありません。1 回の呼び出しにつき USDC で $0.001～$1.00 を支払います。使った分だけのお支払いです。

---

目次

• これが必要な理由
• クイックスタート
• アーキテクチャ
• サービス
• 支払い方法
• MCP 接続
• エージェントの検出
• よくある質問
• ロードマップ
• セキュリティ
• コントリビューション

---

これが必要な理由

AI エージェントにはツールが必要です。しかし、どの AI API を使うにも、クレジットカード、サブスクリプション、または中央集権型プロバイダーの API キーが必要です。Web3 エージェントは暗号資産を使います。暗号資産で支払えるべきです。

この API は、Claude Code、Cursor、または MCP 対応クライアントで動作するAI エージェント向けのツールボックスです。各ツールの料金は数セントです。x402（Base L2 上の USDC、ガス代は約 $0.001）で従量課金されます。アカウントは不要です。

利用者

利用者	使用するもの	用途
Solidity 開発者	solidity-scan + contract-verify	デプロイ前にコントラクトをスキャンし、36 種類の SWC 脆弱性を検出
DeFi アナリスト	whale-tracker + smart-money + defi-research	クジラのウォレットを追跡し、スマートマネーの取引をコピーし、プロトコルを分析
コードレビュアー	audit + refactor + code-health-check	セキュリティ監査 → リファクタリング → ドキュメント生成を 1 つのパイプラインで実行
データエンジニア	nl-to-sql + extract-data + data-pipeline	自然言語 → SQL → 構造化データの抽出 → 整形済みの出力
セキュリティ研究者	agent-audit + security-score	プロンプトインジェクション、ツールの誤用、信頼度スコアリングについて AI エージェントを監査
DevOps	debug-log + git-summarize	CI エラーを解析し、git diff から PR の説明を自動生成

---

クイックスタート

AI エージェント向け（MCP + x402 暗号資産決済）

# 1. Connect your agent — no API key needed
# Claude Code:
/mcp add --transport sse https://agent-api-ai.duckdns.org/mcp/sse

# 2. Call any tool — get 402 with payment details
# The tool response tells you where to send USDC and how much

# 3. Send USDC to the wallet from the 402 response
# 4. Retry — tool executes, result returned

MCP ツールでは payment_tx パラメーターを使用します — USDC を送金した後、トランザクションハッシュを貼り付けてください。

開発者向け（API キー）

# 1. Get a free API key (50 free credits = $0.05)
curl -X POST https://agent-api-ai.duckdns.org/billing/create-key
# → {"api_key": "ak-abc123...", "credits": 50}

# 2. Call any service
curl -X POST https://agent-api-ai.duckdns.org/api/audit \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ak-abc123..." \
  -d '{"code": "function transfer(to, amount) { ... }"}'

# 3. Top up with crypto when credits run low
curl -X POST https://agent-api-ai.duckdns.org/billing/register-wallet \
  -H "Content-Type: application/json" \
  -d '{"api_key":"ak-abc123...","wallet":"0xYourWallet"}'
# Send USDC to 0xdE7eb04faE758055642f67f30D246CcB7136C95E on Base
# Credits appear automatically in ~60 seconds. Bonus: $10→+10%, $50→+20%, $100→+30%

コードなしで試す

# Service manifest with all prices
curl https://agent-api-ai.duckdns.org/.well-known/x402

# OpenAPI 3.1 spec
curl https://agent-api-ai.duckdns.org/.well-known/openapi.json

# Trigger 402 to see payment flow
curl -X POST https://agent-api-ai.duckdns.org/api/validate-json \
  -H "Content-Type: application/json" \
  -d '{"data": "{\"name\": \"test\"}"}'
# → HTTP 402 + PAYMENT-REQUIRED header with wallet and amount

---

アーキテクチャ

flowchart TD
    A[AI Agent / Client] -->|1. Request| B[Rate Limiter<br/>10 req/min/IP]
    B --> C[Security Headers]
    C --> D[API Key Auth?]
    D -->|Yes: API key| E[Credit Check<br/>pre-deduct max]
    D -->|No| F[x402 Payment Middleware]
    F -->|No payment| G[402 Payment Required<br/>+ wallet + amount]
    F -->|Has payment| H[Facilitator.verify<br/>on-chain USDC check]
    H -->|Invalid| G
    H -->|Valid| I[Route Handler]
    E -->|Insufficient| G
    E -->|Sufficient| I
    I --> J[validate_min_price<br/>fail-closed]
    J --> K[cached_completion<br/>SHA-256 LRU cache]
    K -->|Miss| L[DeepSeek V4 Pro<br/>1M context]
    K -->|Hit| M[Cache Hit — zero tokens]
    L --> N[settle_actual_usage<br/>charge actual tokens]
    M --> N
    N --> O[Response + Cost Headers]

レイヤー	詳細
決済ネットワーク	Base、Arbitrum、Optimism、BNB Chain（USDC）+ Tron（USDT）
キャッシュ	1000 エントリー、TTL 10 分、SHA-256 をキーに使用 — 繰り返しの呼び出しは無料
セキュリティ	正規表現によるインジェクション検出パターン 12 種、サーキットブレーカー、指数バックオフによる再試行、リプレイ保護
ファシリテーターモード	PayAI、Direct（Transfer + EIP-3009）、CDP、ChaosChain

---

MCP ツール 30 種 + REST サービス 25 種

AI サービス（利用量に応じた料金 — 実際のトークン使用量に対して支払い）

サービス	料金	説明
audit	$0.01–$0.05	セキュリティスキャン — OWASP Top 10 + SWC Registry
refactor	$0.01–$0.05	レガシーコードのモダナイゼーション（DRY、SOLID）
docs	$0.005–$0.03	コードから技術ドキュメントを作成
defi-analyze	$0.01–$0.04	DeFi プロトコル分析（学習データのみ）
trading-signal	$0.005–$0.03	暗号資産市場の分析（金融アドバイスではありません）
solidity-scan	$0.02–$0.08	Solidity 脆弱性スキャナー（SWC チェック 36 種）
nl-to-sql	$0.005–$0.03	自然言語 → SQL
sql-to-nl	$0.005–$0.02	SQL → 平易な英語
translate-code	$0.01–$0.05	コードの翻訳（Python、TS、Rust、Go、Solidity）
git-summarize	$0.005–$0.02	Git diff → PR の説明

DeFi シグナル（価格まで）

サービス	価格	説明
whale-tracker	$0.015–$0.03	Base／Arbitrum におけるクジラウォレットの動きを追跡します
smart-money	$0.025–$0.05	スマートマネーのウォレットを分析します — 勝率、損益パターン
price-feed	$0.01–$0.02	サポート／レジスタンス水準を含む、AI 強化型トークン価格分析

セキュリティ（価格まで）

サービス	価格	説明
agent-audit	$0.25–$0.50	AI エージェントの包括的なセキュリティ監査 — コード、挙動、信頼スコア
contract-verify	$0.50–$1.00	スマートコントラクトの形式検証 — 36 の SWC と DeFi エクスプロイト
security-score	$0.05–$0.10	迅速なセキュリティ評価 — 簡易スコアとリスクレベル
amm-security-check	$0.02–$0.05	AMM プールのセキュリティ — サンドイッチ攻撃、インパーマネントロス、TVL リスク

データと DevOps

サービス	価格	説明
data-feed	$0.01–$0.02	あらゆるトピックの構造化データフィード — 機械可読な JSON
debug-log	$0.01–$0.03	CI/CD エラーログ分析 — 根本原因と修正案

マイクロタスク（固定価格）

サービス	価格	説明
validate-json	$0.001	JSON／YAML の構造を検証します
classify-text	$0.001	感情、カテゴリ、キーワードを分類します
extract-data	$0.005	名前、メールアドレス、電話番号、URL を抽出します
generate-regex	$0.002	説明文からテスト付きの正規表現を生成します
format-data	$0.003	CSV／JSON／YAML を変換します
summarize	$0.002	テキストを N 語に要約します

複合スキル（複数ステップのパイプライン）

サービス	価格	手順
defi-research	$0.08	抽出 → 分析 → 要約
code-health-check	$0.10	監査 → リファクタリング → ドキュメント化
smart-contract-audit	$0.10	スキャン → ドキュメント化
data-pipeline	$0.05	抽出 → 形式変換 → 要約
run-workflow	変動	ユーザー登録の複合ワークフロー

---

支払い方法

x402 プロトコル（AI エージェント）

Base、Arbitrum、Optimism、BNB Chain 上の USDC、または Tron 上の USDT を利用します。API キーは不要です — エージェントが暗号資産で支払います。

ネットワーク	トークン	ウォレット
Base	USDC	0xdE7eb04faE758055642f67f30D246CcB7136C95E
Arbitrum	USDC	0xdE7eb04faE758055642f67f30D246CcB7136C95E
Optimism	USDC	0xdE7eb04faE758055642f67f30D246CcB7136C95E
BNB Chain	USDC	0xdE7eb04faE758055642f67f30D246CcB7136C95E
Tron	USDT	TADavZEHddjYMQcL2cnaFadFVKAUmP9wMw

REST の手順： 呼び出し → PAYMENT-REQUIRED ヘッダー＋ウォレット＋金額を含む 402 応答 → USDC を送金 → payment-signature ヘッダーを付けて再試行 → オンチェーンで検証 → 結果

MCP の手順： payment_tx なしでツールを呼び出し → 支払い詳細を含むエラー → USDC を送金 → payment_tx=<tx-hash> を付けて再試行 → オンチェーンで検証 → 結果

EIP-3009（ガス代不要）： クライアントが EIP-712 ReceiveWithAuthorization にオフチェーンで署名 → サーバーがオンチェーンで送信（ガス代は約 $0.001、サーバー負担）。AuthorizationUsed イベントを発行し、インデクサーから確認できます。

API キー（開発者向け）

# Create key (50 free credits)
curl -X POST https://agent-api-ai.duckdns.org/billing/create-key

# Check balance
curl "https://agent-api-ai.duckdns.org/billing/balance?key=ak-YOUR_KEY"

# Register wallet for auto-top-up
curl -X POST https://agent-api-ai.duckdns.org/billing/register-wallet \
  -H "Content-Type: application/json" \
  -d '{"api_key":"ak-...","wallet":"0x..."}'

# Call with key
curl -X POST https://agent-api-ai.duckdns.org/api/audit \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ak-YOUR_KEY" \
  -d '{"code": "function transfer(to, amount) { ... }"}'

チャージボーナス： $10→+10%、$50→+20%、$100→+30%。オンチェーンでの確認後、約 60 秒でクレジットが自動付与されます。

---

Docker

docker build -t agent-api .
docker compose up -d
curl http://localhost:8000/health

---

MCP（AI エージェント接続）

SSE エンドポイント： https://agent-api-ai.duckdns.org/mcp/sse

ワンクリックインストール

クライアント	インストール
Smithery	npx -y smithery mcp add antoNYak0/ai-agent-api
Cursor	Cursor に追加
Claude Code	/mcp add --transport sse https://agent-api-ai.duckdns.org/mcp/sse
VS Code	MCP 設定で https://agent-api-ai.duckdns.org/mcp/sse を追加します

掲載先

マーケットプレイス	状況	検出方法
Smithery.ai	✅ 稼働中	smithery.yaml + /.well-known/mcp/server-card.json
Glama.ai	✅ 稼働中	/.well-known/glama.json（自動インデックス登録）
mcp.so	⏳ 審査中	mcp.json + Issue #2453
MCP Registry	📋 予定	server.json（PR 保留中）
PulseMCP	🔄 Registry 登録後	MCP Registry から自動取り込み

---

エージェントの検出

マーケットプレイスやエージェントフレームワークが自動検出するための、7 つの well-known エンドポイントです。

エンドポイント	用途
/.well-known/x402	x402 決済マニフェスト（全 25 サービスと価格）
/.well-known/openapi.json	x402 拡張を含む OpenAPI 3.1 仕様
/.well-known/mcp/server-card.json	Smithery サーバーカード（30 ツール）
/.well-known/glama.json	Glama の自動検出
/.well-known/agent-card.json	A2A エージェントカード
/.well-known/agentic-market-services.json	Agentic Market の掲載情報
/.well-known/agent.json	AP2 Agent Payments Protocol

---

よくある質問

Q: 「upto」価格設定はどのように機能しますか？ 最大金額（例：$0.05）を承認します。実際に使用したトークン分だけが課金されます。AI の応答が 3000 トークンではなく 100 トークンだった場合、支払いは約 $0.01 です。最大金額は上限であり、価格ではありません。これは、正確な固定価格のマイクロタスクとは異なります。

Q: REST エンドポイントと MCP ツールの違いは何ですか？ 同じ AI サービスを、異なるインターフェースで利用します。REST は x402 ヘッダーを使った HTTP POST（/api/audit）です。MCP は SSE（/mcp/sse）を介した Model Context Protocol で、Claude Code や Cursor などの AI エージェント向けに設計されています。MCP ツールでは payment_tx をパラメーターとして渡し、REST では HTTP ヘッダーを使用します。

Q: 過払いした場合はどうなりますか？ Transfer 決済の場合、超過分はサーバーに残ります（チップのようなものです）。正確な金額を使用してください。EIP-3009 の場合は正確に精算されるため、過払いは発生しません。

Q: 決済の検証にはどれくらい時間がかかりますか？ Base L2 では約 1～3 秒です（1 ブロックの承認）。Tron では 5～10 秒かかる場合があります。

Q: 返金を受けられますか？ 返金には対応していません。AI の計算処理は即座に消費されます。テストには少額から始めてください。

Q: AI でエラーが発生した場合はどうなりますか？ エラーが発生するまでに消費したトークン分のみが課金されます。レスポンスヘッダー X-Actual-Cost には、支払った金額が常に表示されます。

Q: コードは保存またはログ記録されますか？ いいえ。キャッシュ用にコードをハッシュ化（SHA-256、TTL は 10 分）しますが、平文では保存しません。キャッシュエントリーはメモリー上にのみ保持されます。

Q: どのチェーンに対応していますか？ Base、Arbitrum、Optimism、BNB Chain（USDC）および Tron（USDT）に対応しています。ガス料金が最も低い Base を推奨します。

Q: AI エージェントを使わずにスクリプトから利用できますか？ はい。API キーを使用してください。POST /billing/create-key を実行すると、無料クレジットを 50 取得できます。

Q: 複合スキルはどのように機能しますか？ 2～3 回の AI 呼び出しを 1 つのパイプラインにつなぎます。たとえば code-health-check は、audit → refactor → docs を順番に実行します。固定料金 1 回分で、3 つすべての結果を取得できます。

Q: KYC は必要ですか？ x402 の暗号資産決済や API キーには KYC は不要です。KYC が必要なのは Coinbase CDP facilitator モードのみで、これはデフォルトではありません。

---

ロードマップ

• x402 USDC 決済（Transfer + EIP-3009）
• 暗号資産による自動チャージに対応した API キーのクレジットシステム
• 30 個の MCP ツール + MCP SSE トランスポート
• Smithery + Glama マーケットプレイスへの掲載
• 7 つの well-known 検出エンドポイント
• LRU キャッシュ（TTL は 10 分、再利用時は無料）
• MCP Registry への公式掲載（PR 保留中）
• mcp.so への掲載
• PayAI Bazaar への掲載（ロシアのため KYC が停止中）
• マルチエージェントワークフローのマーケットプレイス
• SSE によるストリーミングレスポンス（/api/stream/{service}）
• 結果マーケットプレイス — 他のエージェントによるキャッシュ済み AI 結果の購入

---

レスポンス形式

すべてのサービスは、一貫した JSON エンベロープを返します。

{
  "result": "{\"valid\": true, \"errors\": [], \"warnings\": []}",
  "payment_network": "eip155:8453",
  "payment_tx": "0x..."
}

レスポンスヘッダーには、X-Actual-Cost（課金額）と X-Cache-Hit（結果がキャッシュから取得されたかどうか）が含まれます。

---

セキュリティ

• SECURITY.md — 攻撃検知機能を含むセキュリティポリシーの全容
• /health/security — リアルタイムのセキュリティステータスエンドポイント
• /health/metrics — Prometheus メトリクス（レート制限、リプレイブロック、インジェクション試行、収益）
• 12 種類の正規表現パターン — プロンプトインジェクション対策（ジェイルブレイク、ロール切り替え、プロンプト漏えい）
• レート制限 — IP ごとに 10 リクエスト／分＋累積ブロックカウンター
• リプレイ保護 — SQLite ベースの決済トランザクション重複排除（30 分の TTL）
• API キー — 保存時に SHA-256 でハッシュ化し、ファイルをアトミックに書き込み

---

貢献

アーキテクチャの概要、PR チェックリスト、新しい AI サービスの追加方法などのガイドラインについては、CONTRIBUTING.md をご覧ください。

クイックリンク：

• バグを報告
• 機能をリクエスト
• 質問する

---

リンク

• ダッシュボード — サービスのライブステータス＋暗号資産によるチャージ
• Swagger ドキュメント — インタラクティブな API リファレンス
• ヘルスチェック
• OpenAPI 仕様
• x402 マニフェスト
• セキュリティステータス
• Prometheus メトリクス
• AGENTS.md — このサーバーに接続する AI エージェント向けの手順