HasData/yelp-mcp

A hosted Model Context Protocol (MCP) server that gives Claude, Cursor, Windsurf and any other MCP client three read-only Yelp tools. Search businesses by keyword and location, read one business in full, and page through its complete review feed, all as structured JSON, with no Yelp Fusion key and nothing to host.
It reads public Yelp pages that a signed-out visitor can see, on any of the 41 regional domains.
**1,000 free credits every month, no card required**, which is 100 Yelp calls at the 10-credit rate.
- Prompts and resources
Contents
- What you need
- Quick start
- Example prompts
- Tools
- Errors and failure paths
- Pricing, free tier and limits
- Tool selection
- How it compares
- FAQ
- HasData links
- Development
- Contributing
- License
What you need
An MCP client and a HasData API key from the dashboard, free to create with no card, and the free tier covers about 100 calls a month at the 10-credit rate. This is a remote server, so the simplest path is a URL and an x-api-key header, with no container to run. A client that only speaks stdio reaches it through a thin launcher, published as @hasdata/yelp-mcp on npm and hasdata-yelp-mcp on PyPI, shown below.
Quick start
The server URL is the same for every client. We run it hands-on in Claude Code and Claude Desktop. The other blocks follow each client's own documented format for a remote server.
| Field | Value |
| :--- | :--- |
| URL | https://mcp.hasdata.com/mcp?apis=yelp |
| Transport | HTTP, streamable |
| Auth header | x-api-key: HASDATA_API_KEY |
Clients with OAuth support can add the same URL as a connector and sign in without putting a key in a config file.
Claude Code
Claude Desktop
Settings, then Connectors, then Add custom connector, then paste https://mcp.hasdata.com/mcp?apis=yelp and sign in.
For the config-file route, Claude Desktop loads only local (stdio) servers, so it reaches a remote server through a stdio launcher. The @hasdata/yelp-mcp package is that launcher, and it reads the key from the environment. Add this to claude_desktop_config.json:
For Python instead of Node, swap the launcher for the PyPI package, which uvx runs without a manual install:
Cursor
~/.cursor/mcp.json for every project, or .cursor/mcp.json for one:
Windsurf
~/.codeium/windsurf/mcp_config.json. Windsurf calls the field serverUrl, not url:
VS Code
.vscode/mcp.json in the workspace:
Example prompts
Each of these lands on one tool, or on two in sequence when the second needs an identifier the first returns.
- Find coffee roasteries in Austin, TX and rank them by rating against review count.
- Pull the hours, phone and website for the Yelp business desnudo-coffee-austin.
- Read every one-star and two-star review of this business and group the complaints by theme.
- Which dishes does Yelp list as popular for this place, and what do reviewers say about them?
- Compare the rating distribution of these three competitors in the same neighborhood.
- Show me the reviews Yelp does not recommend for this business and how they differ from the recommended ones.
A prompt that names a business rather than a Yelp ID takes two calls, one search to resolve the ID and one place or reviews lookup to read it. The search tool returns both placeId and placeAlias, and either one works as the placeId argument to the place tool.
Tools
| Tool | What it returns |
| --- | --- |
| hasdata_yelp_place_getPlaceDetails | Name, address, phone, website, price range, categories, overall rating, review count, hours, amenities, photos, and highlighted reviews. 10 credits a call |
| hasdata_yelp_reviews_getPlaceReviews | Fetches the review feed of a single Yelp business by Yelp ID, with sorting (relevance, date, rating, elites), filtering by star rating, language and free-text query, and…. 10 credits a call |
| hasdata_yelp_search_getSearchResults | A ranked list of businesses with Yelp alias/ID, name, categories, rating, review count, price tier, neighborhood, and thumbnail. 10 credits a call |
Three tools, 10 credits per successful call. Every tool accepts domain to switch country, one of 41 values, from www.yelp.com through the European, Asian and Latin American sites, including the language-specific variants such as fr.yelp.ca and zh.yelp.com.hk.