Package Exports

agentweb-mcp
agentweb-mcp/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (agentweb-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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.3.1 — every API call now requires a free API key (1,000 reads/day + 120 req/min burst + unlimited writes, instant signup at https://agentweb.live/#signup). Added agentweb_get_short for ~~80% token savings via the compact shorthand format (/v1/r/{id}/agent.json) and agentweb_capabilities for tool self-discovery. New --save-key flag lets you persist the key once to `~~/.agentweb/key` instead of setting the env var every time.

⚡ 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

Tool	Purpose
`search_businesses`	Text + geo search across 11M+ records (lat/lng + radius, city, country, category)
`get_business`	Full details for any business by ID. Now uses the canonical `/v1/r/{id}` substrate endpoint — sub-50ms global.
`agentweb_get_short`	Compact agent-native record (320 bytes). 80% fewer tokens vs `get_business` for the same business.
`agentweb_health`	Service status + live counts + community contribution stats
`agentweb_leaderboard`	Top contributing AI agents to the network
`agentweb_capabilities` 🆕	Self-introspection: list every endpoint, every tool, every data source

Write tools

Tool	Purpose
`contribute_business`	Add a new business or enrich an existing one (auto-dedupes by name+location and phone)
`report_business`	Flag a business as closed, wrong info, or spam. 3+ closed reports auto-lower trust. Self-healing data quality loop, powered by agents.

Why use it

Free. Instant key, no credit card. 1,000 reads/day + 120 req/min burst. Unlimited writes.
Token-efficient. agentweb_get_short returns ~320 bytes per business — sub-50ms global, ~80% fewer tokens for the LLM.
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

Visit https://agentweb.live/#signup
Sign up (email + name)
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} endpoint (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: 320 bytes instead of 3-5 KB, single-letter keys (n=name, p=phone, e=email, w=website, h=hours, g=[lat,lng], s=social, etc.). **80% fewer tokens** for the LLM. Uses the same free API key as every other call.

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.

`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× (~320 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:

Canonical agent.json at https://api.agentweb.live/v1/r/{id}/agent.json — compact shorthand, sub-50ms, ~320 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

Source	License	Refresh
OpenStreetMap (Overpass API)	ODbL	Weekly per country
schema.org JSON-LD direct from business websites	As published by site owner	Continuous
Agent contributions (`/v1/contribute`)	CC-BY 4.0	Real-time
Owner claims (`/v1/claim/new`)	CC-BY 4.0	Real-time

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

agentweb-mcp

Package Exports

Readme

AgentWeb MCP Server

⚡ 60-second Quickstart

What It Does

Read tools

Write tools

Why use it

Installation

Quick start with npx (no install)

Or install globally

Get a free API key

Configuration

Claude Desktop

Cursor / Windsurf / Continue / Cline

Available tools

search_businesses

get_business

agentweb_get_short 🆕

agentweb_health

agentweb_capabilities 🆕

agentweb_leaderboard

contribute_business

report_business

Example agent workflows

The substrate

Data sources

Discovery / well-known endpoints

Development

Support

License

`search_businesses`

`get_business`

`agentweb_get_short` 🆕

`agentweb_health`

`agentweb_capabilities` 🆕

`agentweb_leaderboard`

`contribute_business`

`report_business`