HasData Yellow Pages — Claude Code MCP server: setup guide
Remote MCP server that extracts Yellow Pages business search and place details into structured JSON. Requires a HasData API key.
claude mcp add yellowpages -e HASDATA_API_KEY=<HASDATA_API_KEY> -- npx -y @hasdata/yellowpages-mcpWhat HasData Yellow Pages 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.
What it helps with
- 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 for the agent
- 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.
How to install HasData Yellow Pages
1Platform CLI
claude mcp add yellowpages -e HASDATA_API_KEY=<HASDATA_API_KEY> -- npx -y @hasdata/yellowpages-mcpReplace <…> with your own values
2Platform CLI: remote server
claude mcp add --transport http hasdata-yellow-pages 'https://mcp.hasdata.com/mcp?apis=yellowpages'1Platform CLI: remote server
codex mcp add hasdata-yellow-pages --url 'https://mcp.hasdata.com/mcp?apis=yellowpages'2Platform CLI
codex mcp add hasdata-yellow-pages --env HASDATA_API_KEY=<HASDATA_API_KEY> -- npx -y @hasdata/yellowpages-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"hasdata-yellow-pages": {
"url": "https://mcp.hasdata.com/mcp?apis=yellowpages"
}
}
}{
"mcpServers": {
"hasdata-yellow-pages": {
"command": "npx",
"args": [
"-y",
"@hasdata/yellowpages-mcp"
],
"env": {
"HASDATA_API_KEY": "<HASDATA_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"hasdata-yellow-pages": {
"type": "http",
"url": "https://mcp.hasdata.com/mcp?apis=yellowpages"
}
}
}{
"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
1Platform CLI: remote server
gemini mcp add -t http hasdata-yellow-pages 'https://mcp.hasdata.com/mcp?apis=yellowpages'2Platform CLI
gemini mcp add -e HASDATA_API_KEY=<HASDATA_API_KEY> hasdata-yellow-pages npx -y @hasdata/yellowpages-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about HasData Yellow Pages
How do I install HasData Yellow Pages in Claude Code?
Run this command: claude mcp add yellowpages -e HASDATA_API_KEY=<HASDATA_API_KEY> -- npx -y @hasdata/yellowpages-mcp.
What does HasData Yellow Pages do?
It adds two MCP tools that query public business records on yellowpages.com and yellowpages.ca, returning search matches and profile details in JSON.
What are the limits on the free tier?
HasData grants 1,000 monthly credits with no credit card requirement. Because each tool request costs 10 credits, that allowance provides around 100 queries each month.
