# MyDataHub developer docs

> Count, preview and quote UK B2B contacts for free, then order by REST, MCP or the app. One credit buys one complete UK record.

Source: https://emailmovers.com/mydatahub/docs/
Updated: 16 October 2026

MyDataHub by Emailmovers is the UK B2B count engine. Counts, breakdowns, masked samples and quotes cost 0 credits and need no account. You pay only when you order records, at 1 credit per complete UK record, at the same price in the app, the REST API and the MCP server.

> **Not yet live.** MyDataHub v2 is built and tested locally and is not yet live. Its host, mydatahub.emailmovers.com, opens at launch with these docs, date to confirm. Today https://mcp.mydatahub.uk and https://app.mydatahub.uk serve the current product, whose 13 MCP tools are replaced by the 22 described here.

## Choose your starting point

| You are | Start with | What you do |
| --- | --- | --- |
| Using the app | [Quickstart for people](https://emailmovers.com/mydatahub/docs/quickstart/people.md) | Describe an audience, read the count and a masked sample, order |
| Writing code | [Quickstart for developers](https://emailmovers.com/mydatahub/docs/quickstart/developers.md) | Count, quote and order with curl and TypeScript |
| Building or running an agent | [Quickstart for agents](https://emailmovers.com/mydatahub/docs/quickstart/agents.md) | Connect Claude, ChatGPT or Cursor to the MCP server |
| Using today's 13 MCP tools or `RunExtract` | [Migration guide](https://emailmovers.com/mydatahub/docs/migrate.md) | Map every old call to its replacement |

## The rules that never change

1. **Looking is free.** The filter catalogue, title expansion, location resolution, counts, breakdowns, masked samples, machine quotes and plans cost 0 credits and need no account.
2. **One credit, one record.** A credit buys one complete UK record. Duplicates, suppressed records, records you already hold and failed lookups cost 0.
3. **Quote, then confirm.** A spend needs a machine `quote_id` plus a person's confirmation or an agent key within its limits. A flag set by a model is never consent. See [Spending safely](https://emailmovers.com/mydatahub/docs/spending-safely.md).
4. **One audience definition.** Chips in the app, a brief compiled by an agent and a JSON document sent over REST all produce the same count, the same breakdown and the same id. See [The audience definition](https://emailmovers.com/mydatahub/docs/audience.md).
5. **Counts replay.** A count id is content addressed and re-runs exactly for 12 months on its pinned dataset version. See [Versions and reproducibility](https://emailmovers.com/mydatahub/docs/versions.md).

## What is behind the counts

On 26 September 2026 the database held 9,028,587 records at active companies. Of those, 1,660,190 had an email address, 1,605,275 had a named-person email and 1,277,443 of those were at Manager level or above. Counts for the same audience are identical in the app, the API and the MCP server.

## Where things live

| Surface | Address | Status |
| --- | --- | --- |
| App | https://mydatahub.emailmovers.com | Not yet live. Today's product is at https://app.mydatahub.uk |
| REST API | https://mydatahub.emailmovers.com/v1 | Not yet live |
| MCP server | https://mydatahub.emailmovers.com/mcp | Not yet live. Today https://mcp.mydatahub.uk serves 13 tools. It keeps serving today's product after launch, until the new server supports OAuth sign-in from the client, and then passes MCP through to it |
| OAuth 2.1 issuer | https://mydatahub.emailmovers.com/id | Not yet live. At launch it signs you in to the app; REST and MCP clients use an API key, and OAuth sign-in for them is planned for after launch |
| These docs | https://emailmovers.com/mydatahub/docs/ | Built, not yet published |

## For agents reading this site

Every page has a Markdown twin at the same path with `.md`, such as `/quickstart/developers.md`. The index is [llms.txt](https://emailmovers.com/mydatahub/docs/llms.txt), and the guides, problem types and reference indexes are in one file at [llms-full.txt](https://emailmovers.com/mydatahub/docs/llms-full.txt). The OpenAPI 3.1 document is at [/reference/openapi.json](https://emailmovers.com/mydatahub/docs/reference/openapi.json).

## All guides

- [Audience definition](https://emailmovers.com/mydatahub/docs/audience.md): the JSON document every count starts from.
- [Counts and breakdowns](https://emailmovers.com/mydatahub/docs/counts.md): Total, New to you, Emailable, and what disclosure control does to small numbers.
- [Samples](https://emailmovers.com/mydatahub/docs/samples.md): masked previews with why each record matches.
- [Quotes and orders](https://emailmovers.com/mydatahub/docs/quotes-and-orders.md): machine quotes, orders, records and credits.
- [Spending safely](https://emailmovers.com/mydatahub/docs/spending-safely.md): the three layers that guard every spend.
- [Authentication](https://emailmovers.com/mydatahub/docs/authentication.md): API keys, agent keys and scopes, and OAuth 2.1, which signs you in to the app.
- [Errors](https://emailmovers.com/mydatahub/docs/errors.md): every problem type and what to do next.
- [Rate limits](https://emailmovers.com/mydatahub/docs/rate-limits.md): limits by tier and the headers that report them.
- [Webhooks](https://emailmovers.com/mydatahub/docs/webhooks.md): Standard Webhooks signing, retries and event types.
- [Suppressions and objections](https://emailmovers.com/mydatahub/docs/suppressions.md): lists, checks before a send and database-wide objections.
- [Compliance receipts](https://emailmovers.com/mydatahub/docs/compliance-receipts.md): the signed receipt for every order and how to verify it.
- [Versions and reproducibility](https://emailmovers.com/mydatahub/docs/versions.md): dated API versions, dataset versions and count ids.
- [Changelog and deprecation policy](https://emailmovers.com/mydatahub/docs/changelog.md): what changed and how long old things last.
- [Reference](https://emailmovers.com/mydatahub/docs/reference.md): every REST operation and MCP tool, generated from the contracts.