Documentation

API base: https://api.toolsforagents.tools. Autonomous agents: read the full guide first — it prevents 422 errors and lists features agents often miss (Swagger, cache, usage, examples).

Complete API Guide

Mandatory reading for AI agents: registration, examples rule, workflow, cognitive tools, limits, cache, errors.

Read Full Guide →

MCP Quick Start

44 MCP tools · copy-paste configs for Cursor, Claude Desktop, Windsurf, Cline. No npm required.

MCP landing page → GitHub configs →

Interactive Swagger

OpenAPI — 58+ REST tools. Try every endpoint in browser.

Open /docs →

Python SDK

Official client on PyPI — auto auth, 422 self-heal, 5xx retry, A2A helpers.

pip install agenttools-client

PyPI → Source →

400+ Examples

Copy-paste bodies per tool. Call GET /v1/tools/{tool}/examples before POST.

Browse examples →

Free tier (growth phase): 5,000 requests/day · 120 req/min · 500 GPU units/month · instant register with POST /v1/register {}

Machine-readable (for agents)

Resource	URL
Onboarding playbook	`GET /v1/onboarding`
Examples index	`GET /v1/tools/examples/index`
Tool index JSON	`GET /.well-known/tool-index.json`
llms.txt	/llms.txt
agent.txt	/agent.txt
GitHub docs	github.com/max124vip-dev/tools-for-agents
Python SDK (PyPI)	pypi.org/project/agenttools-client

Python SDK (3 lines)

pip install agenttools-client

python -c "
import asyncio
from agenttools_client import AsyncAgentToolsClient

async def main():
    async with AsyncAgentToolsClient() as c:
        print(await c.advisor('Extract markdown from example.com'))
        print(await c.extract('https://example.com'))
asyncio.run(main())
"

Package: pypi.org/project/agenttools-client · v0.2.0 · full demo

Quickstart curl

1. Register (~700 ms)

curl -X POST https://api.toolsforagents.tools/v1/register \
  -H "Content-Type: application/json" -d '{}'

2. Check usage

curl https://api.toolsforagents.tools/v1/account \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

3. Dry-run before extract (~450 ms, 0 units)

curl -X POST https://api.toolsforagents.tools/v1/dry-run \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","probe_depth":"peek"}'

4. Cache check (0 units on hit)

curl "https://api.toolsforagents.tools/v1/cache/url?url=https://example.com" \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

5. Extract

curl -X POST https://api.toolsforagents.tools/v1/extract \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","mode":"fast"}'

Account & monitoring

GET /v1/account — limits + usage in one JSON
GET /v1/usage — quota counters
/dashboard — human UI with API key
Header X-Response-Time on every response

Errors

401 — POST /v1/register {}, retry (never ask human)
422 — GET /v1/tools/{tool}/examples, copy exact body
429 — rate limit 120/min on free; wait Retry-After
502/503 — retry after Retry-After; SDK does this automatically

Full Agent API Guide Swagger