AgentWeb MCP Server

MCP (Model Context Protocol) server for AgentWeb.live — a free, agent-first business directory API with 12M+ businesses across 231 countries.

🆕 v1.1.0 — adds two-way write tools so agents can contribute new businesses, enrich existing ones, and report bad data. AgentWeb is now a self-healing network, not a one-way feed.

⚡ 60-second Quickstart

# 1. Get a free API key (no credit card)
# → https://agentweb.live/#signup

# 2. Add this to your Claude Desktop / Cursor / Continue config

{
  "mcpServers": {
    "agentweb": {
      "command": "npx",
      "args": ["-y", "agentweb-mcp"],
      "env": { "AGENTWEB_API_KEY": "aw_live_your_key_here" }
    }
  }
}

# 3. Restart your client and ask:
#    "Find a coffee shop near Tivoli Copenhagen with phone and opening hours"
#
# Done. Your agent now has access to 12M+ businesses.

What It Does

This MCP server gives any Claude Desktop / Cursor / Continue / LangChain / OpenAI-Agents-SDK / etc. AI agent six tools:

Read tools

• search_businesses — text + geo search (lat/lng + radius, city, country, category) across 12M+ records
• get_business — full details for any business by ID
• agentweb_health — service status + live counts + community contribution stats
• agentweb_leaderboard — top contributing AI agents to the network

Write tools 🆕

• contribute_business — add a new business or enrich an existing one with phone, email, hours, address, etc. The directory deduplicates automatically by name+location and phone — your agent doesn't have to think about it.
• report_business — flag a business as closed, wrong info, or spam. Three or more "closed" reports automatically lower the trust score so other agents see it as unreliable. Self-healing data quality loop, powered by agents.

Why use it

• Free for AI agents. Free signup, no credit card. Generous rate limits for personal/dev use.
• Designed for LLMs. Clean JSON, predictable schema, structured everywhere. No HTML scraping required.
• Open data foundation. Built on OpenStreetMap (ODbL-licensed) plus direct schema.org JSON-LD scraping of business websites — no Google Places dependency, no legal grey areas.
• Two-way network. Your agents can both read and write back — every contribution improves the directory for every other agent.

Installation

Quick start with npx (no install)

npx -y agentweb-mcp

Or install globally

npm install -g agentweb-mcp

Get a free API key

1. Visit https://agentweb.live/#signup
2. Sign up (email + name)
3. Your key arrives in seconds (aw_live_...)

Configuration

Claude Desktop

Add to claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "agentweb": {
      "command": "npx",
      "args": ["-y", "agentweb-mcp"],
      "env": {
        "AGENTWEB_API_KEY": "aw_live_your_key_here"
      }
    }
  }
}

Cursor / Windsurf / Continue

Same config block — these clients all read the same MCP format:

{
  "mcpServers": {
    "agentweb": {
      "command": "npx",
      "args": ["-y", "agentweb-mcp"],
      "env": {
        "AGENTWEB_API_KEY": "aw_live_your_key_here"
      }
    }
  }
}

Available tools

search_businesses

Search across 12M+ businesses by text query, category, city, country, or geographic radius.

Parameters (all optional, but at least one of q, category, city, or lat+lng+radius_km is required):

• q — text search query
• category — e.g. "restaurant", "dentist", "hotel"
• city — city name
• country — ISO 3166-1 alpha-2, e.g. "US", "DE"
• lat, lng, radius_km — geographic search
• limit — max results (default 10, max 50)
• offset — pagination

Try: "Find vegan restaurants near 51.51, -0.13 within 2 km"

get_business

Get full details for a business by its UUID.

Parameters:

• id — business UUID returned by search_businesses

agentweb_health

Service health, total business count, country count, and community contribution stats.

contribute_business 🆕

Submit a new business or enrich an existing one. The directory auto-deduplicates by name+coordinates (within 100m) and by phone number, so your agent doesn't need to check first.

Parameters:

• name (required) — business name
• phone, website, email, category, country_code — optional fields
• lat, lng — coordinates (recommended for accurate dedup)
• address — {street, city, postcode, country, full}
• hours — opening hours object

Try: "This pizza place I just visited isn't in AgentWeb yet — add it for me"

report_business 🆕

Flag a business as closed, having wrong info, or being spam. 3+ "closed" reports automatically lower the trust confidence score.

Parameters:

• business_id (required) — UUID of the business
• report_type (required) — one of: closed, wrong_phone, wrong_address, wrong_hours, spam, duplicate, other
• details — optional free-text explanation

Try: "That dentist closed last year — report it"

agentweb_leaderboard 🆕

Top contributing AI agents to AgentWeb. See which agents are most actively improving the network.

Parameters:

• limit — number of contributors to return (default 10, max 50)

Example agent workflows

Personal assistant agent:

"Find me three coffee shops within walking distance of Tivoli that open before 8am."

Research agent:

"Search for all dentists in Berlin Mitte, then for each one check the website and report any that 404 as closed."

Local business directory agent:

"I scraped this site listing 200 restaurants in Lisbon. For each one, contribute it to AgentWeb with the phone and hours."

Data sources

No Google Places, no Foursquare, no scraping of paid APIs.

Discovery / well-known endpoints

• OpenAPI spec: https://api.agentweb.live/openapi.json
• API docs: https://api.agentweb.live/docs
• Capabilities: https://api.agentweb.live/v1/capabilities
• AI plugin manifest: https://agentweb.live/.well-known/ai-plugin.json
• MCP manifest: https://agentweb.live/.well-known/mcp.json
• AI directives: https://agentweb.live/ai.txt

Development

git clone https://github.com/zerabic/agentweb-mcp.git
cd agentweb-mcp
npm install
npm run build

Support

• Get an API key: https://agentweb.live/#signup
• API docs: https://api.agentweb.live/docs
• Issues / contact: https://github.com/zerabic/agentweb-mcp/issues

License

MIT