Data API · REST and MCP
Company and IP data, as an API your agents can call
Look up any company by domain, resolve an IP to the business behind it, and check websites — over REST or MCP, with one key, priced per call.
IP to company
$0.02 per call, only when a result is foundRequest
curl https://businessmcp.com/api/hub/v1/ip/17.253.144.10 \
-H "Authorization: Bearer $BUSINESSMCP_API_KEY"Example response
{
"ok": true,
"data": {
"ip": "17.253.144.10",
"verdict": "company",
"network_class": "business",
"company": {
"name": "Apple Inc.",
"domain": "apple.com"
},
"name_hint": null,
"confidence": 0.95,
"country": "US",
"asn": 714,
"network": "17.0.0.0/8",
"sources": [
"bgp",
"arin",
"swip"
],
"flags": {
"hosting": false,
"isp_or_mobile": false,
"cdn_edge": false,
"secure_egress": false,
"sase_dedicated": false
},
"graph_version": "v20260926"
},
"meta": { "cost_usd": "$0.02", "request_id": "…" }
}What’s included
22 tools in 5 groups, all built and run by us. Each one is a REST endpoint and an MCP tool at the same time.
Company data API
Send a domain, a URL or a work email. Get back the company behind it — and pay only when we find one.
- Company lookup$0.02 per call
- Bulk company lookup$0.02 per item
- Website status$0.005 per call
- Email pattern$0.01 per call
- Company search$0.01 per item
IP to company API
Resolve an IP address to the company, ISP, cloud or VPN behind it, from our own nightly IP graph rather than a resold feed.
- IP to company$0.02 per call
- Bulk IP to company$0.02 per item
Website checks API
The checks behind our free tools, callable per domain from your own code or agent: AI readiness, AI crawler access, WebMCP and email authentication.
- AI readiness grade$0.03 per call
- AI crawler access$0.01 per call
- WebMCP check$0.01 per call
- Email authentication check$0.01 per call
Email verification, MCP monitoring and lead check API
Check an address before you send to it, an MCP server before your agent trusts it, and a lead before your team does.
- MCP server scan$0.05 per call
- Lead check$0.015 per call
- Email verify$0.002 per call
- Monitor an MCP server$0.05 per call
- List MCP monitorsFree
- MCP monitor eventsFree
- Update an MCP monitorFree
- Delete an MCP monitorFree
People data API
Named business contacts with their work email and LinkedIn, from a store we build ourselves, with every opt-out honoured before a record leaves.
- People search$0.08 per item
- Email finder$0.04 per call
- Person enrichment$0.10 per call
How it works
One key, two ways in, one bill.
Get a key
Sign up and create an mcph_ key in the developer portal. Save a card on the Billing page and you get $5 free for 7 days on our own tools; the card is not charged.
Call it over REST or MCP
The same key and the same tools answer a curl request, your backend, or an agent in Claude, Cursor or any MCP client.
Prepay, then pay per call
Every response says what it cost and what is left. Add balance from $10 when you need it; there is no subscription and no bill afterwards.
From code, or from any agent
REST lives at https://businessmcp.com/api/hub/v1; the MCP server at https://businessmcp.com/api/hub/mcp. Both take Authorization: Bearer mcph_….
REST
Every tool has a readable route, and every tool is also callable at POST /tools/{id}/call.
curl https://businessmcp.com/api/hub/v1/companies/stripe.com \
-H "Authorization: Bearer $BUSINESSMCP_API_KEY"MCP
Claude Desktop or Cursor config. The server adds hub_search_tools and hub_call_tool for discovery.
{
"mcpServers": {
"businessmcp": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://businessmcp.com/api/hub/mcp",
"--header",
"Authorization: Bearer mcph_YOUR_KEY_HERE"
]
}
}
}Claude Code
claude mcp add --transport http businessmcp https://businessmcp.com/api/hub/mcp \
--header "Authorization: Bearer mcph_YOUR_KEY_HERE"Claude.ai and ChatGPT accept OAuth only, so they reach these tools through your BusinessMCP workspace endpoint instead — billed the same way. Every other client config is in the API reference.
Why this one
An IP graph we build ourselves
IP to company is answered from a graph we compile every night from public registry, routing and DNS data — not a resold vendor feed. It separates companies from ISPs, clouds, VPNs and secure-egress gateways, and says which it is.
The engines our own product runs on
These are the lookups behind BusinessMCP’s cookieless analytics and visitor identification, with the same checks that stop one business’s listing being reported under another company’s domain.
How we identify visitorsHonest misses
Lookups that find nothing cost nothing. A site or DNS server we could not read comes back as unknown and is refunded, never reported as a failure of yours.
People data with hard limits
The people tools return named business contacts only. Nobody we place in the EU, the EEA, the UK, Switzerland or California, Texas, Vermont and Oregon is returned, nor anyone we cannot place. Every record is checked against our opt-out list before it leaves, and every disclosure is logged. They need purchased balance and accepted terms; the free trial never pays for them.
Our data-broker disclosurePricing
Separate from the BusinessMCP plans: the Data API runs on its own prepaid balance, priced per call in dollars, with a one-time free trial to start.
Free trial
$5
once, for 7 days, on BusinessMCP’s own tools. It starts when you save a card, which is not charged.
Then prepaid balance
- Pay $10$10 of balance
- Pay $50$55 of balance+$5 bonus (10%)
- Pay $200$240 of balance+$40 bonus (20%)
- Pay $1,000$1,300 of balance+$300 bonus (30%)
Each call is taken from your balance at the price below. No subscription and no invoice later: an empty balance refuses the call. Any key can carry a monthly spend limit of its own.
| Price | Covered by the $5 trial | What $10 buys | |
|---|---|---|---|
| Company lookup | $0.02 per call, only when a result is found | 250 calls | 500 calls |
| Bulk company lookup | $0.02 per item, only when a result is found | 250 items | 500 items |
| Website status | $0.005 per call, only when a result is found | 1,000 calls | 2,000 calls |
| Email pattern | $0.01 per call, only when a result is found | 500 calls | 1,000 calls |
| Company search | $0.01 per item, only when a result is found | 500 items | 1,000 items |
| IP to company | $0.02 per call, only when a result is found | 250 calls | 500 calls |
| Bulk IP to company | $0.02 per item, only when a result is found | 250 items | 500 items |
| AI readiness grade | $0.03 per call | 166 calls | 333 calls |
| AI crawler access | $0.01 per call | 500 calls | 1,000 calls |
| WebMCP check | $0.01 per call | 500 calls | 1,000 calls |
| Email authentication check | $0.01 per call | 500 calls | 1,000 calls |
| MCP server scan | $0.05 per call | 100 calls | 200 calls |
| Lead check | $0.015 per call | 333 calls | 666 calls |
| Email verify | $0.002 per call | 2,500 calls | 5,000 calls |
| Monitor an MCP server | $0.05 per call | 100 calls | 200 calls |
| List MCP monitors | Free | Unlimited | Free |
| MCP monitor events | Free | Unlimited | Free |
| Update an MCP monitor | Free | Unlimited | Free |
| Delete an MCP monitor | Free | Unlimited | Free |
| People search | $0.08 per item, only when a result is found | None, paid balance only | 125 items |
| Email finder | $0.04 per call, only when a result is found | None, paid balance only | 250 calls |
| Person enrichment | $0.10 per call, only when a result is found | None, paid balance only | 100 calls |
When something else is the better choice
- If you need contacts in Europe, the UK, Switzerland or California, Texas, Vermont and Oregon, this is not it: those people are never returned. Addresses built from a company’s email format are labelled pattern and unverified, and people calls are paid from purchased balance only.
- IP identification is only as good as the network. Home and mobile connections name no company, so a large share of real visitors resolve to an ISP — and we will not guess a company for them.
- There is no file-upload or asynchronous batch job. Bulk tools take a bounded list per request, so enriching a million rows is a lot of requests.
- It is new. There is no published uptime SLA or status page yet, and the catalogue is our own tools only.
Frequently asked questions
How does pricing work?
Prepaid, in dollars. Each tool has a fixed price per call, or per item for the bulk tools, and every response reports what it cost in meta.cost_usd along with the balance left. You add balance in packs from $10; bigger packs add up to 30% bonus balance. There is no subscription and no monthly invoice.
Is there a free trial?
Yes, once: $5 free for 7 days on BusinessMCP’s own tools, not people data. It starts when you save a card on the Billing page, and the card is not charged. One trial per person and per card. When the trial and balance are both empty, a call is refused with HTTP 402 insufficient_balance and a link to add balance — never charged later.
What am I charged when a lookup finds nothing?
Tools marked "only when a result is found" refund a miss — an unknown domain in a company lookup costs nothing. The others charge per call because the answer is the result: a site graded C, or an address checked, is still an answer. Any call that fails on our side is refunded.
Can I use it from Claude, ChatGPT or Cursor?
Yes. Clients that take a bearer key — Claude Code, Claude Desktop, Cursor, VS Code — connect to the Hub MCP endpoint directly and see every tool. Claude.ai and ChatGPT only accept OAuth, so they reach the same tools through your BusinessMCP workspace endpoint, which carries hub_company_lookup, hub_ip_lookup, hub_lead_check, hub_email_auth_check, hub_ai_readiness, hub_search_tools, hub_call_tool. Billing is identical either way.
Is this the same key as my BusinessMCP workspace?
It can be. One mcph_ key reaches both the workspace endpoint and the Hub, and a key can be narrowed to the Hub only, in which case it never sees workspace data.
Where does the data come from?
IP answers come from our own IP graph, rebuilt nightly from public internet registry, routing and DNS data. Company answers come from our company store, assembled from public registries, open datasets and our own crawl of company websites. The website checks fetch the site when you call them. People answers come from our own people store, checked against our opt-out list on every call.
Is there an OpenAPI document?
Yes, generated from the same registry as the tools, at https://businessmcp.com/api/hub/v1/openapi.json, and the catalogue with every input schema and price is public at https://businessmcp.com/api/hub/v1/tools — no key needed.
Make your first call in a minute
Create a key, paste the curl above, and read what it cost in the response. The $5 trial is enough to find out whether it fits.
Data APIs, side by side
Company, IP, email and people data APIs compared — per-call pricing, what each returns, and what each refuses to guess.
| Real-world price | Company by domain | IP to company | Email finding / verification | MCP server included | |
|---|---|---|---|---|---|
| BusinessMCP | $5 free for 7 days · then prepaid from $10 | Yes | Yes | Pattern + MX checks (no SMTP) | Yes |
| Clearbit / HubSpot Breeze | Inside paid HubSpot plans; no new API keys | Inside HubSpot only | Buyer intent inside HubSpot | No | HubSpot CRM MCP (reads records) |
| ZoomInfo (GTM.AI) | 1,000 free data credits · ~$0.38/credit | Yes | WebSights (platform module) | Contacts in its database | Yes |
| Apollo.io API | Free · $49–$119/seat/mo annual + credits | Yes | No | Email reveal 1 credit · phone 8 | Paid plans |
| Crunchbase API | Enterprise licence, quoted | Firmographics + funding | No | No | Follows your package |
| Hunter.io | Free 50 credits · $49–$299/mo | Company Enrichment API | No | Finder + SMTP verifier | Yes |
| IPinfo | Lite free · $26–$163/mo · Enterprise | No | Company field on Enterprise | No | Yes |