Tools for Agents

エージェント向けツール

AI エージェントの意思決定レイヤー — ワークフローを計画し、100 以上のツールを実行して、複数ステップのミッションを委任できます。
単なる API カタログではありません。自律型エージェント向けに構築されたオーケストレーションプラットフォームです。

概要 · 対象ユーザー · 仕組み · クイックスタート · 例 · インテグレーション · ドキュメント

---

これは何ですか？

Tools for Agents は、AI エージェントに現実世界での機能を提供するホスト型 API プラットフォームです。ウェブサイトの閲覧、ウェブ検索、PDF の抽出、OCR の実行、RAG パイプラインの構築、事実確認、構築済みのツールチェーンの実行を、すべて機械可読な REST、MCP、A2A インターフェースを通じて行えます。

100 個あるエンドポイントのうちどれを呼び出すか推測する代わりに、エージェントはまずAgent Advisorを利用します。目標を説明すると、ワークフロー計画、コスト見積もり、信頼度スコアが得られます。その後、検証エラーを防ぐコピー＆ペースト用の例を使ってツールを呼び出せます。

得られるもの	代わりに
POST /v1/advisor → 計画 + 代替案	100 個のエンドポイントから手動で選択
GET /v1/tools/{tool}/examples → 正確な JSON 本文	試行錯誤による 422 エラー
POST /v1/chains/run → 複数ステップのパイプライン	5 つのツールを自分で連携
POST /a2a/v1/skills/.../invoke → リモートエージェントに委任	すべてのステップで低レベルの REST を使用
pip install agenttools-client → 自己修復型 SDK	生の httpx + カスタムリトライロジック

稼働中のサービス： toolsforagents.tools · API： api.toolsforagents.tools

---

対象ユーザー

対象	ユースケース
自律型 AI エージェント	自己登録し、Advisor で計画し、ツールを呼び出します — 人間の介在は不要です
エージェント開発者（LangChain、CrewAI、カスタムオーケストレーター）	REST + Python SDK + ツールチェーン
IDE エージェント（Cursor、Claude Desktop、Windsurf）	/mcp のリモート MCP — 設定
マルチエージェントシステム	A2A Agent Card + 13 個のスキル — 調査、取り込み、ミッションを委任
エージェントのプロトタイプを作成する開発者	無料枠：1 日あたり 5,000 リクエスト、即時発行の API キー、Swagger UI

エージェントにとっての重要なルール： API キーを人間に尋ねてはいけません。
プログラムで登録してください：本文 {} を指定して POST /v1/register を実行します。

---

仕組み

  ┌──────────────┐     1. Plan          ┌─────────────────────┐
  │ Your agent   │ ──────────────────► │  Agent Advisor      │
  │ (any stack)  │     POST /advisor   │  workflow · cost    │
  └──────┬───────┘                     └──────────┬──────────┘
         │                                        │
         │  2. Register (once)                    │ 3. Execute
         │  POST /register {}                     ▼
         │                             ┌─────────────────────┐
         └────────────────────────────►│  Tools for Agents   │
              REST · MCP · A2A · SDK   │  extract · pdf · rag │
                                       │  chains · missions   │
                                       └──────────┬──────────┘
                                                  │
                    ┌─────────────────────────────┼─────────────────────────────┐
                    ▼                             ▼                             ▼
              Web & documents              Trust & cognitive              Orchestration
              extract, ingest, pdf        verify, confidence, bias       chains, workflows

一般的なエージェントのループ：

1. GET /v1/onboarding — プレイブックを読む
2. POST /v1/advisor — 実行前に計画する（0 ユニット）
3. POST /v1/dry-run — URL のコストと JS を調べる（約 450 ms、0 ユニット）
4. POST /v1/register {} — API キーを取得する（メールアドレス不要）
5. GET /v1/tools/{tool}/examples — 正確なリクエスト本文をコピーする
6. ツールを呼び出す · または POST /v1/chains/run · または A2A スキルを実行する

---

クイックスタート

オプション A — Python SDK（推奨）

pip install agenttools-client

import asyncio
from agenttools_client import AsyncAgentToolsClient

async def main():
    async with AsyncAgentToolsClient() as client:
        # Auto-registers if no API key
        plan = await client.advisor("Extract markdown from a blog post URL")
        page = await client.extract("https://example.com", format="markdown")
        chain = await client.a2a.run_chain("article_read", {"url": "https://example.com"})

asyncio.run(main())

PyPI： pypi.org/project/agenttools-client · デモ： examples/sdk_demo.py

オプション B — curl（任意の言語）

# Plan (no auth)
curl -X POST https://api.toolsforagents.tools/v1/advisor \
  -H "Content-Type: application/json" \
  -d '{"goal":"Extract markdown from example.com"}'

# Register (no email)
curl -X POST https://api.toolsforagents.tools/v1/register \
  -H "Content-Type: application/json" -d '{}'
# → save api_key from response

# Extract
curl -X POST https://api.toolsforagents.tools/v1/extract \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","format":"markdown"}'

オプション C — MCP（Cursor / Claude Desktop）

{
  "mcpServers": {
    "tools-for-agents": {
      "type": "streamable-http",
      "url": "https://api.toolsforagents.tools/mcp",
      "headers": { "Authorization": "Bearer sk_live_YOUR_KEY" }
    }
  }
}

