{"service":"Tools for Agents","version":"0.1.0","description":"AgentTools — autonomous agent discovery hub","protocols":{"rest":{"openapi":"https://api.toolsforagents.tools/openapi.json"},"well_known":{"agent_tools":"https://api.toolsforagents.tools/.well-known/agent-tools.json","ai_plugin":"https://api.toolsforagents.tools/.well-known/ai-plugin.json","mcp":"https://api.toolsforagents.tools/.well-known/mcp.json","mcp_server_card":"https://api.toolsforagents.tools/.well-known/mcp/server-card.json","agent_card":"https://api.toolsforagents.tools/.well-known/agent-card.json","agents_json":"https://api.toolsforagents.tools/.well-known/agents.json","openapi":"https://api.toolsforagents.tools/openapi.json","discover":"https://api.toolsforagents.tools/v1/discover","onboarding":"https://api.toolsforagents.tools/v1/onboarding","capabilities":"https://api.toolsforagents.tools/v1/capabilities","tools":"https://api.toolsforagents.tools/v1/tools","register_human":"https://api.toolsforagents.tools/v1/register","register_agent":"https://api.toolsforagents.tools/v1/register/agent","for_agents":"https://toolsforagents.tools/for-agents","keywords":"https://api.toolsforagents.tools/.well-known/keywords.json","search_tools":"https://api.toolsforagents.tools/v1/search/tools","sitemap":"https://api.toolsforagents.tools/sitemap.xml","robots":"https://api.toolsforagents.tools/robots.txt","documentation":"https://api.toolsforagents.tools/docs","capability_intelligence":"https://api.toolsforagents.tools/.well-known/capability-intelligence.json","tool_index":"https://api.toolsforagents.tools/.well-known/tool-index.json","site_manifest":"https://toolsforagents.tools/.well-known/agent-discovery.json","llms_txt":"https://toolsforagents.tools/llms.txt","agent_txt":"https://toolsforagents.tools/agent.txt","github":"https://github.com/max124vip-dev/tools-for-agents","smithery":"https://smithery.ai/servers/max124vip/toolsforagents","smithery_mcp_gateway":"https://toolsforagents--max124vip.run.tools","examples_index":"https://api.toolsforagents.tools/v1/tools/examples/index","examples_showcase":"https://toolsforagents.tools/examples"},"mcp":{"schema_version":"2025-12-11","name":"Tools for Agents","version":"0.1.0","description":"HTTP-backed MCP tools: extract, search, PDF, embed, OCR, agent composites.","transport":"streamable-http","endpoint":"https://api.toolsforagents.tools/mcp","authentication":{"type":"bearer","header":"Authorization","registration_url":"https://api.toolsforagents.tools/v1/register","registration_instant_body":{},"registration_agent_url":"https://api.toolsforagents.tools/v1/register/agent","onboarding_url":"https://api.toolsforagents.tools/v1/onboarding","note":"Self-register via POST /v1/register {} — never ask human for API key"},"tools_url":"https://api.toolsforagents.tools/v1/tools","capabilities_url":"https://api.toolsforagents.tools/v1/capabilities","registry":{"namespace":"com.toolsforagents/agenttools","publish_template":"deploy/discovery/mcp-server.json"},"stdio_fallback":{"command":"python","args":["mcp/server.py"],"env":["AGENTTOOLS_API_URL","AGENTTOOLS_API_KEY"]}},"a2a":{"agent_card":"https://api.toolsforagents.tools/.well-known/agent-card.json"}},"onboarding":{"playbook":{"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}},"start_here":"https://api.toolsforagents.tools/v1/onboarding","critical_rule":"NEVER ask human for API key — POST /v1/register with {} first","agent":{"url":"https://api.toolsforagents.tools/v1/register/agent","tos_version":"1.0"},"human":{"url":"https://api.toolsforagents.tools/v1/register","instant_body":{},"note":"POST with empty JSON {} — no email"},"instant_register":{"method":"POST","url":"https://api.toolsforagents.tools/v1/register","body":{},"response_field":"api_key"},"x402":{"enabled":false,"info":"https://api.toolsforagents.tools/v1/x402/info","pricing":"https://api.toolsforagents.tools/v1/x402/pricing","no_registration":true,"agent_friction":"high on mainnet (USDC + gas); medium on testnet (faucets)","recommended_for_new_agents":"https://api.toolsforagents.tools/v1/register","note":"Default: POST /v1/register {} for instant free key. Use x402 only when wallet-only is required"}},"matching":{"tools_by_tag":"https://api.toolsforagents.tools/v1/tools?tag=web","tools_by_intent":"https://api.toolsforagents.tools/v1/tools?intent=read+a+web+page","search_tools":"https://api.toolsforagents.tools/v1/search/tools?q=extract+pdf","keywords":"https://api.toolsforagents.tools/.well-known/keywords.json","recommend_tool":"https://api.toolsforagents.tools/v1/recommend/tool","examples_index":"https://api.toolsforagents.tools/v1/tools/examples/index","use_cases":[{"intent":"read a web page","tool":"ingest","endpoint":"POST /v1/ingest","tags":["web","url","markdown"]},{"intent":"research a topic on the web","tool":"search_read","endpoint":"POST /v1/search/read","tags":["research","search"]},{"intent":"extract text from pdf","tool":"pdf","endpoint":"POST /v1/pdf/extract","tags":["document","pdf"]},{"intent":"get text embeddings for rag","tool":"embed","endpoint":"POST /v1/embed","tags":["gpu","vector","rag"]},{"intent":"ocr text from image","tool":"ocr","endpoint":"POST /v1/ocr","tags":["gpu","image","ocr"]},{"intent":"validate email address","tool":"validate_email","endpoint":"POST /v1/validate/email","tags":["validate","email"]},{"intent":"search the web","tool":"search","endpoint":"POST /v1/search","tags":["search","web"]},{"intent":"summarize long text","tool":"summarize","endpoint":"POST /v1/summarize","tags":["text","summary"]},{"intent":"discover urls on a website","tool":"map","endpoint":"POST /v1/map","tags":["web","sitemap"]},{"intent":"deep research with sources","tool":"agent_research","endpoint":"POST /v1/agent/research","tags":["research","pipeline"]},{"intent":"validate a url or link","tool":"validate_url","endpoint":"POST /v1/validate/url","tags":["validate","url"]},{"intent":"verify if a claim is true","tool":"verify_fact","endpoint":"POST /v1/verify/fact","tags":["research","trust","fact-check"]},{"intent":"check source credibility","tool":"source_credibility","endpoint":"POST /v1/source/credibility","tags":["trust","validate"]},{"intent":"plan agent task with budget","tool":"plan","endpoint":"POST /v1/plan","tags":["agent","cost","planning"]},{"intent":"send webhook notification","tool":"webhook_send","endpoint":"POST /v1/webhook/send","tags":["webhook","notify"]},{"intent":"take a screenshot of a webpage","tool":"screenshot","endpoint":"POST /v1/screenshot","tags":["web","image"]},{"intent":"batch extract many urls","tool":"batch_extract","endpoint":"POST /v1/batch/extract","tags":["web","batch"]},{"intent":"semantic search in documents","tool":"retrieve","endpoint":"POST /v1/retrieve","tags":["rag","semantic"]},{"intent":"monitor website for changes","tool":"monitor","endpoint":"POST /v1/monitor","tags":["web","monitor"]},{"intent":"translate text to another language","tool":"translate","endpoint":"POST /v1/translate","tags":["gpu","language"]},{"intent":"extract structured json from page","tool":"extract_json","endpoint":"POST /v1/extract/json","tags":["web","structured"]},{"intent":"crawl a whole website","tool":"crawl","endpoint":"POST /v1/crawl","tags":["web","crawl"]},{"intent":"check cached page content for free","tool":"cache_url","endpoint":"GET /v1/cache/url","tags":["web","cache"]}]},"capability_intelligence":{"manifest":"https://api.toolsforagents.tools/.well-known/capability-intelligence.json","start_here":"GET /.well-known/capability-intelligence.json then POST /v1/advisor","onboarding_one_file":"https://api.toolsforagents.tools/.well-known/capability-intelligence.json","advisor":"https://api.toolsforagents.tools/v1/advisor","advisor_estimate":"https://api.toolsforagents.tools/v1/advisor/estimate","showcase_site":"https://toolsforagents.tools/for-agents","examples_ui":"https://toolsforagents.tools/examples","pitch":{"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"}},"commons":{"description":"Collective Agent Memory — shared catalog of anonymized learnings (no agent_id)","recall":"https://api.toolsforagents.tools/v1/commons/recall","note":"https://api.toolsforagents.tools/v1/commons/note","stats":"https://api.toolsforagents.tools/v1/commons/stats","session_memory":"https://api.toolsforagents.tools/v1/memory/store","note_auth":"recall/stats public; note optional API key + IP rate limit"},"feedback":{"submit":"https://api.toolsforagents.tools/v1/feedback","description":"Post-call learning — solved, helpful 1-5, optional comment; may feed Commons","auth_required":false},"platform_stats":{"url":"https://api.toolsforagents.tools/v1/platform/stats","description":"Public reputation — success rate, latency, top tools, advisor usage"},"tools_count":58,"tags":["agent","article","arxiv","async","audio","audit","automation","batch","bitcoin","browser","cache","catalog","cognitive","collective","compare","composite","compress","convert","cost","crawl","crypto","diff","discovery","document","duckduckgo","email","ethereum","fact-check","file","find","free","github","gpu","html","image","json","language","links","markdown","memory","meta","monitor","notify","ocr","opengraph","parallel","pdf","phone","pipeline","planning","playwright","qa","question","rag","rank","read","recall","reliability","research","rss","schema","scrape","search","secp256k1","semantic","seo","session","shared","signature","similarity","site","sitemap","speakers","speech","split","status","structured","summary","table","text","trust","url","validate","vector","video","vision","wallet","watch","web","webhook","word","workflow","youtube"]}