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: