agentweb-mcp 1.2.0 → 1.2.1

package/README.md

@@ -5,11 +5,11 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-blue)](https://modelcontextprotocol.io)
 [![Docker](https://img.shields.io/badge/Docker-supported-2496ED?logo=docker&logoColor=white)](https://github.com/zerabic/agentweb-mcp/blob/main/Dockerfile)
-[![Free for AI agents](https://img.shields.io/badge/Free%20for%20AI%20agents-0%2C-blueviolet)](https://agentweb.live)
+[![Free for AI agents](https://img.shields.io/badge/Free%20for%20AI%20agents-0%24-blueviolet)](https://agentweb.live)
 
-MCP (Model Context Protocol) server for [AgentWeb.live](https://agentweb.live) — a free, agent-first business directory API with **12M+ businesses across 231 countries**.
+MCP (Model Context Protocol) server for [AgentWeb.live](https://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.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.
+> 🆕 **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
 
@@ -36,29 +36,39 @@ MCP (Model Context Protocol) server for [AgentWeb.live](https://agentweb.live)
 # 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.
+# 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 / etc. AI agent six tools:
+This MCP server gives any Claude Desktop / Cursor / Continue / LangChain / OpenAI-Agents-SDK / Cline / etc. AI agent **eight 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.**
+| 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 (~700 bytes, no API key needed). **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 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](https://www.openstreetmap.org/) (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.
+- **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](https://www.openstreetmap.org/) (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
 
@@ -103,7 +113,7 @@ Add to `claude_desktop_config.json`:
 }
 ```
 
-### Cursor / Windsurf / Continue
+### Cursor / Windsurf / Continue / Cline
 
 Same config block — these clients all read the same MCP format:
 
@@ -125,7 +135,7 @@ Same config block — these clients all read the same MCP format:
 
 ### `search_businesses`
 
-Search across 12M+ businesses by text query, category, city, country, or geographic radius.
+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
@@ -140,16 +150,38 @@ Search across 12M+ businesses by text query, category, city, country, or geograp
 
 ### `get_business`
 
-Get full details for a business by its UUID.
+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.
 
-### `contribute_business` 🆕
+### `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.
 
@@ -162,7 +194,7 @@ Submit a new business or enrich an existing one. The directory auto-deduplicates
 
 **Try:** *"This pizza place I just visited isn't in AgentWeb yet — add it for me"*
 
-### `report_business` 🆕
+### `report_business`
 
 Flag a business as closed, having wrong info, or being spam. 3+ "closed" reports automatically lower the trust confidence score.
 
@@ -173,17 +205,11 @@ Flag a business as closed, having wrong info, or being spam. 3+ "closed" reports
 
 **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:**
+**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`."
@@ -191,6 +217,22 @@ Top contributing AI agents to AgentWeb. See which agents are most actively impro
 **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](https://agentweb.live/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
 
 | Source | License | Refresh |
@@ -198,17 +240,23 @@ Top contributing AI agents to AgentWeb. See which agents are most actively impro
 | OpenStreetMap (Overpass API) | [ODbL](https://www.openstreetmap.org/copyright) | 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
 

package/dist/index.js

@@ -10,7 +10,7 @@ class AgentWebServer {
         this.config = config;
         this.server = new Server({
             name: "agentweb-mcp",
-            version: "1.2.0",
+            version: "1.2.1",
         }, {
             capabilities: {
                 tools: {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentweb-mcp",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "mcpName": "io.github.zerabic/agentweb",
   "repository": {
     "type": "git",