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.

Servidor MCP alojado

npx add-mcp 'https://companyfinders.com/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

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:

ToolWhat it does
list_business_typesEvery business type that can be searched, with its id. Free.
count_businessesHow 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_listStarts 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_listThe state of a list and, when it is done, every business with what was found. Free.
check_websiteVisits one website now and reports whether it loads, is broken or looks out of date, with the reason. Costs 1 credit ($0.003).
get_balanceHow 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.

WhatOn this siteThrough the API or MCP
How you payOne card payment for each listFrom 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)$3317 credits
The most a list can cost$62,000 credits
CountingFreeFree with a key
Checking one websitePart of every list1 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.