# HasData Yellow Pages

Remote MCP server that extracts Yellow Pages business search and place details into structured JSON. Requires a HasData API key.

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

## What it does

This server connects your MCP client to public directory listings on `yellowpages.com` and `yellowpages.ca`. It provides two tools. One endpoint runs location-based business searches and returns up to 30 results per batch with ratings and contact addresses. The other retrieves full profiles from listing URLs, capturing working hours and verified services.

No local container is required. The service hosts a remote HTTP endpoint at `https://mcp.hasdata.com/mcp?apis=yellowpages`. Stdio-only environments connect via `@hasdata/yellowpages-mcp` on npm or `hasdata-yellowpages-mcp` on PyPI. Each successful tool call consumes 10 credits from your balance. Without a valid API key, requests will fail.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.hasdata.com/mcp?apis=yellowpages`
- 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 yellowpages -e HASDATA_API_KEY=<HASDATA_API_KEY> -- npx -y @hasdata/yellowpages-mcp
```
Replace <…> with your own values

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

### Codex

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

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

### Cursor

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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "hasdata-yellow-pages": {
            "type": "http",
            "url": "https://mcp.hasdata.com/mcp?apis=yellowpages"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "hasdata-yellow-pages": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@hasdata/yellowpages-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-yellow-pages 'https://mcp.hasdata.com/mcp?apis=yellowpages'
```

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

## When to use it
- extract local business contacts and ratings by keyword and city
- parse business hours and services from a Yellow Pages profile
- retrieve multiple pages of directory search results
- inspect business operational history from directory profiles

## Example prompts
- Find electric contractors in Austin on Yellow Pages and sort them by review count.
- Fetch the complete listing details and opening hours for this Yellow Pages URL.
- Search for plumbers in Seattle and pull both page 2 and page 3.

## Similar
- [HasData Instagram](https://affpapa.org/en/nevibecode/mcp/hasdata-instagram.md) — MCP server · ★ 15
- [HasData Redfin](https://affpapa.org/en/nevibecode/mcp/hasdata-redfin.md) — MCP server · ★ 10
- [read-deleted-pages](https://affpapa.org/en/nevibecode/skills/read-deleted-pages.md) — skill · 2000 installs
- [cnki-navigate-pages](https://affpapa.org/en/nevibecode/skills/cnki-navigate-pages.md) — skill · 330 installs
- [Latina Dev](https://affpapa.org/en/nevibecode/mcp/latina-dev.md) — MCP server · ★ 20
- [python-executor](https://affpapa.org/en/nevibecode/skills/python-executor.md) — skill · 109700 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