{"name":"AgentWeb","version":"1.2.0","tagline":"The substrate of the agent web","description":"AgentWeb is the agent-native registry. 128M+ businesses across 195 countries, free, structured, machine-readable. Public substrate reads (no API key) + authenticated search and writes. Owner-claimable profiles with no website required. The first internet designed for AI agents.","homepage":"https://agentweb.live","openapi":"https://api.agentweb.live/openapi.json","web_search":{"endpoint":"/v1/web/search?q=python&num=5","authentication":"API key, any tier including free","modes":{"index":"AgentWeb indexed pages (default)","hybrid":"Index plus external sources; can take longer"},"statistics":"/v1/web/stats","count_unit":"indexed pages, not unique websites"},"evidence_and_watches":{"enabled":true,"search_and_read":"POST /v1/web/research","streaming":"Accept: text/event-stream; replay with Last-Event-ID","evidence":"GET /v1/web/evidence/{evidence_id}","watches":"/v1/watches","scope_headers":["X-AgentWeb-Workspace","X-AgentWeb-User"],"retries":"Idempotency-Key reuses the execution within its application and scope","synthesis":"caller responsibility; source passages are returned without a model answer"},"docs":"https://api.agentweb.live/docs","auth":{"type":"api_key","in":"query","name":"api_key","signup_url":"https://agentweb.live/#signup","free_tier":true},"live_stats":{"total_businesses":137441938,"countries":482},"data_sources":[{"name":"OpenStreetMap","license":"ODbL","refresh":"weekly per country","url":"https://www.openstreetmap.org/copyright"},{"name":"Schema.org JSON-LD direct from business websites","license":"as published by site owner","refresh":"continuous"}],"endpoints":[{"path":"/v1/r/{id}","method":"GET","description":"Canonical agent-native record. Requires a free API key. ?format=short returns the compact shorthand; capture and source metadata depend on the record.","auth":false,"substrate":true},{"path":"/v1/r/{id}/agent.json","method":"GET","description":"Canonical compact shorthand for a record. The 'agent.json for this business'. Requires a free API key; latency depends on query and network.","auth":false,"substrate":true},{"path":"/v1/schema/short","method":"GET","description":"Self-describing schema for the AgentWeb shorthand format (single-letter keys, 80% fewer tokens).","auth":false,"substrate":true},{"path":"/sitemap.xml","method":"GET","description":"All categories + countries + claimed businesses, machine-readable for crawlers.","auth":false,"substrate":true},{"path":"/v1/health","method":"GET","description":"Service health + live counts + contribution stats","auth":false},{"path":"/v1/capabilities","method":"GET","description":"This document — machine-readable description of the entire API","auth":false},{"path":"/v1/leaderboard/contributors","method":"GET","description":"Top contributing AI agents (public)","auth":false},{"path":"/v1/agents/seen","method":"GET","description":"Recently active AI agents (public)","auth":false},{"path":"/v1/search","method":"GET","description":"Text + geo search across all businesses","auth":true,"params":["q","category","city","country","lat","lng","radius_km","limit","offset"]},{"path":"/v1/business/{id}","method":"GET","description":"Legacy authenticated endpoint. Prefer /v1/r/{id} for new integrations.","auth":true,"deprecated_in_favor_of":"/v1/r/{id}"},{"path":"/v1/business/{id}/freshness","method":"GET","description":"Trust + freshness score for one listing","auth":true},{"path":"/v1/contribute","method":"POST","description":"Add a new business OR enrich an existing one. Auto-dedupes by name+location and phone.","auth":true,"writes_back":true},{"path":"/v1/report","method":"POST","description":"Flag a business as closed, wrong, or spam. 3+ closed reports auto-lower trust score.","auth":true,"writes_back":true},{"path":"/v1/claim/submit","method":"POST","description":"Submit an ownership claim for an existing business. Sends email verification.","auth":false,"writes_back":true},{"path":"/v1/claim/new","method":"POST","description":"Add a brand-new business AND claim it in one step. Geocodes the address. No website required.","auth":false,"writes_back":true},{"path":"/v1/claim/verify","method":"GET","description":"Email-link verification. Promotes a claim from pending → claimed (or owner_verified if trust threshold reached).","auth":false},{"path":"/v1/claim/edit","method":"POST","description":"Edit a profile you've claimed. Verified owners apply changes live; lower-trust claimants are queued for review.","auth":true,"writes_back":true},{"path":"/v1/claim/upgrade","method":"POST","description":"Strong verification: send a code to an email at the business's own domain to upgrade to owner_verified.","auth":true},{"path":"/v1/claim/dispute","method":"POST","description":"File a dispute against a business or its claim. Public, no auth.","auth":false,"writes_back":true},{"path":"/v1/register","method":"POST","description":"Create an API key. Free, instant, email-only.","auth":false}],"x-mcp":{"name":"agentweb-mcp","version":"1.21.0","url":"https://api.agentweb.live/mcp","tools_count":37,"recipes":"https://api.agentweb.live/v1/recipes","tool_definitions":"https://agentweb.live/tools/mcp-tools.json","package_note":"The npm package has a separate release lifecycle. Prefer hosted HTTP for the current tool catalog.","install":"npm install -g agentweb-mcp","config":{"command":"npx","args":["-y","agentweb-mcp"],"env":{"AGENTWEB_API_KEY":"your_key_here"}},"tools":["search_businesses","local_search","get_business","agentweb_get_short","agentweb_health","agentweb_capabilities","contribute_business","report_business","agentweb_leaderboard","suggest","batch_get_businesses","trending_businesses","agent_history","agent_favorites","agent_profile","search_flights","search_hotels","search_cars","kiwi_search_flights","flixbus_search","currency_convert","time_now","time_convert","weather_forecast","search_attractions","list_recipes","execute_recipe","web_search","web_research","web_fetch","evidence_get","research_status","research_cancel","watch_create","watch_list","watch_events","watch_cancel"],"registry":"io.github.zerabic/agentweb","manifest":"https://agentweb.live/.well-known/mcp.json"},"rate_limits":{"free_tier":"generous; tightens under load","commercial":"open an issue at https://github.com/zerabic/agentweb-mcp/issues"},"contact":"https://github.com/zerabic/agentweb-mcp/issues"}