Agent Tools Mcp

mcpserver — agent-tools.cloud ディレクトリ ＋ MCP ディスカバリー

agent-tools.cloud を支えるサーバーです。無料の MCP ディスカバリーエンドポイントを備えた、x402 有料サービスのオープンディレクトリです。 Smithery にも掲載されています。

注（2026-05-25）： 以前ホストしていた有料の Qwen3.6 リレーと有料の垂直エンドポイント（signal／onchain／defi／portfolio）は、外部コンバージョンが 30 日間ゼロだったため提供を終了しました。このリポジトリは現在、ディレクトリサイトと無料の MCP ディスカバリーサーバーのみを提供しています。

現在提供している機能

パス	認証	目的
GET /（ホスト = agent-tools.cloud）	無料	ディレクトリサイト（検索／閲覧）
GET /api/v1/search	無料	ファセット検索によるサービス検索
POST /api/v1/ask	無料、レート制限あり	ディレクトリ内の候補に基づく、LLM によるランキング付きおすすめ
GET /api/v1/services/{slug}	無料	支払い、呼び出し、品質のメタデータを含むサービスカード
GET /api/v1/categories, /api/v1/stats	無料	ディレクトリのファセットと集計統計
POST /api/v1/submit	無料、レート制限あり	重複排除機能付きのサービス登録申請
POST /mcp-discovery/	無料	MCP streamable-http ディスカバリーサーバー
POST /a2a	無料	A2A JSON-RPC エージェント（message/send）：ディレクトリ検索 ＋ MCP 安全性スキャン
GET /healthz	無料	稼働状態
GET /v1/models	無料	アップストリームモデル一覧（読み取り専用）
GET /.well-known/agent-tools.json	無料	エージェントディスカバリーマニフェスト
GET /.well-known/x402	無料	x402 v0.4 の自己記述（無料のみ）
GET /.well-known/mcp.json	無料	MCP の自己記述

MCP ディスカバリーサーバーは、スタンドアロンの PyPI パッケージとしても公開されています： agent-tools-mcp (リポジトリ)。

MCP ディスカバリーツール

search(intent, top_k=5, category=None, max_price_usd=None, has_mcp=None)
ask_services(intent, top_k=5, category=None, max_price_usd=None, use_llm=True)
get(slug)
list_categories()
stats()
search_mcp_servers(intent, top_k=5, chain=None, require_healthy=False)
get_mcp_server(slug)
search_a2a_agents(intent, top_k=5, x402_only=False)
search_resources(intent, protocol=None, top_k=10)
scan_mcp_safety(endpoint_url, name="", description="", tools_text="")
register(url, name=None, description=None, mcp_url=None, category=None)

search は自然言語による意図を受け取り、FTS5 ＋ 人気度 ＋ 稼働状態に基づいて順位付けします。各結果には match_reason と confidence スコアが含まれます。 ask_services は /api/v1/ask と同じ、検索を優先してから LLM で再ランキングするフローを使用します。

scan_mcp_safety は、接続前にエンドポイント URL で MCP サーバーを審査し、マルウェアやプロンプトインジェクションの誘いを検出します。すでにインデックスに登録されているサーバーの場合は、最新の保存済み判定を返します。未登録のサーバーの場合は、ライブで調査・スキャンし、ディレクトリに追加します。判定は、サーバーが公開している名前、説明、ツールドキュメントに対する決定論的な静的ルール（コード実行なし）に基づきます。ルールでは、パイプからシェルへの実行／base64-eval／PowerShell のインストール用クレードル、ベア IP のペイロードホスト、プロンプトインジェクションを誘発する表現、MCP のツールポイズニングによる強制（「常に最初にこのツールを呼び出す」、「ほかのツールを使用する前に必ず……」、非表示の <IMPORTANT> 指示、「すべての API キーを列挙する／レスポンスにシークレットを含める」、.key／.pem／.ssh／.env ファイルを読み取って転送するよう強いる指示）を対象とします。誤検知を避けるため、SQL／コマンド／コードのインジェクションなど、ソースコードを対象とするルールは自然言語の説明には適用しません。各ライブ呼び出しでは、助言的な観点として最先端の LLM によるセカンドオピニオンも実行されます。 この機能は POST /a2a の A2A スキルとしても公開されています。ホスト版サーバーには上記のツール一式が含まれますが、stdio の agent-tools-mcp PyPI パッケージに含まれるのは中核となる検索ツールのみです。

