HasData

Yellow Pages MCP Server

Connect your AI agents to HasData's Yellow Pages MCP server. Scrape local business listings with phone, address, hours and ratings, and full business profiles in structured JSON over streamable HTTP.

https://mcp.hasdata.com/api/mcp?apis=yellowpages
Transport
Streamable HTTP
Auth
OAuth or API key
Tools
2 Yellow Pages tools
Price
10 credits / call
Get API Key Read the docs 1,000 free credits. No credit card required.
Data teams at
ClientsClients
Playground

See the Yellow Pages MCP server in action

Select a sample prompt to inspect the tool it chooses and the JSON payload your agent receives.

Yellow Pages · 2 tools Enter to send
Find plumbers in Austin, TX
yellowpages_search · 200 OK sample call
491 plumbers, thirty per page, with a phone number and hours on every card.
1. ARS Rescue Rooter · (833) 947-9225 · open 24 hours
2. Clarke Kent Plumbing · 2.9★ (15) · 1408 W Ben White Blvd · 40 years in business
4. Roto-Rooter Plumbing & Water Cleanup · open 24 hours · 91 years in business
Listings show years in business and current opening status as of right now.
yellowpages_search { "keyword": "plumber", "location": "Austin, TX" }
{
"url": "https://api.hasdata.com/scrape/yellowpages/search?keyword=plumber&location=Austin%2C+TX",
"status": 200,
"json": {
"searchInformation": { "keyword": "plumber", "location": "Austin, TX", "sortOrder": "default", "totalResults": 491 },
"organicResults": [
{ "position": 1, "title": "ARS Rescue Rooter", "phone": "(833) 947-9225", "city": "Austin", "zipcode": "78754",
"workingHours": ["Mo-Su"], "openState": "open 24 hours", "categories": ["Plumbers", "Furnaces-Heating"],
"url": "https://www.yellowpages.com/austin-tx/mip/ars-rescue-rooter-473194899" },
{ "position": 2, "title": "Clarke Kent Plumbing", "rating": 2.87, "reviews": 15, "address": "1408 W Ben White Blvd",
"badges": ["40 Years in Business", "1 Year with Yellow Pages"] }
],
"pagination": { "currentPage": 1, "totalPages": 17, "perPage": 30 }
}
}
Find plumbers in Austin, TX
yellowpages_search · 200 OK sample call
491 plumbers, thirty per page, with a phone number and hours on every card.
1. ARS Rescue Rooter · (833) 947-9225 · open 24 hours
2. Clarke Kent Plumbing · 2.9★ (15) · 1408 W Ben White Blvd · 40 years in business
4. Roto-Rooter Plumbing & Water Cleanup · open 24 hours · 91 years in business
Listings show years in business and current opening status as of right now.
yellowpages_search { "keyword": "plumber", "location": "Austin, TX" }
{
"url": "https://api.hasdata.com/scrape/yellowpages/search?keyword=plumber&location=Austin%2C+TX",
"status": 200,
"json": {
"searchInformation": { "keyword": "plumber", "location": "Austin, TX", "sortOrder": "default", "totalResults": 491 },
"organicResults": [
{ "position": 1, "title": "ARS Rescue Rooter", "phone": "(833) 947-9225", "city": "Austin", "zipcode": "78754",
"workingHours": ["Mo-Su"], "openState": "open 24 hours", "categories": ["Plumbers", "Furnaces-Heating"],
"url": "https://www.yellowpages.com/austin-tx/mip/ars-rescue-rooter-473194899" },
{ "position": 2, "title": "Clarke Kent Plumbing", "rating": 2.87, "reviews": 15, "address": "1408 W Ben White Blvd",
"badges": ["40 Years in Business", "1 Year with Yellow Pages"] }
],
"pagination": { "currentPage": 1, "totalPages": 17, "perPage": 30 }
}
}
Tell me more about ARS Rescue Rooter in Austin
yellowpages_place · 200 OK sample call
ARS Rescue Rooter · Austin, TX 78754 · (833) 947-9225 · open 24 hours, seven days a week
Plumbing plus HVAC. Air conditioner and duct repair, boilers, water heaters, air purification.
Brands serviced include Goodman, Mitsubishi, Bosch and Bradford White.
Takes Visa, Amex and Mastercard. Rated 3.5 on Yellow Pages.
yellowpages_place { "url": "https://www.yellowpages.com/austin-tx/mip/ars-rescue-rooter-473194899" }
{
"url": "https://api.hasdata.com/scrape/yellowpages/place?url=https%3A%2F%2Fwww.yellowpages.com%2Faustin-tx%2Fmip%2Fars-rescue-rooter-473194899",
"status": 200,
"json": {
"overview": { "title": "ARS Rescue Rooter", "city": "Austin", "region": "TX", "zipcode": "78754", "phone": "(833) 947-9225",
"workingHours": ["Mo-Su"], "openState": "Open 24 hours", "paymentAccepted": "visa, amex, master card",
"breadcrumbs": ["TX", "Austin", "Building Contractors", "Plumbers"] },
"ratings": { "rating": 3.5 },
"details": { "servicesProducts": "Air Conditioner Repair and Replacement, Air Duct Repair and Replacement, …",
"brands": "Goodman, Mitsubishi, Bosch, Diakin, Bradford White, April Aire Indoor Air Quality",
"categories": "Plumbers, Air Conditioning Contractors & Systems, …" }
}
}
Which Austin plumbers have the best ratings?
yellowpages_search · 200 OK sample call
Sorted by rating, the top of the list is all five stars on a handful of reviews each.
A Deal Plumbing · 5★ (9) · 17 years in business · open 24 hours
Brad B Plumbing Services · 5★ (8) · 15 years in business
Alice Plumbing Co · 5★ (5) · 79 years in business
Note that these top ratings are based on very few reviews (5–9 each), which is an early signal rather than an established track record.
yellowpages_search { "keyword": "plumber", "location": "Austin, TX", "sort": "averageRating" }
{
"url": "https://api.hasdata.com/scrape/yellowpages/search?keyword=plumber&location=Austin%2C+TX&sort=averageRating",
"status": 200,
"json": {
"searchInformation": { "sortOrder": "averageRating", "totalResults": 491 },
"organicResults": [
{ "position": 1, "title": "A Deal Plumbing", "rating": 5, "reviews": 9, "phone": "(512) 276-7030",
"address": "14521 Sandifer St", "openState": "open 24 hours", "badges": ["17 Years in Business"],
"website": "http://www.getadealplumbing.com" },
{ "position": 2, "title": "Brad B Plumbing Services", "rating": 5, "reviews": 8,
"workingHours": ["Mo-Fr 08:00-17:00", "Sa 08:00-12:00"], "openState": "closed now" }
]
}
}
Dentists in Toronto on the Canadian Yellow Pages
yellowpages_search · 200 OK sample call
4,083 dentists on yellowpages.ca, 35 per page, postal codes in place of ZIPs.
Eglinton West Dental · 5★ (2) · 1114 Eglinton Ave W · opening soon, 7:00 am
Vernon Koo · 1920 Yonge St · opening at 8:00 am
Dr Steven & Dr Jonathan Stern Dentistry · 2-49 Eglinton Ave E
yellowpages_search { "keyword": "dentist", "location": "Toronto, ON", "domain": "www.yellowpages.ca" }
{
"url": "https://api.hasdata.com/scrape/yellowpages/search?keyword=dentist&location=Toronto%2C+ON&domain=www.yellowpages.ca",
"status": 200,
"json": {
"searchInformation": { "keyword": "dentist", "location": "Toronto, ON", "totalResults": 4083 },
"organicResults": [
{ "position": 1, "title": "Eglinton West Dental", "country": "CA", "region": "ON", "city": "Toronto",
"address": "1114 Eglinton Ave W", "zipcode": "M6C 2E2", "phone": "647-484-2557", "rating": 5, "reviews": 2,
"openState": "Opening soon 7:00 am", "website": "http://eglintonwestdental.ca/" }
],
"pagination": { "currentPage": 1, "totalPages": 117, "perPage": 35 }
}
}
Tools

