{"name":"AgentWeb","version":"1.2.0","tagline":"The substrate of the agent web","description":"AgentWeb is the agent-native registry. 11M+ businesses across 233 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","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":13541504,"countries":195},"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. ?format=short returns the compact shorthand. Sub-50ms global, ~700B compact, no API key.","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'. Always public, always sub-50ms.","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.1.3","install":"npm install -g agentweb-mcp","config":{"command":"npx","args":["-y","agentweb-mcp"],"env":{"AGENTWEB_API_KEY":"your_key_here"}},"tools":["search_businesses","get_business","agentweb_health","agentweb_leaderboard","contribute_business","report_business"],"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"}