デプロイ

現在、nginx の背後にある latex-tools にデプロイされています（vhost：agent-tools.cloud）。

cd /opt/mcpserver
sudo git pull
sudo systemctl restart mcpserver

systemd ユニットは deploy/ にあります。

• mcpserver.service — ASGI アプリ（uvicorn、127.0.0.1:9100）
• agent-tools-crawl.{service,timer} — 6 時間ごとのディレクトリクローラー
• agent-tools-health.{service,timer} — エンドポイントのヘルスチェック

設定

.env.exampleを参照してください。必須項目：

• UPSTREAM_BASE_URL / UPSTREAM_API_KEY — /v1/modelsで使用します
• AGENT_TOOLS_ASK_BASE_URL / AGENT_TOOLS_ASK_API_KEY / AGENT_TOOLS_ASK_MODEL — /api/v1/ask用のLLMバックエンドです
• AGENT_TOOLS_SAFETY_BASE_URL / AGENT_TOOLS_SAFETY_API_KEY / AGENT_TOOLS_SAFETY_MODEL — scan_mcp_safetyの助言用LLMのオプションの上書き設定です（設定しない場合はAGENT_TOOLS_ASK_*バックエンドにフォールバックします）
• AGENT_TOOLS_DB_PATH — ディレクトリ用のSQLiteパスです
• AGENT_TOOLS_ASK_RATE_LIMIT_PER_MINUTE / AGENT_TOOLS_ASK_RATE_LIMIT_PER_DAY — 公開Askの不正利用を制限します
• METRICS_BEARER_TOKEN — /metricsへのオプションのリモートアクセストークンです。設定しない場合、メトリクスへのアクセスはローカルのみです

スモークテスト

# Liveness
curl https://agent-tools.cloud/healthz

# Directory stats
curl https://agent-tools.cloud/api/v1/stats

# Intent-level service recommendation
curl -s -X POST https://agent-tools.cloud/api/v1/ask \
  -H 'content-type: application/json' \
  -d '{"query":"find a weather API that accepts x402","limit":2}'

# Service card
curl https://agent-tools.cloud/api/v1/services/weather-hugen-tokyo-scan

# MCP discovery handshake
curl -s -X POST https://agent-tools.cloud/mcp-discovery/ \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-06-18","capabilities":{},
                 "clientInfo":{"name":"smoke","version":"1"}}}'

# Retired paid path -> 404
curl -s -o /dev/null -w '%{http_code}\n' -X POST \
  https://agent-tools.cloud/v1/chat/completions \
  -H 'content-type: application/json' \
  -d '{"model":"Qwen/Qwen3.6-35B-A3B","messages":[{"role":"user","content":"hi"}]}'
# => 404

ライセンス

このリポジトリに含まれるagent-tools.cloudのサーバーおよびディレクトリのコードは、**PolyForm Noncommercial License 1.0.0**の下でライセンスされています。非商用の目的であれば、使用、変更、共有できます。商用利用は認められていません。

agent-tools-mcp/にあるスタンドアロンのMCPクライアントパッケージ（PyPIではagent-tools-mcpとして公開）は、別途**Apache-2.0**の下でライセンスされているため、商用のものを含むあらゆるエージェントがホストサービスを自由にインストールして呼び出せます。

agent-tools.cloudのホストサービスの利用には、このコードのライセンスではなく、利用規約が適用されます。