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:

1. Get a free API key at agentweb.live/#signup
2. 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

3. 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