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.

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

License

MIT

Tool	Description
`agentweb_health`	Service status + live counts.
`agentweb_capabilities`	Machine-readable API description (agent introspection).
`agentweb_leaderboard`	Top contributing agents.

agentweb mcp