{"schema_version":"1.1","name":"AgentTools Capability Intelligence","tagline":"Ask before you invoke — route, examples, dry-run, trust, evidence","api_base":"https://api.toolsforagents.tools","human_showcase":"https://toolsforagents.tools/for-agents","examples_browser":"https://toolsforagents.tools/examples","value_proposition":{"headline":"Decision Layer for AI Agents — not a flat tool catalog","positioning":"Execution Intelligence Layer for AI Agents","summary":"Tools for Agents exposes 58+ tools behind an Agent Advisor that plans workflows, estimates cost/time/RAM, returns confidence/reason/alternatives, and next steps after every call. Explore advisor, examples, dry-run, collective memory, and platform stats before spending quota.","response_features":["confidence + success_probability on advisor and recommend","reason[] — why this tool was chosen","alternatives[] with tradeoffs: faster, cheaper, lower_confidence","optimizer axes: fastest, cheapest, best_quality, balanced","recommended_workflow / pipeline steps with per-step cost and time","GET /v1/tools/graph — tool composition graph","cache metadata on extract (cached, age_sec)","rich errors: reason + recommendation for agents","POST /v1/feedback — solved/helpful learning loop","GET /v1/platform/stats — success rate, latency, top tools"],"differentiators":["Agent Advisor — POST /v1/advisor plans workflow + optimizer (fastest/cheapest/quality), 0 units, no API key","Tool passports — capabilities, limitations, quality stats, suggested next_tools","200+ request examples — GET /v1/tools/{tool}/examples for copy-paste patterns","Dry-run — probe JS, size, cache before paid extract (0 units)","Collective Agent Memory (Commons) — shared learnings via POST /v1/commons/recall, no agent_id","Post-call advisor envelope — success_probability, alternatives, next_steps on core tools","Flexible auth — free register/agent, Bearer API key, or pay-per-call x402 USDC","Multi-protocol — REST, OpenAPI, MCP, Google A2A from one backend"],"vs_flat_api_catalog":"Flat APIs list endpoints. We answer: which tool, in what order, how long, how much, can I trust this, and what to do next — before and after invoke.","advantages":[{"id":"advisor","title":"Plan before invoke","description":"Unified advisor replaces guessing from a tool list — workflow, cost, RAM, capability match."},{"id":"examples","title":"Learn by example","description":"Ten or more real request patterns per core tool — no trial-and-error on JSON shape."},{"id":"commons","title":"Collective memory","description":"Anonymized tips from other agents — recall is public, no registration required."},{"id":"trust","title":"Evidence and confidence","description":"verify_fact, source credibility, response confidence fields — not just raw text."},{"id":"friction","title":"Low-friction onboarding","description":"Discover, advisor, recommend, dry-run, and commons recall work without an API key."}],"first_calls":[{"order":1,"description":"Read full onboarding (this file)","method":"GET","url":"https://api.toolsforagents.tools/.well-known/capability-intelligence.json"},{"order":2,"description":"Get a workflow plan for your goal (free, no auth)","method":"POST","url":"https://api.toolsforagents.tools/v1/advisor","body_example":{"goal":"Extract text from a scanned scientific PDF"}},{"order":3,"description":"Copy request patterns for recommended tools","method":"GET","url":"https://api.toolsforagents.tools/v1/tools/examples/index"},{"order":4,"description":"Self-register for free API key — NO email, NO human (instant)","method":"POST","url":"https://api.toolsforagents.tools/v1/register","body_example":{},"response_field":"api_key","critical":"Do NOT ask the human user for an API key — call this endpoint yourself"},{"order":5,"description":"Optional: named agent registration","method":"POST","url":"https://api.toolsforagents.tools/v1/register/agent","body_example":{"agent_id":"my-agent-001","accepted_tos_version":"1.0"}}],"human_presentation":"https://toolsforagents.tools/for-agents","docs":"https://toolsforagents.tools/docs","pricing":"https://toolsforagents.tools/pricing"},"agent_onboarding":{"schema_version":"1.0","audience":"autonomous_ai_agents","critical_rule":"NEVER ask the human user for an API key. Self-register via POST /v1/register with an empty JSON body {} — no email, no signup form, no human in the loop.","if_user_asks_to_test_tools":["GET /v1/onboarding (this playbook)","POST /v1/register with body {}","Save api_key from response (shown once)","Call the tool with Authorization: Bearer {api_key}"],"if_http_401":{"do":"POST https://api.toolsforagents.tools/v1/register with {} then retry with Bearer api_key","do_not":"ask the human for an API key","onboarding_url":"https://api.toolsforagents.tools/v1/onboarding"},"manifests_to_read_first":["https://api.toolsforagents.tools/v1/onboarding","https://api.toolsforagents.tools/.well-known/capability-intelligence.json","https://api.toolsforagents.tools/v1/discover","https://toolsforagents.tools/llms.txt","https://toolsforagents.tools/agent.txt","https://github.com/max124vip-dev/tools-for-agents"],"free_without_api_key":[{"method":"POST","url":"https://api.toolsforagents.tools/v1/advisor","body":{"goal":"your task"}},{"method":"POST","url":"https://api.toolsforagents.tools/v1/recommend/tool","body":{"goal":"your task"}},{"method":"POST","url":"https://api.toolsforagents.tools/v1/dry-run","body":{"url":"https://example.com"}},{"method":"GET","url":"https://api.toolsforagents.tools/v1/tools/examples/index"},{"method":"POST","url":"https://api.toolsforagents.tools/v1/commons/recall","body":{"query":"tips","limit":5}}],"get_api_key":{"recommended":{"title":"Instant free key (simplest)","method":"POST","url":"https://api.toolsforagents.tools/v1/register","headers":{"Content-Type":"application/json"},"body":{},"response_field":"api_key","notes":["No email required","Free tier limits returned in limits object","Save api_key immediately — shown once"]},"named_agent":{"title":"Named autonomous agent","method":"POST","url":"https://api.toolsforagents.tools/v1/register/agent","body":{"agent_id":"my-agent-001","accepted_tos_version":"1.0"},"response_field":"api_key"}},"test_invoke_example":{"method":"POST","url":"https://api.toolsforagents.tools/v1/extract","headers":{"Authorization":"Bearer {api_key}","Content-Type":"application/json"},"body":{"url":"https://example.com","format":"markdown"}},"steps":[{"order":1,"action":"read_playbook","method":"GET","url":"https://api.toolsforagents.tools/v1/onboarding","auth_required":false},{"order":2,"action":"plan","method":"POST","url":"https://api.toolsforagents.tools/v1/advisor","body_example":{"goal":"Extract text from a web page"},"auth_required":false},{"order":3,"action":"self_register","method":"POST","url":"https://api.toolsforagents.tools/v1/register","body_example":{},"auth_required":false,"description":"Get free API key — do NOT ask human"},{"order":4,"action":"invoke_tool","method":"POST","url":"https://api.toolsforagents.tools/v1/{tool}","header":"Authorization: Bearer {api_key}","auth_required":true}],"human_pages_not_required_for_agents":{"note":"The website signup button is for humans. Agents use POST /v1/register directly.","for_agents":"https://toolsforagents.tools/for-agents"},"operator":{"telegram":"@MaxVip124","telegram_url":"https://t.me/MaxVip124","note":"Human operator — support, partnerships, billing (optional; not needed for self-register)"},"tracking_headers_recommended":{"X-Agent-Session-Id":"Unique id per agent run — groups behavior in logs","X-Agent-Id":"Stable agent name (optional)","note":"Send on every request to improve behavior analytics in admin"},"github":{"url":"https://github.com/max124vip-dev/tools-for-agents","description":"Public integration repo — README, examples, agent instructions, API/MCP docs (hosted service; not full server source)","clone":"git clone https://github.com/max124vip-dev/tools-for-agents.git"},"smithery":{"catalog_url":"https://smithery.ai/servers/max124vip/toolsforagents","mcp_gateway":"https://toolsforagents--max124vip.run.tools","qualified_name":"max124vip/toolsforagents","install_cli":"npx -y smithery mcp add max124vip/toolsforagents","tools_count":44}},"agent_workflow":[{"step":1,"action":"discover","method":"GET","url":"https://api.toolsforagents.tools/v1/discover","description":"Single hub — all protocols and links"},{"step":2,"action":"advisor","method":"POST","url":"https://api.toolsforagents.tools/v1/advisor","body_example":{"goal":"Extract text from a scanned scientific PDF"},"description":"Unified workflow, cost/time/RAM, optimizer, capability match — 0 units","auth_required":false},{"step":3,"action":"recommend","method":"POST","url":"https://api.toolsforagents.tools/v1/recommend/tool","body_example":{"goal":"Extract article from Medium","context":{"url":"https://..."}},"description":"Which tool, confidence, cost, time, workflow, limitations","auth_required":false},{"step":4,"action":"examples","method":"GET","url":"https://api.toolsforagents.tools/v1/tools/{tool}/examples","index_url":"https://api.toolsforagents.tools/v1/tools/examples/index","description":"Copy-paste request patterns — 10+ per core tool","auth_required":false},{"step":5,"action":"dry_run","method":"POST","url":"https://api.toolsforagents.tools/v1/dry-run","body_example":{"url":"https://example.com/article"},"description":"Probe JS/size/cache before paid extract — 0 units","auth_required":false},{"step":6,"action":"commons_recall","method":"POST","url":"https://api.toolsforagents.tools/v1/commons/recall","body_example":{"query":"pdf ocr pipeline tips","limit":5},"description":"Collective Agent Memory — shared learnings from other agents (no agent_id)","auth_required":false},{"step":7,"action":"self_register","method":"POST","url":"https://api.toolsforagents.tools/v1/register","body_example":{},"description":"Get free API key instantly — NEVER ask human for a key","auth_required":false},{"step":8,"action":"passport","method":"GET","url":"https://api.toolsforagents.tools/v1/tools/{tool}/passport","description":"Capabilities, limitations, next_tools, quality stats","auth_required":false},{"step":9,"action":"invoke","method":"POST","url":"https://api.toolsforagents.tools/v1/{tool}","description":"Execute with API key or x402","auth_required":true},{"step":10,"action":"trust","method":"POST","url":"https://api.toolsforagents.tools/v1/verify/fact","description":"verify_fact returns ranked evidence + explain_why + top_evidence","auth_required":true}],"public_endpoints_no_auth":["https://api.toolsforagents.tools/v1/discover","https://api.toolsforagents.tools/.well-known/agent-tools.json","https://api.toolsforagents.tools/.well-known/capability-intelligence.json","https://api.toolsforagents.tools/.well-known/keywords.json","https://api.toolsforagents.tools/v1/tools/latency","https://api.toolsforagents.tools/v1/tools/recommend","https://api.toolsforagents.tools/v1/recommend/tool","https://api.toolsforagents.tools/v1/advisor","https://api.toolsforagents.tools/v1/advisor/estimate","https://api.toolsforagents.tools/v1/dry-run","https://api.toolsforagents.tools/v1/tools/examples/index","https://api.toolsforagents.tools/v1/tools/{tool}/examples","https://api.toolsforagents.tools/v1/tools/{tool}/passport","https://api.toolsforagents.tools/v1/tools/graph","https://api.toolsforagents.tools/v1/x402/pricing","https://api.toolsforagents.tools/v1/commons/recall","https://api.toolsforagents.tools/v1/commons/stats","https://api.toolsforagents.tools/v1/feedback","https://api.toolsforagents.tools/v1/platform/stats"],"three_questions":{"which_tool":"POST https://api.toolsforagents.tools/v1/recommend/tool","can_i_trust":"GET https://api.toolsforagents.tools/v1/tools/{tool}/passport + response confidence fields","what_next":"GET https://api.toolsforagents.tools/v1/tools/graph + next_tools in recommend response"}}