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
MCP server for 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.mdYour agent reads the instructions, signs you up for a free key, configures itself, and tells you when it's ready.
Manual install:
- Get a free API key at agentweb.live/#signup
- Add to your MCP client config:
{
"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
- 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
- API docs: api.agentweb.live/docs
- Agent install instructions: agentweb.live/install.md
- GitHub: github.com/zerabic/agentweb-mcp
License
MIT