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