# agentweb-mcp

MCP server for [AgentWeb.live](https://agentweb.live) — the agent-native business directory.

11M+ businesses across 195 countries. 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:**

1. Get a free API key at [agentweb.live/#signup](https://agentweb.live/#signup)
2. Add to your MCP client config:

```json
{
  "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`

3. Restart your client.

## Tools (14)

### Search & discovery

| Tool | Description |
|---|---|
| `search_businesses` | Text + geo search across 11M+ businesses. Returns prose by default. |
| `suggest` | Autocomplete for business names, cities, categories. Fast (<20ms). |
| `trending_businesses` | Most searched businesses right now. Filter by category/city/country. |

### 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?"
- "List 10 hotels in Tokyo with their websites"
- "Find bakeries in Paris open on Sunday mornings"

## 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](https://agentweb.live)
- **API docs:** [api.agentweb.live/docs](https://api.agentweb.live/docs)
- **Agent install instructions:** [agentweb.live/install.md](https://agentweb.live/install.md)
- **GitHub:** [github.com/zerabic/agentweb-mcp](https://github.com/zerabic/agentweb-mcp)

## License

MIT