The Yellow Pages tools your agent can call

2 tools

Typed parameters, required flags, and structured JSON fields for each tool. Search yellowpages.com or yellowpages.ca by category and location, sort by rating, distance or name, read phone, address, hours and years in business off each card, then open a listing for its services, brands and payment methods.

+ hasdata_yellowpages_search_getSearchResults Listings for a category and a place 5 params 10 creditsTry
Parameters of hasdata_yellowpages_search_getSearchResults
ParameterTypeRequiredExample
keywordstringrequired"plumber"
locationstringrequired"Austin, TX"
sortenumoptional"averageRating"
domainenumoptional"www.yellowpages.ca"
pagenumberoptional2
response
  • searchInformation
  • organicResults
  • title
  • phone
  • address
  • rating
  • reviews
  • workingHours
  • openState
  • badges
  • categories
  • pagination
+ hasdata_yellowpages_place_getPlaceDetails One listing's full profile 1 param 10 creditsTry
Parameters of hasdata_yellowpages_place_getPlaceDetails
ParameterTypeRequiredExample
urlstringrequired"https://www.yellowpages.com/austin-tx/mip/ars-rescue-rooter-473194899"
response
  • overview
  • ratings
  • details
  • generalInfo
  • servicesProducts
  • brands
  • paymentMethod
  • categories
  • images

