Provides tools for searching businesses, looking up by phone, matching by address, getting business details, and fetching reviews from the Yelp Fusion API.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@yelp-mcp-min search for pizza places in Chicago"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Minimal MCP server for the Yelp Fusion API v3, built with FastMCP 3.
Python 3.11+
uv 0.11+
Docker (optional)
A Yelp Fusion API key — https://www.yelp.com/developers/v3/manage_app
Related MCP server: yelp-mcp-sdk
uv sync
cp .env.example .env
# Edit .env and set YELP_API_KEY# stdio transport (for use with Claude Desktop or an MCP client)
uv run python -m server.main
# Docker
docker build -t yelp-mcp-min .
docker run --env-file .env yelp-mcp-min
docker buildx build -t yelp-mcp-min .Variable | Required | Default | Description |
| Yes | — | Yelp Fusion API bearer token |
| No |
| API base URL |
| No |
| Request timeout in seconds |
| No |
| Max retry attempts on 429/5xx |
| No |
| Min back-off wait in seconds |
| No |
| Max back-off wait in seconds |
| No |
| structlog level |
| No |
| Emit JSON log lines (for Datadog etc) |
Tool | Yelp endpoint | Description |
|
| Full-text + geo search with pagination |
|
| Look up a business by E.164 phone number |
|
| Match structured name+address to Yelp listing |
|
| Full business profile by Yelp ID or alias |
|
| Customer reviews with pagination |
yelp://business/{id} — Returns the same payload as get_business as an MCP
resource (application/json). MCP clients that support resources can embed or
subscribe to this URI directly.
yelp-mcp-min/
server/
main.py # FastMCP instance + wiring
core/
config.py # pydantic-settings (YELP_API_KEY, tunables)
logging.py # structlog setup (stderr only)
client.py # async httpx client, retry, error mapping
models.py # Pydantic output models
tools/
search.py # search_businesses
business.py # find_by_phone, match, get_business
reviews.py # get_business_reviews
resources/
business.py # yelp://business/{id}
tests/
conftest.py
test_client.py
test_tools.py
test_models.py
Dockerfile
pyproject.toml
.env.exampleuv run pytest -vUnclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
MCP server for URL shortening and management
MCP server for Meitre restaurant reservations.
Unofficial read-only MCP server for VeryChic hotel offers
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/miqui/yelp-mcp-min'
If you have feedback or need assistance with the MCP directory API, please join our Discord server