# HasData Yelp

Reads Yelp business profiles, searches locations, and extracts reviews into structured JSON. Useful for local data research without a Yelp Fusion key.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10
- Author: HasData
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/HasData/yelp-mcp
- Updated: 2026-10-12
- HTML: https://affpapa.org/en/nevibecode/mcp/hasdata-yelp

## What it does

This hosted server equips your agent with three read-only Yelp tools: keyword search by location, complete venue profiles, and paginated review feeds. All results return as clean, structured JSON. The service processes public listings across 41 localized domains, which eliminates the need to obtain credentials from Yelp Fusion or host your own scraper.

Connection works directly over streamable HTTP with an `x-api-key` header, or locally through the `@hasdata/yelp-mcp` npm package. HasData provides 1,000 free credits each month without asking for a payment card. Every successful call costs 10 credits, which caps the free usage tier at 100 calls per billing cycle.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.hasdata.com/mcp?apis=yelp`
- Environment variables: `HASDATA_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add yelp -e HASDATA_API_KEY=<HASDATA_API_KEY> -- npx -y @hasdata/yelp-mcp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http hasdata-yelp 'https://mcp.hasdata.com/mcp?apis=yelp'
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add hasdata-yelp --url 'https://mcp.hasdata.com/mcp?apis=yelp'
```

2. **Platform CLI**
```bash
codex mcp add hasdata-yelp --env HASDATA_API_KEY=<HASDATA_API_KEY> -- npx -y @hasdata/yelp-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hasdata-yelp": {
            "url": "https://mcp.hasdata.com/mcp?apis=yelp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hasdata-yelp": {
            "command": "npx",
            "args": [
                "-y",
                "@hasdata/yelp-mcp"
            ],
            "env": {
                "HASDATA_API_KEY": "<HASDATA_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "hasdata-yelp": {
            "type": "http",
            "url": "https://mcp.hasdata.com/mcp?apis=yelp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "hasdata-yelp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@hasdata/yelp-mcp"
            ],
            "env": {
                "HASDATA_API_KEY": "<HASDATA_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http hasdata-yelp 'https://mcp.hasdata.com/mcp?apis=yelp'
```

2. **Platform CLI**
```bash
gemini mcp add -e HASDATA_API_KEY=<HASDATA_API_KEY> hasdata-yelp npx -y @hasdata/yelp-mcp
```
Replace <…> with your own values

## When to use it
- search local businesses by category, keyword, or city
- retrieve venue hours, phone numbers, amenities, and photos
- extract customer review feeds filtered by rating or language
- compare rating distributions and review volume between competitors

## Example prompts
- Find specialty coffee shops in Austin, TX and sort them by review count
- Get the opening hours and phone number for `desnudo-coffee-austin`
- Extract one-star reviews for this place and list the main customer complaints

## Similar
- [yelp](https://affpapa.org/en/nevibecode/skills/yelp.md) — skill · 3700 installs
- [HasData Google Maps](https://affpapa.org/en/nevibecode/mcp/hasdata-google-maps.md) — MCP server · ★ 8
- [apify-ecommerce](https://affpapa.org/en/nevibecode/skills/apify-ecommerce.md) — skill · 512 installs
- [HasData Instagram](https://affpapa.org/en/nevibecode/mcp/hasdata-instagram.md) — MCP server · ★ 15
- [google-reviews](https://affpapa.org/en/nevibecode/skills/google-reviews.md) — skill · 373 installs
- [goplaces](https://affpapa.org/en/nevibecode/skills/goplaces.md) — skill · 5300 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md