Base calls cost 10 credits. Failed calls are not billed.

Connect

One endpoint, any MCP client

A config block for every major MCP client, in its native format. Authenticate with browser OAuth or an x-api-key header.

Claude Code

zsh — hasdata-yellow-pages
$claude mcp add --transport http hasdata-yellow-pages \
> https://mcp.hasdata.com/api/mcp?apis=yellowpages \
> --header "x-api-key: YOUR_API_KEY"
· One line, no restart. Run /mcp to confirm 2 tools.
Check the tools are thereIn the session
/mcp
hasdata-yellow-pages · connected · 2 tools

Cursor

~/.cursor/mcp.json
{
"mcpServers": { "hasdata-yellow-pages": {
"url": "https://mcp.hasdata.com/api/mcp?apis=yellowpages",
"headers": { "x-api-key": "YOUR_API_KEY" }
} }
}
· Add this entry to ~/.cursor/mcp.json. Servers already in the file stay as they are.
· Project-level config also works at .cursor/mcp.json
Check the tools are thereAfter saving the file
Settings → MCP
hasdata-yellow-pages · 2 tools enabled

Claude Desktop

Recommended · OAuth connector
1.Settings → Connectors → Add custom connector
2.Paste https://mcp.hasdata.com/api/mcp?apis=yellowpages
3.Sign in with HasData
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": { "hasdata-yellow-pages": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.hasdata.com/api/mcp?apis=yellowpages",
"--header", "x-api-key:YOUR_API_KEY"]
} }
}
· Add this entry to ~/Library/Application Support/Claude/claude_desktop_config.json. Servers already in the file stay as they are.
· The config file only takes stdio servers, so a static key rides the mcp-remote bridge. On Windows the file lives at %APPDATA%\Claude\claude_desktop_config.json.
Check the tools are thereReopen the app
Settings → Connectors
hasdata-yellow-pages · connected · 2 tools

VS Code / Copilot

.vscode/mcp.json
{
"servers": { "hasdata-yellow-pages": {
"type": "http",
"url": "https://mcp.hasdata.com/api/mcp?apis=yellowpages",
"headers": { "x-api-key": "YOUR_API_KEY" }
} }
}
· Add this entry to .vscode/mcp.json. Servers already in the file stay as they are.
· Agent mode picks the server up on save.
Check the tools are thereAgent mode
Ctrl/⌘ + Shift + P → MCP: List Servers
hasdata-yellow-pages · running · 2 tools

Windsurf

~/.codeium/windsurf/mcp_config.json
{
"mcpServers": { "hasdata-yellow-pages": {
"serverUrl": "https://mcp.hasdata.com/api/mcp?apis=yellowpages",
"headers": { "x-api-key": "YOUR_API_KEY" }
} }
}
· Add this entry to ~/.codeium/windsurf/mcp_config.json. Servers already in the file stay as they are.
· Windsurf reads serverUrl, not url. Header auth only.
Check the tools are thereIn Cascade
Cascade → MCP servers
hasdata-yellow-pages · 2 tools

Cline

cline_mcp_settings.json
{
"mcpServers": { "hasdata-yellow-pages": {
"type": "streamableHttp",
"url": "https://mcp.hasdata.com/api/mcp?apis=yellowpages",
"headers": { "x-api-key": "YOUR_API_KEY" }
} }
}
· Add this entry to cline_mcp_settings.json. Servers already in the file stay as they are.
· Header auth only. The type field tells Cline this is a remote server, not a command.
Check the tools are thereIn the MCP panel
MCP Servers → Installed
hasdata-yellow-pages · 2 tools

ChatGPT / Agents SDK

Recommended · OAuth connector
1.Settings → Security and login → Developer mode
2.Plugins → + → developer-mode app, paste https://mcp.hasdata.com/api/mcp?apis=yellowpages
3.Sign in with HasData
agent.py
from agents import Agent, HostedMCPTool
tool = HostedMCPTool(tool_config={
"type": "mcp",
"server_label": "hasdata-yellow-pages",
"server_url": "https://mcp.hasdata.com/api/mcp?apis=yellowpages",
"authorization": "YOUR_API_KEY",
"require_approval": "never",
})
agent = Agent(name="Researcher", tools=[tool])
· The Agents SDK sends authorization as a Bearer token, which the endpoint accepts. The ChatGPT route needs no key: it signs in with OAuth.
Check the tools are thereRun the agent
Runner.run(agent, "…")
hasdata-yellow-pages · 2 tools listed

