Decision layer for AI agents β plan workflows, execute 100+ tools, and delegate multi-step missions.
Not a flat API catalog. An orchestration platform built for autonomous agents.
What Β· Who Β· How Β· Quick start Β· Examples Β· Integrations Β· Docs
--- ## What is this? **Tools for Agents** is a hosted API platform that gives AI agents **real-world capabilities**: read websites, search the web, extract PDFs, run OCR, build RAG pipelines, verify facts, and execute **pre-built tool chains** β all through machine-readable REST, MCP, and A2A interfaces. Instead of guessing which of 100 endpoints to call, agents start with the **Agent Advisor**: describe a goal, get a workflow plan, cost estimate, and confidence score β then invoke tools with copy-paste examples that prevent validation errors. | You get | Instead of | |---------|------------| | `POST /v1/advisor` β plan + alternatives | Manually picking from 100 endpoints | | `GET /v1/tools/{tool}/examples` β exact JSON bodies | Trial-and-error 422 errors | | `POST /v1/chains/run` β multi-step pipelines | Wiring 5 tools yourself | | `POST /a2a/v1/skills/.../invoke` β delegate to remote agent | Low-level REST for every step | | `pip install agenttools-client` β self-healing SDK | Raw httpx + custom retry logic | **Live service:** [toolsforagents.tools](https://toolsforagents.tools) Β· API: [api.toolsforagents.tools](https://api.toolsforagents.tools/docs) --- ## Who is it for? | Audience | Use case | |----------|----------| | **Autonomous AI agents** | Self-register, plan with Advisor, invoke tools β no human in the loop | | **Agent builders** (LangChain, CrewAI, custom orchestrators) | REST + Python SDK + tool chains | | **IDE agents** (Cursor, Claude Desktop, Windsurf) | Remote MCP at `/mcp` β [configs](https://github.com/max124vip-dev/tools-for-agents/blob/HEAD/mcp-configs/) | | **Multi-agent systems** | A2A Agent Card + 13 skills β delegate research, ingest, missions | | **Developers prototyping agents** | Free tier: 5,000 req/day, instant API key, Swagger UI | > **Critical rule for agents:** never ask a human for an API key. > Register programmatically: `POST /v1/register` with body `{}`. --- ## How it works ``` ββββββββββββββββ 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 ``` **Typical agent loop:** 1. `GET /v1/onboarding` β read the playbook 2. `POST /v1/advisor` β plan before acting (0 units) 3. `POST /v1/dry-run` β probe URL cost/JS (~450 ms, 0 units) 4. `POST /v1/register {}` β get API key (no email) 5. `GET /v1/tools/{tool}/examples` β copy exact request body 6. Invoke tool Β· or `POST /v1/chains/run` Β· or A2A skill --- ## Quick start ### Option A β Python SDK (recommended) ```bash pip install agenttools-client ``` ```python 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](https://pypi.org/project/agenttools-client/) Β· Demo: [examples/sdk_demo.py](https://github.com/max124vip-dev/tools-for-agents/blob/HEAD/examples/sdk_demo.py) ### Option B β curl (any language) ```bash # 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"}' ``` ### Option C β MCP (Cursor / Claude Desktop) ```json { "mcpServers": { "tools-for-agents": { "type": "streamable-http", "url": "https://api.toolsforagents.tools/mcp", "headers": { "Authorization": "Bearer sk_live_YOUR_KEY" } } } } ``` Copy-paste configs: [mcp-configs/](https://github.com/max124vip-dev/tools-for-agents/blob/HEAD/mcp-configs/) Β· Guide: [docs/MCP_QUICKSTART.md](https://github.com/max124vip-dev/tools-for-agents/blob/HEAD/docs/MCP_QUICKSTART.md) ### Option C β Clone this repo ```bash 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" ``` --- ## Examples ### Research a topic (one call) ```bash 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}' ``` ### Run a tool chain (PDF β summary) ```bash 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 β delegate to remote agent skill ```bash 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=..."}}' ``` ### Self-healing on 422 (SDK) ```python # Wrong body β SDK fetches /v1/tools/{tool}/examples and retries once await client.json("POST", "/v1/confidence/estimate", json={}) ``` More: [examples/](https://github.com/max124vip-dev/tools-for-agents/blob/HEAD/examples/) Β· 400+ API examples: `GET /v1/tools/examples/index` --- ## What you get | Layer | Description | |-------|-------------| | **Agent Advisor** | Goal β workflow, confidence, cost, alternatives (0 units) | | **100+ REST tools** | Web, PDF, OCR, search, RAG, trust, crypto, validationβ¦ | | **28 tool chains** | `pdf_summary`, `youtube_summary`, `article_read`, `research_with_confidence`β¦ | | **13 A2A skills** | Delegate ingest, research, missions, chains to remote agent | | **98 MCP tools** | Cursor, Claude Desktop, Smithery β [catalog](https://smithery.ai/servers/max124vip/toolsforagents) | | **Python SDK** | Auto auth Β· 422 heal Β· 5xx retry Β· [PyPI](https://pypi.org/project/agenttools-client/) | | **Commons memory** | Shared agent learnings β `POST /v1/commons/recall` (public read) | | **CRP Discovery** | Quality Capability Discovery β `POST /v1/crp/resolve` (free) β execute β feedback | | **x402 payments** | Pay per call with USDC β no account ([docs](https://github.com/max124vip-dev/tools-for-agents/blob/HEAD/docs/X402.md)) | **Free tier:** 5,000 requests/day Β· 120/min Β· 500 GPU units/month Β· instant register **Live latency (p50):** dry-run ~450 ms Β· register ~700 ms Β· advisor ~600 ms --- ## Integrations | Protocol | Entry point | Best for | |----------|-------------|----------| | **REST + OpenAPI** | [api.toolsforagents.tools/docs](https://api.toolsforagents.tools/docs) | Any HTTP client | | **Python SDK** | `pip install agenttools-client` | Python agents & scripts | | **MCP** | [api.toolsforagents.tools/mcp](https://api.toolsforagents.tools/mcp) | IDE agents | | **A2A** | [/.well-known/agent-card.json](https://api.toolsforagents.tools/.well-known/agent-card.json) | Multi-agent orchestrators | | **llms.txt** | [toolsforagents.tools/llms.txt](https://toolsforagents.tools/llms.txt) | LLM crawlers | --- ## Documentation | Doc | Description | |-----|-------------| | [Complete API Guide](https://github.com/max124vip-dev/tools-for-agents/blob/HEAD/docs/AGENT_API_GUIDE.md) | Mandatory reading for agents β prevents 422, covers chains & SDK | | [CRP Spec v0](https://github.com/max124vip-dev/tools-for-agents/blob/HEAD/docs/CRP_SPEC_v0.md) | Quality Capability Discovery β resolve, feedback, provenance | | [CRP Roadmap](https://github.com/max124vip-dev/tools-for-agents/blob/HEAD/docs/CRP_ROADMAP.md) | Implementation phases 0β7 | | [Capability Taxonomy](https://github.com/max124vip-dev/tools-for-agents/blob/HEAD/docs/CAPABILITY_TAXONOMY_v0.md) | 31 stable capability IDs | | [Agent Passport Spec](https://github.com/max124vip-dev/tools-for-agents/blob/HEAD/docs/AGENT_PASSPORT_SPEC_v0.md) | External agent identity | | [MCP Quick Start](https://github.com/max124vip-dev/tools-for-agents/blob/HEAD/docs/MCP_QUICKSTART.md) | Cursor, Claude, Windsurf configs | | [A2A Remote Agent](https://github.com/max124vip-dev/tools-for-agents/blob/HEAD/docs/A2A_REMOTE_AGENT.md) | 13 skills + invoke examples | | [Quickstart](https://github.com/max124vip-dev/tools-for-agents/blob/HEAD/docs/QUICKSTART.md) | Human-friendly overview | | [x402 wallet payments](https://github.com/max124vip-dev/tools-for-agents/blob/HEAD/docs/X402.md) | Pay-per-call without signup | | [Architecture](https://github.com/max124vip-dev/tools-for-agents/blob/HEAD/docs/ARCHITECTURE.md) | High-level system design | | [Registries (Smithery)](https://github.com/max124vip-dev/tools-for-agents/blob/HEAD/REGISTRIES.md) | MCP catalog publishing | **Machine-readable discovery:** | Resource | URL | |----------|-----| | Agent playbook | `GET https://api.toolsforagents.tools/v1/onboarding` | | Tool index | `GET https://api.toolsforagents.tools/.well-known/tool-index.json` | | Examples index | `GET https://api.toolsforagents.tools/v1/tools/examples/index` | | Agent Card (A2A) | `GET https://api.toolsforagents.tools/.well-known/agent-card.json` | | CRP resolve | `POST https://api.toolsforagents.tools/v1/crp/resolve` | | CRP capabilities | `GET https://api.toolsforagents.tools/v1/crp/capabilities` | --- ## Repository contents This is a **public integration repository** β docs, SDK, examples, and agent manifests. | Included | Hosted on our servers (not in repo) | |----------|-------------------------------------| | [agenttools_client/](https://github.com/max124vip-dev/tools-for-agents/blob/HEAD/agenttools_client/) β Python SDK | Full API server source | | [examples/](https://github.com/max124vip-dev/tools-for-agents/blob/HEAD/examples/) β runnable scripts | Admin & billing internals | | [agent/](https://github.com/max124vip-dev/tools-for-agents/blob/HEAD/agent/) β llms.txt & agent.txt | Production infrastructure | | [docs/](https://github.com/max124vip-dev/tools-for-agents/blob/HEAD/docs/) Β· [mcp-configs/](https://github.com/max124vip-dev/tools-for-agents/blob/HEAD/mcp-configs/) | Proprietary tool implementations | You **integrate** with the live API β this repo is not a self-hostable clone. --- ## Support - **Website:** [toolsforagents.tools](https://toolsforagents.tools) - **Telegram:** [@MaxVip124](https://t.me/MaxVip124) β support, partnerships - **Pricing:** [toolsforagents.tools/pricing](https://toolsforagents.tools/pricing) --- ## License Documentation and examples: see [LICENSE](https://github.com/max124vip-dev/tools-for-agents/blob/HEAD/LICENSE). The hosted API at `api.toolsforagents.tools` is a commercial service. ---
Built for agents that act β not agents that ask humans for API keys.
Website Β·
Onboarding Β·
PyPI Β·
llms.txt Β·
Smithery