Company Finders
Count the local businesses with no website in a city, free. For $3 we open every listed website and tell you which are broken or out of date.
เซิร์ฟเวอร์ MCP แบบโฮสต์
npx add-mcp 'https://companyfinders.com/mcp'ติดตั้งลง Claude Code, Codex, Cursor และอื่นๆ
เอกสาร
API and MCP server
Everything the site does is available from your own code and from an AI assistant. You pay from a balance of credits at $3 per 1,000, where one credit is one business in a list or one website check. Counting is free once you have a key, the smallest balance is $9, and no list has a minimum.
Get a key
Choose a balance and pay by card, and the next page shows your key. There is no sign-up, because the key is your account. One credit pays for one business in a list or one website check, and credits do not expire.
A key you already have
Paste your key to see how many credits it holds, or choose an amount to add, and the balance is added to the same key.
How it works
Send your key with every call, in a header: Authorization: Bearer YOUR_KEY. Answers are JSON. An error looks like {"error":{"code":"...","message":"..."}} and costs nothing. A key may make 120 calls a minute.
The business listings come from Google Maps, and the website check is ours, made at the moment of your call. A business reported with no website may still have one it never linked. A site reported as could_not_check turned our checker away, so it is not known to be broken.
Endpoints
All under https://companyfinders.com/api/v1.
GET /count · Free
How many businesses of a type near a city list no website and how many list one, and what the full list would cost. Takes type, city, radius_km (10, 25 or 50) and min_reviews (0, 5 or 20).
curl "https://companyfinders.com/api/v1/count?type=plumber&city=Austin,%20TX&radius_km=25" \
-H "Authorization: Bearer YOUR_KEY"
It answers:
{
"type": "plumber", "city": "Austin, TX", "radius_km": 25,
"no_website": 85, "with_website": 232,
"list_size": 317, "list_cost_credits": 317, "list_cost_usd": 0.96,
"counted_on": "2026-11-17"
}
POST /lists · 1 credit per business
Starts building a list: every business, with each listed website visited now. Takes the same four things as /count. Answers at once with an id. The credits are held when the build starts, and any the list did not use come back.
curl -X POST "https://companyfinders.com/api/v1/lists?type=plumber&city=Austin,%20TX" \
-H "Authorization: Bearer YOUR_KEY"
GET /lists/{id} · Free
Where a list stands and, when its status is done, every business with what we found. Add format=csv for the file. A build takes one to three minutes, so ask again every few seconds.
curl "https://companyfinders.com/api/v1/lists/LIST_ID?format=csv" \
-H "Authorization: Bearer YOUR_KEY" -o list.csv
It answers:
{
"id": "9ed5fd46-8cdf-4c0c-8fe1-c219a3e4cfbc", "status": "done",
"type": "barber_shop", "city": "boulder-co", "radius_km": 10,
"websites_checked": 30, "websites_to_check": 30,
"businesses": 43, "leads": 15,
"results": { "no_website": 13, "broken": 1, "out_of_date": 1, "loads_fine": 28, "could_not_check": 0 },
"data": [ { "name": "...", "phone": "...", "result": "No website", "what_we_found": "No website listed", "...": "the same columns as the file" } ]
}
GET /check · 1 credit
Visits one website now and says whether it loads, is broken or looks out of date, with the reason, an email shown on the page and what the site is built with. Takes url.
curl "https://companyfinders.com/api/v1/check?url=example.com" \
-H "Authorization: Bearer YOUR_KEY"
GET /types · Free
Every business type you can search, with its id.
curl "https://companyfinders.com/api/v1/types" -H "Authorization: Bearer YOUR_KEY"
GET /cities · Free
Cities whose name starts with q, written the way the other calls take them.
curl "https://companyfinders.com/api/v1/cities?q=aus" -H "Authorization: Bearer YOUR_KEY"
GET /balance · Free
How many credits your key holds.
curl "https://companyfinders.com/api/v1/balance" -H "Authorization: Bearer YOUR_KEY"
MCP server
An MCP server lets an AI assistant use Company Finders as a tool, so you ask in plain words and the assistant makes the calls. The address is https://companyfinders.com/mcp (streamable HTTP), and it takes the same key in the same header. Claude Code, Claude Desktop, Cursor and other apps that read a JSON settings file use this:
{
"mcpServers": {
"company-finders": {
"type": "http",
"url": "https://companyfinders.com/mcp",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}
These are the tools it offers:
| Tool | What it does |
|---|---|
list_business_types | Every business type that can be searched, with its id. Free. |
count_businesses | How many businesses of a type near a city list no website, and how many list one, with what the full list would cost. Free. |
build_list | Starts building the full list: every business, with each listed website visited now. Costs 1 credit per business ($3 per 1,000), taken when the build starts; unused credits come back. Returns an id; call get_list with it until status is done. |
get_list | The state of a list and, when it is done, every business with what was found. Free. |
check_website | Visits one website now and reports whether it loads, is broken or looks out of date, with the reason. Costs 1 credit ($0.003). |
get_balance | How many credits this key holds. Free. |
Prices and limits
The rate is the same as on the site and the way you pay is different, so a small list costs less here. The site takes one card payment for each list, which is why a list there costs at least $3, while a balance is paid for before you use it.
| What | On this site | Through the API or MCP |
|---|---|---|
| How you pay | One card payment for each list | From a balance of credits you buy first |
| The rate | $3 per 1,000 businesses | $3 per 1,000 credits, and 1 credit is 1 business |
| The smallest payment | $3, for any list of up to 1,000 businesses | $9, for a balance of 3,000 credits |
| A list of 317 businesses (plumbers within 25 km of Austin, TX) | $3 | 317 credits |
| The most a list can cost | $6 | 2,000 credits |
| Counting | Free | Free with a key |
| Checking one website | Part of every list | 1 credit ($0.003) |
- 1 credit is 1 business in a list, or 1 website check. Credits cost $3 per 1,000.
- A list holds at most 2,000 businesses, so it costs at most 2,000 credits ($6).
- A key may count 200 searches a day and make 120 calls a minute.
- Pricing in full. Terms and privacy.