Codex CLI

~/.codex/config.toml
[mcp_servers.hasdata-yellow-pages]
url = "https://mcp.hasdata.com/api/mcp?apis=yellowpages"
env_http_headers = { "x-api-key" = "HASDATA_API_KEY" }
· Add this entry to ~/.codex/config.toml. Servers already in the file stay as they are.
· TOML, not JSON. Codex reads the key from the HASDATA_API_KEY environment variable, so export it in the shell that starts Codex.
Check the tools are thereIn the terminal
codex mcp list
hasdata-yellow-pages · 2 tools

Gemini CLI

~/.gemini/settings.json
{
"mcpServers": { "hasdata-yellow-pages": {
"httpUrl": "https://mcp.hasdata.com/api/mcp?apis=yellowpages",
"headers": { "x-api-key": "YOUR_API_KEY" }
} }
}
· Add this entry to ~/.gemini/settings.json. Servers already in the file stay as they are.
· httpUrl, not url: Gemini keeps url for SSE servers. Header auth only.
Check the tools are thereIn the session
/mcp
hasdata-yellow-pages · 2 tools

Raw HTTP / curl

zsh — hasdata-yellow-pages
$curl -N https://mcp.hasdata.com/api/mcp?apis=yellowpages \
> -H "x-api-key: YOUR_API_KEY" \
> -H "Content-Type: application/json" \
> -H "Accept: application/json, text/event-stream" \
> -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
· Fallback for any client not listed. Streamable HTTP wants both Accept types, and leaving one out returns 406.
Check the tools are thereCall it yourself
curl … tools/list
{ "tools": [ … 2 items ] }
Scope

Yellow Pages plus whatever else you need

Name the services in the query string and the server exposes only their tools. Every one draws from the same key and the same balance.

Yellow Pages 2 tools See the full MCP server →
https://mcp.hasdata.com/api/mcp?apis=yellowpages,google_maps,yelp
11tools in your server
Build vs Buy

Free on GitHub, paid in hours

Anyone can clone a free MCP to scrape Yellow Pages. Whether that stays free depends on the shape of your project.

Scenario

A script I run once

Self-hosted from GitHubyour machine, your upkeep
$0/ mo, runs locally
+ 3–6 h onceof someone’s time
Setup (clone, wire, run)3–6 h once
Markup changesnot yet
Retries and concurrencynot needed
Proxy and hosting$0
Nothing to own. You get the answer and delete the folder.
mcp.hasdata.comFree tier
$0/ mo
+ 0 hof someone’s time
Setup one line
Parser upkeep included
Retries and concurrency included
~25 calls 250 of 1,000 credits
The free tier renews every month. No card.
leans self-hosted
Take the free repo
Nothing has to keep working tomorrow, so upkeep never appears. Both cost nothing, so take whichever is already in front of you.

A weekly report

Self-hosted from GitHubyour machine, your upkeep
$0–40/ mo
+ 2–4 h / moof someone’s time
Setup (proxy, hosting, wiring)3–6 h once
Markup changes2–4 h / mo
Retries and concurrency2–4 h once
Proxy and hosting$0–40 / mo
Someone looks at it when the numbers come back wrong, which is how you find out.
mcp.hasdata.comFree tier
$0/ mo
+ 0 hof someone’s time
Setup one line
Parser upkeep included
Retries and concurrency included
~100 calls a month 1,000 of 1,000 credits
Exactly the free tier, so a heavier month moves you to Startup.
dead even
Either works
The repo is free if you have somewhere to run it, ours is free up to the credit ceiling. The two to four hours a month decide it.

A pipeline in production

Self-hosted from GitHubyour machine, your upkeep
$40–120/ mo
+ 6–10 h / moof someone’s time
Setup (proxy, hosting, wiring)3–6 h once
Markup changes2–4 h / mo
Retries, concurrency, rate limits4–8 h once
Proxy and hosting$40–120 / mo
Someone owns this permanently, and it is never the top of their list.
mcp.hasdata.comStartup, 200K credits, 5 concurrent
$49/ mo
+ 0 hof someone’s time
Setup one line
Parser upkeep included
Retries and concurrency included
5,000 calls 50K of 200K credits
A quarter of the plan used, and the rest is headroom.
leans hosted
Use the hosted server
The proxy and hosting bill alone is in the range of the whole plan, and that is before anyone spends the six to ten hours.

