AgentWeb
AgentWeb MCP Server
MCP (Model Context Protocol) server for AgentWeb.live — a free business directory API with 11M+ businesses across 195 countries.
What It Does
This MCP server exposes AgentWeb's business directory API to AI assistants like Claude, enabling them to:
- Search for businesses by name, category, or location
- Get detailed business information (phone, email, hours, address, website)
- Access data from 11M+ businesses in 195 countries
Installation
Quick Start with npx
The easiest way to use this server is with npx:
npx agentweb-mcp
Or Install Globally
npm install -g agentweb-mcp
agentweb-mcp
Getting an API Key
You need a free API key from AgentWeb:
- Visit https://agentweb.live/#signup
- Sign up with your email and name
- Your API key will be sent to your email (format:
aw_live_...)
Configuration
Claude Desktop
Add this to your 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
Add to your MCP settings file:
{
"mcpServers": {
"agentweb": {
"command": "npx",
"args": ["-y", "agentweb-mcp"],
"env": {
"AGENTWEB_API_KEY": "aw_live_your_key_here"
}
}
}
}
Alternative: Pass API Key as Argument
{
"mcpServers": {
"agentweb": {
"command": "npx",
"args": ["-y", "agentweb-mcp", "aw_live_your_key_here"]
}
}
}
Available Tools
1. search_businesses
Search for businesses in the AgentWeb directory.
Parameters:
q(string, optional): Text search query (business name, keywords)category(string, optional): Business category (e.g., "restaurant", "hotel")city(string, optional): City name for location filtercountry(string, optional): Country code (ISO 3166-1 alpha-2, e.g., "US", "GB")lat(number, optional): Latitude for geographic searchlng(number, optional): Longitude for geographic searchradius_km(number, optional): Search radius in kilometers (use with lat/lng)limit(number, optional): Max results to return (default: 10, max: 50)offset(number, optional): Number of results to skip for pagination
Note: At least one of q, category, or lat+lng is required.
Example queries:
- "Find pizza restaurants in New York"
- "Search for hotels near latitude 40.7128, longitude -74.0060 within 5km"
- "List all cafes in London, GB"
2. get_business
Get full details for a specific business by ID.
Parameters:
id(string, required): The unique business ID from AgentWeb
Example:
- "Get details for business ID abc123"
3. agentweb_health
Check the health status of the AgentWeb API.
Parameters: None
Returns: API status, total businesses count, and countries available.
Example Usage
After configuring the server, you can ask Claude:
Find Italian restaurants in San Francisco
Search for dentists near me in Chicago
Get contact information for coffee shops in Seattle
Development
Build from Source
git clone <repository>
cd agentweb-mcp
npm install
npm run build
Run in Development Mode
npm run dev
Project Structure
agentweb-mcp/
├── src/
│ └── index.ts # Main MCP server implementation
├── dist/ # Compiled JavaScript (generated)
├── package.json
├── tsconfig.json
└── README.md
API Documentation
For full API documentation, visit AgentWeb API Docs.
Support
- API Issues: Contact AgentWeb support
- MCP Server Issues: Open an issue in this repository
- Get API Key: https://agentweb.live/#signup
License
MIT
Server Config
{
"mcpServers": {
"agentweb": {
"command": "npx",
"args": [
"-y",
"agentweb-mcp"
],
"env": {
"AGENTWEB_API_KEY": "aw_live_your_key"
}
}
}
}