MCP Servers

yelp-mcp-min

Minimal MCP server for the Yelp Fusion API v3, enabling business search, phone lookup, match, details, and reviews via FastMCP.

README

yelp-mcp-min

Minimal MCP server for the Yelp Fusion API v3, built with FastMCP 3.

Prerequisites

Python 3.11+
uv 0.11+
Docker (optional)
A Yelp Fusion API key — https://www.yelp.com/developers/v3/manage_app

Installation

uv sync
cp .env.example .env
# Edit .env and set YELP_API_KEY

Running

# 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 .

Environment variables

Variable	Required	Default	Description
`YELP_API_KEY`	Yes	—	Yelp Fusion API bearer token
`YELP_BASE_URL`	No	`https://api.yelp.com/v3`	API base URL
`HTTP_TIMEOUT`	No	`10.0`	Request timeout in seconds
`HTTP_MAX_RETRIES`	No	`3`	Max retry attempts on 429/5xx
`HTTP_RETRY_WAIT_MIN`	No	`1.0`	Min back-off wait in seconds
`HTTP_RETRY_WAIT_MAX`	No	`10.0`	Max back-off wait in seconds
`LOG_LEVEL`	No	`INFO`	structlog level
`JSON_LOGS`	No	`false`	Emit JSON log lines (for Datadog etc)

Tools

Tool	Yelp endpoint	Description
`search_businesses`	`GET /v3/businesses/search`	Full-text + geo search with pagination
`find_business_by_phone`	`GET /v3/businesses/search/phone`	Look up a business by E.164 phone number
`match_business`	`GET /v3/businesses/matches`	Match structured name+address to Yelp listing
`get_business`	`GET /v3/businesses/{id}`	Full business profile by Yelp ID or alias
`get_business_reviews`	`GET /v3/businesses/{id}/reviews`	Customer reviews with pagination

Resource

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.

Project structure

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.example

Running tests

uv run pytest -v

Recommended Servers

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official

Featured

TypeScript

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official

Featured

Local

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official

Featured

TypeScript

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official

Featured

Python

E2B

Using MCP to run code via e2b.

Official

Featured

Neon Database

MCP server for interacting with Neon Management API and databases

Official

Featured

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official

Featured

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official

Featured