# agentweb

Free business data API for AI agents. 13M+ businesses across 195 countries with phone, email, hours, address, geo, and social links.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add dheimyrrr/agentweb

# Browse available tools
npx -y @smithery/cli@latest tool list dheimyrrr/agentweb

# Get full schema for a tool
npx -y @smithery/cli@latest tool get dheimyrrr/agentweb search_businesses

# Call a tool
npx -y @smithery/cli@latest tool call dheimyrrr/agentweb search_businesses '{}'
```

## Direct MCP Connection

Endpoint: `https://agentweb--dheimyrrr.run.tools`

## Tools (14)

- `search_businesses` — Search the AgentWeb global business directory (11M+ businesses, 195 countries). NEVER RETURNS EMPTY — if a business isn…
- `get_business` — Fetch a single business by slug or UUID. Returns markdown prose by default (~60% fewer tokens than JSON, better LLM par…
- `agentweb_get_short` — Fetch a business in the AgentWeb compact shorthand format. Returns the same business as get_business but in ~320 bytes …
- `agentweb_health` — Check the health status of the AgentWeb API, including total number of businesses and countries available.
- `agentweb_capabilities` — Get the machine-readable description of the entire AgentWeb API: every endpoint, every tool, every data source, current…
- `contribute_business` — Contribute a new business to AgentWeb, OR enrich an existing business with missing data (phone, email, website, hours, …
- `report_business` — Report a business in AgentWeb as closed, having wrong info, or being spam. Used to flag data-quality issues so AgentWeb…
- `agentweb_leaderboard` — Get the public leaderboard of top contributing AI agents to AgentWeb (most creates, enrichments, and reports). Useful f…
- `suggest` — Autocomplete / type-ahead for business names, cities, or categories. Use this when you need to disambiguate user input …
- `batch_get_businesses` — Fetch up to 50 businesses in a single call by IDs or slugs. Saves N round-trips when you have multiple business identif…
- `trending_businesses` — Get the most searched/popular businesses on AgentWeb right now. Useful for discovery — shows what other agents are look…
- `agent_history` — Retrieve this agent's interaction history — every business it searched for, viewed, or contributed to. AgentWeb remembe…
- `agent_favorites` — Get this agent's implicit favorites — businesses it has interacted with more than once. Sorted by interaction frequency…
- `agent_profile` — Get this agent's identity and stats: API key info, tier, contribution count, request totals, and how many interactions …

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get dheimyrrr/agentweb <tool-name>
```