Agent Tools

エージェントツール

エージェント向けユーティリティ API バンドルです。9 個のエンドポイントを REST API と MCP サーバー（streamable-http）の両方で公開し、x402 マイクロペイメントに対応しています。tools.beethoven2024.com で稼働中です。

AI エージェント向け（Claude、Cursor、カスタム構成）： この MCP サーバーを設定に追加すると、9 個のユーティリティツールをすぐに利用できます。

開発者向け： 標準の REST API です。以下のサブドメインの例を、動作するサンプルとして使用できます。

今すぐ試す

MCP サーバーとして（Claude、Cursor、エージェント）

{
  "mcpServers": {
    "agent-tools": {
      "url": "https://tools.beethoven2024.com/mcp"
    }
  }
}

REST API として

curl https://tools.beethoven2024.com/health
# {"status":"ok","version":"0.1.0"}

curl "https://tools.beethoven2024.com/v1/dns/health?domain=example.com"
# Full DNS + mail security audit (requires x402 payment)

バンドルの内容

ツール	エンドポイント	機能	価格
qr_generate	/v1/qr/generate	QR コードの生成（PNG/SVG、64～2048px）	$0.001
dns_health	/v1/dns/health	DNS レコードと SPF/DMARC メールセキュリティ監査	$0.003
email_validate	/v1/email/validate	形式、MX、使い捨てドメイン、ロールアカウント、SMTP プローブの検証	$0.005
ip_lookup	/v1/ip/lookup	ジオロケーション、ISP、プロキシ／ホスティングの検出、逆引き DNS	$0.005
url_health	/v1/url/health	ステータスコード、リダイレクトチェーン、SSL 証明書、応答時間	$0.003
whois_lookup	/v1/whois/lookup	レジストラ、作成日／有効期限、ネームサーバー、ステータス	$0.005
headers_analyze	/v1/headers/analyze	0～100 のスコア付き HTTP セキュリティヘッダー監査（HSTS、CSP など）	$0.003
extract_text	/v1/extract/text	ウェブページからのクリーンなテキスト抽出（HTML、ナビゲーション、広告を除去）	$0.005
tech_detect	/v1/tech/detect	ウェブサイトの技術スタック — フレームワーク、CMS、CDN、アナリティクス	$0.005

無料： /health、/、/docs（OpenAPI）、および MCP プロトコルメソッドの initialize／tools/list／ping。9 個すべてのツールは、MCP（tools/call）と REST（/v1/*）の両方で x402 による支払いが必要です。

エンドポイントを提供する理由

各エンドポイントは、エージェントがローカルでは簡単に実行できない問題を解決します。

• ネットワークインフラストラクチャ（DNS、WHOIS、ヘッダー、URL の状態、IP） — インターネットへのプローブが必要で、プロセス内では実行できません
• 専門的な解析（QR、SMTP を使ったメール検証、技術検出） — エージェントが再実装すべきではない、ドメイン固有のロジックです
• ウェブ抽出（テキスト抽出） — 複雑な HTML からクリーンなテキストを抽出するのは困難です

9 個中 8 個のエンドポイントは完全にセルフホスト可能です（上流 API のコストはかかりません）。IP ジオロケーションのみ、外部の無料枠 API を使用します。

支払い

x402（マシン間マイクロペイメント）

支払いが含まれていない場合、有料エンドポイントはすべて、価格情報を含む HTTP 402 Payment Required を返します。x402 対応エージェントは、これを自動的に処理します。

1. エージェントがエンドポイントを呼び出す → payment_requirements（ネットワーク、金額、受取人アドレス）を含む 402 を受け取る
2. エージェントが Base 上で USDC を送金するための EIP-3009 transferWithAuthorization に署名する
3. エージェントが X-PAYMENT ヘッダーを付けて再試行する
4. サービスがファシリテーター経由で支払いを検証し、処理を実行して結果を返す

決済は Base 上のオンチェーンで行われます。確認は 2 秒未満です。

デフォルトでは Base メインネットで動作します。AGENT_TOOLS_TESTNET=true を設定すると、公開テストネット用ファシリテーターを使って Base Sepolia を利用できます。

従来型の課金

近日公開：個人開発者や企業向けの API キーと Stripe 従量課金。

技術スタック

• Python 3.12 + FastAPI
• MCP SDK（mcp v1.27） — streamable-http トランスポート
• x402 SDK（x402[fastapi,evm] >=v2.11） — Base 上での USDC マイクロペイメント
• 9 個中 8 個のエンドポイントはセルフホスト可能（上流 API のコストなし）
• シングルプロセスでのデプロイ、メモリ使用量は約 62MB

セルフホスト

Fly.io

git clone https://github.com/WingedGuardian/agent-tools.git
cd agent-tools
fly launch --copy-config
fly secrets set AGENT_TOOLS_PAY_TO=0xYourAddress AGENT_TOOLS_TESTNET=false
fly deploy

Docker

git clone https://github.com/WingedGuardian/agent-tools.git
cd agent-tools
cp .env.example .env
# Edit .env with your wallet address
docker compose up -d

手動

pip install ".[all]"
AGENT_TOOLS_PAY_TO=0xYourAddress uvicorn agent_tools.app:app --host 0.0.0.0 --port 8000

設定

変数	必須	デフォルト	説明
AGENT_TOOLS_PAY_TO	いいえ	(empty)	USDC 支払いの受け取りに使う EVM ウォレットアドレスです。無料／開発モードで実行する場合は空のままにします。
AGENT_TOOLS_TESTNET	いいえ	true	true = Base Sepolia テストネット（デフォルト — 公開 x402.org ファシリテーターで動作）。false = Base メインネット（メインネット対応ファシリテーターが必要）。

ディスカバリー／レジストリ

• GitHub: https://github.com/WingedGuardian/agent-tools
• Smithery: (登録待ち)
• Glama: (登録待ち)
• x402-list: (登録待ち)
• npm: (公開待ち)

キーワード

x402、マイクロペイメント、USDC、Base、エージェントネイティブ、MCP、Model Context Protocol、streamable-http、エージェント型、AI エージェントツール、DNS ルックアップ API、WHOIS API、メール検証 API、QR コード API、URL ヘルス API、ウェブスクレイピング API、技術検出 API、セキュリティヘッダーアナライザー

ライセンス

MIT