設定をコピー＆ペースト：mcp-configs/ · ガイド：docs/MCP_QUICKSTART.md

オプション C — このリポジトリをクローン

git clone https://github.com/max124vip-dev/tools-for-agents.git
cd tools-for-agents
pip install -e ./agenttools_client
python examples/sdk_demo.py
python examples/advisor_flow.py "Research AI agent API best practices"

---

使用例

トピックを調査する（1回の呼び出し）

curl -X POST https://api.toolsforagents.tools/v1/agent/research \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"query":"solid-state battery news 2025","max_results":5}'

ツールチェーンを実行する（PDF → 要約）

curl -X POST https://api.toolsforagents.tools/v1/chains/run \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"chain_id":"pdf_summary","inputs":{"url":"https://example.com/report.pdf"}}'

A2A — リモートエージェントのスキルに委任する

curl -X POST https://api.toolsforagents.tools/a2a/v1/skills/youtube-summary/invoke \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"input":{"url":"https://www.youtube.com/watch?v=..."}}'

422 発生時の自己修復（SDK）

# Wrong body → SDK fetches /v1/tools/{tool}/examples and retries once
await client.json("POST", "/v1/confidence/estimate", json={})

その他：examples/ · 400 件以上の API 使用例：GET /v1/tools/examples/index

---

提供内容

レイヤー	説明
Agent Advisor	目標 → ワークフロー、信頼度、コスト、代替案（0 ユニット）
100+ REST tools	Web、PDF、OCR、検索、RAG、信頼性、暗号資産、検証…
28 tool chains	pdf_summary、youtube_summary、article_read、research_with_confidence…
13 A2A skills	取り込み、調査、ミッション、チェーンをリモートエージェントに委任
98 MCP tools	Cursor、Claude Desktop、Smithery — カタログ
Python SDK	自動認証 · 422 修復 · 5xx 再試行 · PyPI
Commons memory	エージェントの学習内容を共有 — POST /v1/commons/recall（公開読み取り）
CRP Discovery	Quality Capability Discovery — POST /v1/crp/resolve（無料）→ 実行 → フィードバック
x402 payments	USDC で呼び出しごとに支払い — アカウント不要（ドキュメント）

無料枠： 1 日あたり 5,000 リクエスト · 1 分あたり 120 リクエスト · 月あたり 500 GPU ユニット · 即時登録

実測レイテンシ（p50）： ドライラン ~450 ms · 登録 ~700 ms · アドバイザー ~600 ms

---

インテグレーション

プロトコル	エントリーポイント	最適な用途
REST + OpenAPI	api.toolsforagents.tools/docs	あらゆる HTTP クライアント
Python SDK	pip install agenttools-client	Python エージェントおよびスクリプト
MCP	api.toolsforagents.tools/mcp	IDE エージェント
A2A	/.well-known/agent-card.json	マルチエージェントオーケストレーター
llms.txt	toolsforagents.tools/llms.txt	LLM クローラー

---

ドキュメント

ドキュメント	説明
Complete API Guide	エージェント必読 — 422 の発生を防ぎ、チェーンと SDK を解説
CRP Spec v0	Quality Capability Discovery — 解決、フィードバック、来歴
CRP Roadmap	実装フェーズ 0–7
Capability Taxonomy	31 個の安定したケイパビリティ ID
Agent Passport Spec	外部エージェントの ID
MCP Quick Start	Cursor、Claude、Windsurf の設定
A2A Remote Agent	13 個のスキルと呼び出し例
Quickstart	人向けの概要
x402 wallet payments	サインアップ不要の呼び出しごとの支払い
Architecture	システムの概要設計
Registries (Smithery)	MCP カタログの公開

機械可読なディスカバリー：

リソース	URL
エージェント用プレイブック	GET https://api.toolsforagents.tools/v1/onboarding
ツールインデックス	GET https://api.toolsforagents.tools/.well-known/tool-index.json
使用例インデックス	GET https://api.toolsforagents.tools/v1/tools/examples/index
Agent Card（A2A）	GET https://api.toolsforagents.tools/.well-known/agent-card.json
CRP の解決	POST https://api.toolsforagents.tools/v1/crp/resolve
CRP ケイパビリティ	GET https://api.toolsforagents.tools/v1/crp/capabilities

---

リポジトリの内容

これは公開インテグレーションリポジトリです。ドキュメント、SDK、サンプル、エージェントマニフェストが含まれています。

含まれるもの	サーバー上でホストされているもの（リポジトリには含まれません）
agenttools_client/ — Python SDK	API サーバーの全ソースコード
examples/ — 実行可能なスクリプト	管理・請求の内部機能
agent/ — llms.txt と agent.txt	本番インフラストラクチャ
docs/ · mcp-configs/	独自のツール実装

ライブ API と連携するものであり、このリポジトリはセルフホスト可能なクローンではありません。

---

サポート

• ウェブサイト： toolsforagents.tools
• Telegram： @MaxVip124 — サポート、パートナーシップ
• 料金： toolsforagents.tools/pricing

---

ライセンス

ドキュメントとサンプルについては、LICENSE をご覧ください。
ホスト型 API api.toolsforagents.tools は商用サービスです。

---

API キーを人間に尋ねるのではなく、行動するエージェントのために構築されています。

ウェブサイト · オンボーディング · PyPI · llms.txt · Smithery