A feature in my product

Self-hosted from GitHubyour machine, your upkeep
$300+/ mo
+ on-callof someone’s time
Setup (proxy, hosting, wiring)3–6 h once
Markup changes, plus on-call2–4 h / mo
Retries, concurrency, rate limitsongoing
Proxy and hosting$300+ / mo
The thing your customers touch depends on one volunteer's spare evening.
mcp.hasdata.comBasic, 1M credits, 15 concurrent
$99/ mo
+ 0 hof someone’s time
Setup one line
Parser upkeep included
Retries and concurrency included
50,000 calls 500K of 1M credits
Same endpoint at ten calls and at ten million. One invoice.
leans hosted
Use the hosted server
A third of the price, and nobody has to carry a pager for a dependency your customers touch.
Pricing

One balance, every interface

A flat monthly price against a known credit ceiling. Move up a plan when you outgrow it.

Free
$0 /mo
Free forever
100 tool calls / month
1,000 credits / month
1 concurrent request
Every MCP tool on every plan
Failed calls are not billed
One balance across MCP and REST
Community support
Start free
Startup
$49 /mo
$2.46 / 1k tool calls
20K tool calls / month
200K credits / month
5 concurrent requests
Every MCP tool on every plan
Failed calls are not billed
One balance across MCP and REST
Email support
Get started
Basic
Recommended
$99 /mo
$0.99 / 1k tool calls
100K tool calls / month
1M credits / month
15 concurrent requests
Every MCP tool on every plan
Failed calls are not billed
One balance across MCP and REST
Priority email support
Get started
Growth
$208 /mo
$0.69 / 1k tool calls
3M credits / month
50 concurrent requests
Every MCP tool on every plan
Failed calls are not billed
One balance across MCP and REST
Dedicated account manager
Get started
Monthly tool call volume
Free 100K 500K 2M
Best fit
Basic
tool calls / mo
100K
Concurrency
15
$ / 1k tool calls
$0.99
$99 /mo
Get Started
Enterprise
Custom price based on required volume

Past 20M credits a month, or terms the self-serve plans do not cover. We shape the contract around your workload.

Credits rollover
Unused credits carry into the next billing period.
Concurrency 2000+
Parallel request limits set to your peak load.
#1 request priority
Highest speed, always first in the queue.
Personal manager
A direct line to the founding team.
SSO
SAML single sign-on for the whole team.
SOC-2 compliance
Security review, DPA, and audit reports.
Talk to sales Quote within one business day

The same data, without the agent

▤ Yellow Pages Scraper APIA category and a city in, the listings out. Scraper API ▤ Yellow Pages ScraperEnter categories and cities, export CSV, Excel or JSON. No-Code
FAQ

Before you wire it in

Do I need a Yellow Pages account?

No. The tools read the public listing pages a signed-out visitor sees, so the only credential is your HasData key.

Does it cover Canada?

Yes. Set domain to www.yellowpages.ca and the search runs against the Canadian directory, with the same field names. The default is www.yellowpages.com.

Where do I get a listing URL for the details tool?

Every search result carries url. Pass it to the place tool as is. A Yellow Pages link copied from a browser works the same way.

Which sort orders are there?

sort takes default, distance, averageRating or name. The response echoes the order it used in searchInformation.sortOrder.

How do I page through results?

Send page. Each response reports totalPages and perPage, so the agent knows the size of a search before it walks it.

What is in a business profile?

The overview with phone, hours, payment methods and badges, the rating, and a details block with the business description, services and products, brands carried and categories. Photos come as a list of image URLs.

How fresh is the data? Is anything cached?

Every tool call fetches the page at that moment, so a listing updated this morning is already reflected. Nothing is served from a cache.

How many calls can run in parallel?

One on the free tier, five on Startup, fifteen on Basic, and fifty on Growth. The larger Growth volumes raise it to 200, 300 and 500.

What happens when I run out of credits?

Nothing is charged on top of the plan. Calls stop until the billing cycle renews.

Does it work with Claude Desktop, Cursor, VS Code and Claude Code?

Yes, all four, plus anything else that speaks MCP over streamable HTTP. Claude Desktop connects through OAuth, and the rest take the URL and an API key header.

Is HasData affiliated with Yellow Pages?

No. HasData is an independent service and is not affiliated with, endorsed by, or sponsored by Thryv, Inc. or Yellow Pages Limited. Yellow Pages is a trademark of its respective owners.