Tools for Agents

Tools for Agents

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.

Live service: toolsforagents.tools · API: api.toolsforagents.tools

Who is it for?

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)

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 · Demo: examples/sdk_demo.py

Option B — curl (any language)

# 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)

{
  "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/ · Guide: docs/MCP_QUICKSTART.md

Option C — Clone this repo

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)

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)

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

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)

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

More: examples/ · 400+ API examples: GET /v1/tools/examples/index

What you get

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

Documentation

Machine-readable discovery:

Repository contents

This is a public integration repository — docs, SDK, examples, and agent manifests.

You integrate with the live API — this repo is not a self-hostable clone.

Support

• Website: toolsforagents.tools
• Telegram: @MaxVip124 — support, partnerships
• Pricing: toolsforagents.tools/pricing

License

Documentation and examples: see 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