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
1 credit per callRequest
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": { "credits_charged": 1, "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 lookup1 credit / call
- Bulk company lookup1 credit / item
- Website status1 credit / call
- Email pattern2 credits / call
- Company search2 credits / 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 company1 credit / call
- Bulk IP to company1 credit / 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 grade5 credits / call
- AI crawler access2 credits / call
- WebMCP check2 credits / call
- Email authentication check2 credits / 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 scan5 credits / call
- Lead check3 credits / call
- Email verify1 credit / call
- Monitor an MCP server5 credits / 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 search10 credits / item
- Email finder15 credits / call
- Person enrichment10 credits / 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. The first 1,000 credits each month are free, and no card is asked for.
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.
Pay only past the allowance
Every response says what it cost. Go past the free credits and you add a card; a monthly cap you control stops anything beyond it.
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 refund their credit. A site or DNS server we could not read comes back as unknown and is refunded, never reported as a failure of yours.
No people data
Every tool here returns company, network or website facts. The email-pattern tool returns a company’s address format, never a person’s address, and nothing here returns data about an individual.
Pricing
Separate from the BusinessMCP plans: the Data API is billed on its own, per credit, and a card is only needed past the free allowance.
Every month
1,000
free credits for BusinessMCP’s own tools, reset on the 1st (UTC). No card needed until you go past them.
After that, graduated
- First 100,000 billable credits$2.00 per 1,000 credits
- 100,001 to 1,000,000 billable credits$1.20 per 1,000 credits
- Above 1,000,000 billable credits$0.80 per 1,000 credits
A new paying account is capped at 50,000 billable credits a month ($100 at the first tier) until you change it — anywhere from 1,000 to 50,000,000. Keys can carry a cap of their own.
| Price | Covered free each month | List price per 1,000 | |
|---|---|---|---|
| Company lookup | 1 credit per call, only when a result is found | 1,000 calls | $2.00 per 1,000 calls |
| Bulk company lookup | 1 credit per item, only when a result is found | 1,000 items | $2.00 per 1,000 items |
| Website status | 1 credit per call, only when a result is found | 1,000 calls | $2.00 per 1,000 calls |
| Email pattern | 2 credits per call, only when a result is found | 500 calls | $4.00 per 1,000 calls |
| Company search | 2 credits per item, only when a result is found | 500 items | $4.00 per 1,000 items |
| IP to company | 1 credit per call | 1,000 calls | $2.00 per 1,000 calls |
| Bulk IP to company | 1 credit per item | 1,000 items | $2.00 per 1,000 items |
| AI readiness grade | 5 credits per call | 200 calls | $10.00 per 1,000 calls |
| AI crawler access | 2 credits per call | 500 calls | $4.00 per 1,000 calls |
| WebMCP check | 2 credits per call | 500 calls | $4.00 per 1,000 calls |
| Email authentication check | 2 credits per call | 500 calls | $4.00 per 1,000 calls |
| MCP server scan | 5 credits per call | 200 calls | $10.00 per 1,000 calls |
| Lead check | 3 credits per call | 333 calls | $6.00 per 1,000 calls |
| Email verify | 1 credit per call | 1,000 calls | $2.00 per 1,000 calls |
| Monitor an MCP server | 5 credits per call | 200 calls | $10.00 per 1,000 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 | 10 credits per item, only when a result is found | 100 items | $20.00 per 1,000 items |
| Email finder | 15 credits per call, only when a result is found | 66 calls | $30.00 per 1,000 calls |
| Person enrichment | 10 credits per call, only when a result is found | 100 calls | $20.00 per 1,000 calls |
When something else is the better choice
- If you need contacts and verified personal email addresses, this is not it today: there are no people tools in the catalogue, and a people-data vendor is the right purchase.
- 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
What is a credit?
The unit every tool is priced in. Each tool costs a fixed number of credits per call, or per item for the bulk tools, and every response reports what it charged in meta.credits_charged. The first 1,000 credits each calendar month are free for BusinessMCP’s own tools; after that the graduated price starts at $2.00 per 1,000 credits and falls to $0.80 at volume.
Do I need a credit card to start?
No. A card is only needed once you go past the free allowance. Until then a call that would need billing is refused with HTTP 402 and an upgrade_url, never charged. Paying accounts start with a cap of 50,000 billable credits a month, which you can change.
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: an IP that resolves to an ISP, or a site graded C, 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.
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 free credits are 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 | 1,000 free credits/mo · then $2.00 per 1,000 | 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 |