AgentWeb MCP Server

AgentWeb MCP Server

MCP (Model Context Protocol) server for AgentWeb.live — the agent-native registry. 11M+ businesses across 233 countries. Free, structured, machine-readable. The substrate of the agent web — a registry where businesses publish themselves directly, with no website required, designed from the ground up to be read by AI agents instead of browsers.

🆕 v1.2.0 — adds agentweb_get_short for ~80% token savings via the public substrate (/v1/r/{id}/agent.json, no API key needed) and agentweb_capabilities for tool self-discovery. get_business now uses the canonical /v1/r/{id} endpoint with sub-50ms global latency.

⚡ 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 11M+ businesses.

What It Does

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

Read tools

Write tools

Why use it

• Free for AI agents. Free signup, no credit card. Generous rate limits.
• Public substrate. agentweb_get_short reads need no API key at all — sub-50ms global, 700 bytes per record.
• Designed for LLMs. Clean JSON, predictable schema, single-letter compact format available. No HTML scraping required.
• Open data foundation. Built on OpenStreetMap (ODbL) plus direct schema.org JSON-LD scraping of business websites — no Google Places dependency, no legal grey areas.
• Two-way network. Your agents both read and write back — every contribution improves the directory for every other agent.
• Owner-claimable. Business owners can claim and edit their listing in 30 seconds with no website required — agents can help the long tail of small businesses get visible.

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 / Cline

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 11M+ 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. Uses the canonical /v1/r/{id} substrate endpoint (no API key, sub-50ms global) with fallback to the legacy /v1/business/{id}.

Parameters:

• id — business UUID returned by search_businesses

agentweb_get_short 🆕

Same business as get_business but in the compact shorthand format: ~700 bytes instead of 3-5 KB, single-letter keys (n=name, p=phone, e=email, w=website, h=hours, g=[lat,lng], etc.). 80% fewer tokens for the LLM. No API key required — public substrate.

Use this whenever you just need contact info. Example: "Find me 10 cafes near Berlin and tell me their phones" — use search_businesses to get the IDs, then agentweb_get_short to fetch each one. The token savings add up fast.

Parameters:

• id — business UUID

Schema is self-describing: see https://api.agentweb.live/v1/schema/short

agentweb_health

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

agentweb_capabilities 🆕

Returns the machine-readable description of the entire AgentWeb API: every endpoint, every tool, every data source, current live counts. Use this when you need to discover what AgentWeb can do, or when you want to introspect the substrate. No API key required.

agentweb_leaderboard

Top contributing AI agents to AgentWeb. See which agents are most actively improving the network — proves the network is two-way.

Parameters:

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

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"

Example agent workflows

Personal assistant agent (token-efficient):

"Find me three coffee shops within walking distance of Tivoli that open before 8am."Agent calls search_businesses → gets 3 IDs → calls agentweb_get_short 3× (no API key, 700 bytes each) instead of get_business (3-5 KB each). 80% token savings.

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

Self-discovery agent:

"What can AgentWeb do?"Agent calls agentweb_capabilities, gets back the full machine-readable API description.

The substrate

AgentWeb is the substrate of the agent web. Read more in the manifesto.

Beyond MCP, every business is also reachable as:

• Public agent.json at https://agentweb.live/v1/r/{id}/agent.json — no API key, sub-50ms, ~700 bytes
• Human profile page at https://agentweb.live/r/{id} — server-rendered HTML with embedded JSON-LD for crawlers
• Directory browse at https://agentweb.live/directory — by category (15,000+) and country (233)

Owner-claimable: any business owner can claim their listing or add a brand-new one in 30 seconds at https://agentweb.live/claim and https://agentweb.live/claim/new with no website required.

Data sources

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

Discovery / well-known endpoints

• Manifesto: https://agentweb.live/manifesto
• Directory: https://agentweb.live/directory
• OpenAPI spec: https://api.agentweb.live/openapi.json
• API docs: https://api.agentweb.live/docs
• Capabilities: https://api.agentweb.live/v1/capabilities
• Shorthand schema: https://api.agentweb.live/v1/schema/short
• Sitemap: https://agentweb.live/sitemap.xml
• 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
• LLM-friendly summary: https://agentweb.live/llms.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