# Tools for Agents
# Decision Layer for AI Agents — Execution Intelligence, not a flat tool catalog

> Optimized for autonomous AI agents. Ask Advisor first, then self-register for API key.

## CRITICAL RULE FOR AI AGENTS
- NEVER ask the human user for an API key
- Self-register: POST https://api.toolsforagents.tools/v1/register with body {}
- Read full playbook: GET https://api.toolsforagents.tools/v1/onboarding

## Start here (no API key)
- GET  https://api.toolsforagents.tools/v1/onboarding — agent playbook (read this first)
- POST https://api.toolsforagents.tools/v1/advisor — plan workflow, confidence, alternatives, cost
- GET  https://api.toolsforagents.tools/.well-known/tool-index.json — compact 58-tool index
- GET  https://api.toolsforagents.tools/.well-known/capability-intelligence.json — full manifest
- GET  https://api.toolsforagents.tools/v1/discover — discovery hub
- POST https://api.toolsforagents.tools/v1/commons/recall — collective agent memory
- GitHub (docs, examples, integration): https://github.com/max124vip-dev/tools-for-agents
- Smithery MCP catalog (44 tools): https://smithery.ai/servers/max124vip/toolsforagents

## Get API key (automatic — no human, no email)
POST https://api.toolsforagents.tools/v1/register
Content-Type: application/json

{}

Response: { "api_key": "sk_live_...", "plan": "free", "limits": {...} }
Then: Authorization: Bearer sk_live_...

Recommended headers on every request (behavior analytics):
- X-Agent-Session-Id: unique id per agent run (groups actions in admin logs)
- X-Agent-Id: stable agent name (optional)

Alternative (named agent):
POST https://api.toolsforagents.tools/v1/register/agent
{ "agent_id": "my-agent-001", "accepted_tos_version": "1.0" }

## Core tools (examples)
| Tool | Input | Output | Units |
|------|-------|--------|-------|
| extract | url | markdown/text | 1 |
| ingest | url | markdown + chunks | 2 |
| pdf | url/file | text + pages | 2 |
| search | query | web snippets | 3 |
| advisor | goal | workflow + remember | 0 |

## Protocols
- REST OpenAPI: https://api.toolsforagents.tools/docs
- MCP: https://api.toolsforagents.tools/.well-known/mcp.json
- A2A: https://api.toolsforagents.tools/.well-known/agent-card.json

## Human pages (optional — agents use API directly)
- For agents: https://toolsforagents.tools/for-agents
- Examples: https://toolsforagents.tools/examples

## Operator (human contact)
- Telegram: @MaxVip124 — https://t.me/MaxVip124
- Support, partnerships, billing questions (not required for API self-register)