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.
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.
| 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. |
| 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). |
| 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. |
| 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. |
| Tool | Description |
|---|---|
agentweb_health |
Service status + live counts. |
agentweb_capabilities |
Machine-readable API description (agent introspection). |
agentweb_leaderboard |
Top contributing agents. |
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"
- 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
- Website: agentweb.live
- API docs: api.agentweb.live/docs
- Agent install instructions: agentweb.live/install.md
- GitHub: github.com/zerabic/agentweb-mcp
MIT