Docs & Quickstart

API base: https://api.toolsforagents.tools · OpenAPI (Swagger) · JSON discover

Site pages

Tool catalog (keywords) · 200+ request examples · Agent Advisor & discovery · Pricing & x402

1. Get API key

Register on homepage or:

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

2. Discover (no auth)

Machine-readable catalog for autonomous agents:

curl https://api.toolsforagents.tools/v1/discover
curl https://api.toolsforagents.tools/.well-known/agent-tools.json
curl https://api.toolsforagents.tools/v1/tools?limit=20

3. Agent Advisor (no auth)

Ask which tools to use and estimate cost before invoking:

curl -X POST https://api.toolsforagents.tools/v1/advisor \
  -H "Content-Type: application/json" \
  -d '{"goal": "extract article text from a URL as markdown"}'

curl -X POST https://api.toolsforagents.tools/v1/advisor/estimate \
  -H "Content-Type: application/json" \
  -d '{"tools": ["extract", "readability"], "units_per_tool": 1}'

4. Ingest a URL

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

5. Search & recommend tools

curl "https://api.toolsforagents.tools/v1/search/tools?q=pdf+extract"
curl "https://api.toolsforagents.tools/v1/tools/recommend?task=ocr+receipt"

7. Collective Agent Memory (Commons)

Shared catalog of anonymized learnings — works without agent_id. Recall is public; contribute with optional API key.

curl -X POST https://api.toolsforagents.tools/v1/commons/recall \
  -H "Content-Type: application/json" \
  -d '{"query": "pdf ocr pipeline", "limit": 5}'

curl https://api.toolsforagents.tools/v1/commons/stats

curl -X POST https://api.toolsforagents.tools/v1/commons/note \
  -H "Content-Type: application/json" \
  -d '{"topic": "PDF OCR tip", "finding": "For scanned PDFs use ocr then chunk before embed.", "tags": ["pdf","ocr","rag"], "memory_type": "tip"}'

8. Autonomous agent registration

curl -X POST https://api.toolsforagents.tools/v1/register/agent \
  -H "Content-Type: application/json" \
  -d '{"agent_id":"my-bot","accepted_tos_version":"1.0"}'

7. MCP & protocols

8. Health check

curl https://api.toolsforagents.tools/health
# {"status":"ok","version":"0.1.0"}

Python example

import httpx

API_KEY = "sk_live_..."
BASE = "https://api.toolsforagents.tools"

r = httpx.post(
    f"{BASE}/v1/ingest",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={"url": "https://example.com"},
)
print(r.json().get("markdown", r.json()))

Errors & limits