agentweb-mcp

agentweb-mcp

MCP server for AgentWeb.live — the agent-native business directory.

70M+ businesses across 195 countries plus live local business search (real-time ratings, hours, phone) and real-time travel (flights, hotels, car rentals, attractions, buses, weather, currency). 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 (23)

Search & discovery

Tool	Description
search_businesses	Text + geo search across 70M+ businesses. Returns prose by default.
local_search	Live local business search — freshest data on the web. Real-time ratings, review counts, phone, today's hours, website, address, geo. Use for "X near Y" or when you need current info.
suggest	Autocomplete for business names, cities, categories. Fast (<20ms).
trending_businesses	Most searched businesses right now. Filter by category/city/country.

Travel & real-time (live data, with booking links)

Tool	Description
search_flights	Flights across multiple sources (booking.com + kiwi.com), cheapest first. Airlines, prices, times, stops, booking links.
search_hotels	Hotels across multiple sources, cheapest first. Name, price, stars, rating, booking links.
search_cars	Car rentals — vehicle, supplier, price, transmission, booking links.
search_attractions	Tours, activities & tickets — price, rating, duration, free-cancellation, booking links.
flixbus_search	Bus/train routes across Europe — prices, times, transfers, booking links.
kiwi_search_flights	Flights via Kiwi.com (aggregates all airlines) — often cheaper.
weather_forecast	Current conditions + up to 14-day forecast with packing advisories.
currency_convert	Live ECB exchange rates, 30+ currencies.

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?"
• "Find the cheapest flight from Copenhagen to Rome on April 25"
• "List hotels in Tokyo under $200/night next weekend"
• "Rent a car at FCO airport for 3 days and show me the cheapest option"
• "What's the weather in Barcelona for the next 5 days?"

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