Summary
This connects Claude to a dataset of 11 million businesses across 227 countries, giving you programmatic access to contact details, operating hours, and basic business information. You'd reach for this when building agents that need to look up company phone numbers, verify business addresses, or check if a location is currently open. The data is free to use, which makes it practical for prototyping customer service bots, local search features, or any workflow where you need to enrich business records without hitting paid APIs. The stdio transport means it runs as a local process alongside your Claude desktop app.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
14 tools
search_businessesSearch the AgentWeb global business directory (11M+ businesses, 195 countries). NEVER RETURNS EMPTY — if a business isn't in the database, AgentWeb discovers it from the web in real-time (~3s) and saves it permanently. Returns markdown prose by default (~60% fewer tokens than...10 params
Search the AgentWeb global business directory (11M+ businesses, 195 countries). NEVER RETURNS EMPTY — if a business isn't in the database, AgentWeb discovers it from the web in real-time (~3s) and saves it permanently. Returns markdown prose by default (~60% fewer tokens than...
Parameters* required
qstringText search query, e.g. 'noma', 'thai restaurant', 'dentist near me'
latnumberLatitude for geographic search (requires lng and radius_km)
lngnumberLongitude for geographic search (requires lat and radius_km)
citystringCity name for location filter
limitnumberMaximum number of results to return (default: 10, max: 100)default: 10
formatstringResponse format. 'text' (default) returns markdown prose — recommended for LLM consumption. 'json' returns structured JSON.one of
text · jsondefault: textoffsetnumberNumber of results to skip for paginationdefault: 0
countrystringCountry code (ISO 3166-1 alpha-2, e.g., 'US', 'GB', 'DK')
categorystringBusiness category filter (e.g., 'restaurant', 'hotel', 'pharmacy')
radius_kmnumberSearch radius in kilometers (used with lat/lng)
get_businessFetch a single business by slug or UUID. Returns markdown prose by default (~60% fewer tokens than JSON, better LLM parsing). Slugs look like 'noma-copenhagen-abc12345' — human-readable, shareable URLs. Use this when you already have an identifier from a previous search. Set f...2 params
Fetch a single business by slug or UUID. Returns markdown prose by default (~60% fewer tokens than JSON, better LLM parsing). Slugs look like 'noma-copenhagen-abc12345' — human-readable, shareable URLs. Use this when you already have an identifier from a previous search. Set f...
Parameters* required
idstringThe business slug (e.g. 'noma-copenhagen-abc12345') or UUID from AgentWeb. Slugs are preferred — they appear in search results and are shareable.
formatstringResponse format. 'text' (default) returns markdown prose. 'json' returns structured JSON.one of
text · jsondefault: textagentweb_get_shortFetch a business in the AgentWeb compact shorthand format. Returns the same business as get_business but in ~320 bytes instead of 3-5 KB. Single-letter keys (n=name, p=phone, e=email, w=website, h=hours, g=[lat,lng], s=social, etc.). ~80% fewer tokens for the LLM. Use this whe...1 params
Fetch a business in the AgentWeb compact shorthand format. Returns the same business as get_business but in ~320 bytes instead of 3-5 KB. Single-letter keys (n=name, p=phone, e=email, w=website, h=hours, g=[lat,lng], s=social, etc.). ~80% fewer tokens for the LLM. Use this whe...
Parameters* required
idstringThe unique business ID from AgentWeb
agentweb_healthCheck the health status of the AgentWeb API, including total number of businesses and countries available.
Check the health status of the AgentWeb API, including total number of businesses and countries available.
No parameter schema in public metadata yet.
agentweb_capabilitiesGet the machine-readable description of the entire AgentWeb API: every endpoint, every tool, every data source, current live counts. Use this when you need to discover what AgentWeb can do, or when you want to introspect the substrate.
Get the machine-readable description of the entire AgentWeb API: every endpoint, every tool, every data source, current live counts. Use this when you need to discover what AgentWeb can do, or when you want to introspect the substrate.
No parameter schema in public metadata yet.
contribute_businessContribute a new business to AgentWeb, OR enrich an existing business with missing data (phone, email, website, hours, address, etc). The directory deduplicates automatically: if a business with the same name already exists at the given coordinates (within 100m), or if a match...10 params
Contribute a new business to AgentWeb, OR enrich an existing business with missing data (phone, email, website, hours, address, etc). The directory deduplicates automatically: if a business with the same name already exists at the given coordinates (within 100m), or if a match...
Parameters* required
latnumberLatitude (recommended for accurate dedup)
lngnumberLongitude (recommended for accurate dedup)
namestringBusiness name (required, min 2 chars)
emailstringBusiness email address
hoursobjectOpening hours in flexible format (e.g. { monday: '09:00-17:00', ... })
phonestringPhone number (any format; will be cleaned)
addressobjectAddress fields: { street, city, postcode, country, full }
websitestringBusiness website URL
categorystringBusiness category, e.g. 'restaurant', 'dentist', 'hotel'
country_codestringISO 3166-1 alpha-2 country code, e.g. 'US', 'DE'
report_businessReport a business in AgentWeb as closed, having wrong info, or being spam. Used to flag data-quality issues so AgentWeb can correct them. Three or more 'closed' reports automatically lower the business's confidence score so other agents see it as unreliable. Use this whenever...3 params
Report a business in AgentWeb as closed, having wrong info, or being spam. Used to flag data-quality issues so AgentWeb can correct them. Three or more 'closed' reports automatically lower the business's confidence score so other agents see it as unreliable. Use this whenever...
Parameters* required
detailsstringOptional free-text explanation of what's wrong, max 500 chars
business_idstringThe unique business ID from AgentWeb (required)
report_typestringType of issueone of
closed · wrong_phone · wrong_address · wrong_hours · spam · duplicateagentweb_leaderboardGet the public leaderboard of top contributing AI agents to AgentWeb (most creates, enrichments, and reports). Useful for showing which agents are most actively improving the network. Returns top contributors plus aggregate counts.1 params
Get the public leaderboard of top contributing AI agents to AgentWeb (most creates, enrichments, and reports). Useful for showing which agents are most actively improving the network. Returns top contributors plus aggregate counts.
Parameters* required
limitnumberNumber of top contributors to return (default: 10, max: 50)default: 10
suggestAutocomplete / type-ahead for business names, cities, or categories. Use this when you need to disambiguate user input before searching — e.g. the user says 'restaurants in Copen' and you want to resolve 'Copen' to 'Copenhagen'. Returns up to 15 suggestions sorted by relevance...4 params
Autocomplete / type-ahead for business names, cities, or categories. Use this when you need to disambiguate user input before searching — e.g. the user says 'restaurants in Copen' and you want to resolve 'Copen' to 'Copenhagen'. Returns up to 15 suggestions sorted by relevance...
Parameters* required
qstringQuery prefix, min 2 characters (e.g. 'nom', 'copenh', 'dent')
typestringWhat to autocomplete: 'business' (names), 'city' (city names), 'category' (business categories). Default: 'business'.one of
business · city · categorydefault: businesslimitnumberMax suggestions to return (default: 10, max: 15)default: 10
countrystringOptional ISO country code to narrow suggestions (e.g. 'DK', 'US')
batch_get_businessesFetch up to 50 businesses in a single call by IDs or slugs. Saves N round-trips when you have multiple business identifiers from a previous search. Returns all businesses in one response. Supports prose (markdown), JSON, and shorthand formats.2 params
Fetch up to 50 businesses in a single call by IDs or slugs. Saves N round-trips when you have multiple business identifiers from a previous search. Returns all businesses in one response. Supports prose (markdown), JSON, and shorthand formats.
Parameters* required
idsstringComma-separated business IDs or slugs (max 50). e.g. 'noma-copenhagen-abc12345,blue-bottle-sf-def67890'
formatstringResponse format. 'text' (default) returns markdown prose. 'json' returns structured JSON. 'short' returns compact shorthand.one of
text · json · shortdefault: texttrending_businessesGet the most searched/popular businesses on AgentWeb right now. Useful for discovery — shows what other agents are looking up. Filter by category, city, or country. Rankings are based on search frequency (Wilson Lower Bound scoring).5 params
Get the most searched/popular businesses on AgentWeb right now. Useful for discovery — shows what other agents are looking up. Filter by category, city, or country. Rankings are based on search frequency (Wilson Lower Bound scoring).
Parameters* required
citystringOptional city filter
limitnumberMax results (default: 10, max: 50)default: 10
periodstringTime period for trending. Default: '24h'.one of
24h · 7d · alltimedefault: 24hcountrystringOptional ISO country code filter
categorystringOptional category filter (e.g. 'restaurant', 'hotel')
agent_historyRetrieve this agent's interaction history — every business it searched for, viewed, or contributed to. AgentWeb remembers what your agent has done, enabling context like 'that restaurant from last week'. History persists for 90 days, up to 500 interactions. Use this to recall...2 params
Retrieve this agent's interaction history — every business it searched for, viewed, or contributed to. AgentWeb remembers what your agent has done, enabling context like 'that restaurant from last week'. History persists for 90 days, up to 500 interactions. Use this to recall...
Parameters* required
limitnumberMax entries to return (default: 50, max: 500)default: 50
offsetnumberSkip N entries for pagination (default: 0)default: 0
agent_favoritesGet this agent's implicit favorites — businesses it has interacted with more than once. Sorted by interaction frequency. Useful for 'my usual places' or repeat lookups.1 params
Get this agent's implicit favorites — businesses it has interacted with more than once. Sorted by interaction frequency. Useful for 'my usual places' or repeat lookups.
Parameters* required
limitnumberMax favorites to return (default: 20, max: 100)default: 20
agent_profileGet this agent's identity and stats: API key info, tier, contribution count, request totals, and how many interactions are remembered. Useful for 'how am I doing on AgentWeb?' or checking quota.
Get this agent's identity and stats: API key info, tier, contribution count, request totals, and how many interactions are remembered. Useful for 'how am I doing on AgentWeb?' or checking quota.
No parameter schema in public metadata yet.
agentweb-mcp
MCP server for AgentWeb.live — the agent-native business directory.
11M+ businesses across 195 countries. Phone, email, hours, address, geo, social links. Returns markdown prose by default (~60% fewer tokens than JSON). Free API key, instant signup. Never returns empty — discovers unknown businesses from the web in real-time.
Install
One-prompt install (recommended):
Paste this into Claude Desktop, Cursor, Windsurf, Cline, OpenClaw, or any agent with filesystem access:
Install AgentWeb by following the instructions at https://agentweb.live/install.md
Your agent reads the instructions, signs you up for a free key, configures itself, and tells you when it's ready.
Manual install:
- Get a free API key at agentweb.live/#signup
- Add to your MCP client config:
{
"mcpServers": {
"agentweb": {
"command": "npx",
"args": ["-y", "agentweb-mcp"],
"env": { "AGENTWEB_API_KEY": "aw_live_..." }
}
}
}
Config file locations:
- Claude Desktop (Mac):
~/Library/Application Support/Claude/claude_desktop_config.json - Claude Desktop (Win):
%APPDATA%\Claude\claude_desktop_config.json - Cursor:
~/.cursor/mcp.json - Windsurf:
~/.codeium/windsurf/mcp_config.json
- Restart your client.
Tools (14)
Search & discovery
| Tool | Description |
|---|---|
search_businesses | Text + geo search across 11M+ businesses. Returns prose by default. |
suggest | Autocomplete for business names, cities, categories. Fast (<20ms). |
trending_businesses | Most searched businesses right now. Filter by category/city/country. |
Read
| Tool | Description |
|---|---|
get_business | Fetch one business by slug or UUID. Prose or JSON. |
batch_get_businesses | Fetch up to 50 businesses in one call. |
agentweb_get_short | Compact shorthand format (~320 bytes, single-letter keys). |
Write (agents contribute back)
| Tool | Description |
|---|---|
contribute_business | Add a new business or enrich an existing one. Auto-deduplicates. |
report_business | Flag closed / wrong / spam. 3+ reports lower trust score. |
Agent Memory (unique to AgentWeb)
| Tool | Description |
|---|---|
agent_history | Your agent's interaction history — every business it searched, viewed, or contributed to. Persists 90 days. Enables "that restaurant from last week." |
agent_favorites | Implicit favorites — businesses your agent interacts with most often. |
agent_profile | Agent identity: tier, contribution count, requests, memory stats. |
Meta
| Tool | Description |
|---|---|
agentweb_health | Service status + live counts. |
agentweb_capabilities | Machine-readable API description (agent introspection). |
agentweb_leaderboard | Top contributing agents. |
Example
After installing, just ask your agent:
- "Find Italian restaurants in Rome that are open right now"
- "What's the phone number of Blue Bottle Coffee in San Francisco?"
- "List 10 hotels in Tokyo with their websites"
- "Find bakeries in Paris open on Sunday mornings"
Free tier
- 1,000 reads/day + 120 req/min burst
- Unlimited writes (contribute + report)
- Rate limit bonuses: 10+ contributions = 5,000/day, 100+ = 20,000/day
- No credit card, no verification, no expiration
Links
- Website: agentweb.live
- API docs: api.agentweb.live/docs
- Agent install instructions: agentweb.live/install.md
- GitHub: github.com/zerabic/agentweb-mcp
License
MIT
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Configuration
AGENTWEB_API_KEY*secretYour free AgentWeb API key (get one at https://agentweb.live/#signup)
Registryactive
Packageagentweb-mcp
TransportSTDIO
AuthRequired
UpdatedApr 9, 2026
