# Breaknorm

> Every company in Europe and the US, searchable by what they actually do — with official filings and ownership behind every result. Breaknorm is MCP-first: the same data is available over a REST API and a hosted MCP server.

Search is unlimited on every plan. What is metered is the *record* — opening or exporting a company's full profile. See https://docs.breaknorm.co/support/account/limits for the exact rules.

## API & MCP reference

- [API & MCP](https://docs.breaknorm.co/api): One product, two doors — the hosted MCP server for agents and the REST API for your code.
- [Quickstart](https://docs.breaknorm.co/api/quickstart): Your first search, exclusion list and export over REST in five minutes.
- [Authentication](https://docs.breaknorm.co/api/authentication): API keys and OAuth 2.1 — how to authenticate against the Breaknorm API and MCP server.
- [Records & rate limits](https://docs.breaknorm.co/api/records-and-limits): One allowance, two rolling windows — what each activity costs, and how fast you can call.
- [Errors](https://docs.breaknorm.co/api/errors): One error shape for REST and MCP, with a stable code an agent can act on.
- [Result sizes](https://docs.breaknorm.co/api/pagination): Top-k searches, full exports, and why there is no deep paging.
- [MCP overview](https://docs.breaknorm.co/api/mcp/overview): The hosted Breaknorm MCP server — what it gives an agent, how it connects, and how it behaves.
- [Connect your client](https://docs.breaknorm.co/api/mcp/connect): Add Breaknorm to Claude, ChatGPT, Claude Code, Cursor or any MCP client.
- [Tool reference](https://docs.breaknorm.co/api/mcp/tools): Every tool the Breaknorm MCP server exposes — generated from the server itself.
- [Prompting recipes](https://docs.breaknorm.co/api/mcp/prompting): Asks that work well, and the tool calls they turn into.
- [All endpoints](https://docs.breaknorm.co/api/endpoints/reference): Every REST endpoint of api.breaknorm.co/v1 — the same operations as the MCP tools, generated from the server.
- [List filter values](https://docs.breaknorm.co/api/endpoints/discover/list-filter-values): Existing values of a keyword facet with counts (and its coverage), optionally under filters.
- [List filters](https://docs.breaknorm.co/api/endpoints/discover/list-filters): Every filterable facet with its type and coverage %, plus the search axes.
- [Count companies](https://docs.breaknorm.co/api/endpoints/companies/count-companies): How many companies match a set of filters and literal guards — and, with `group_by` (≤3 keyword facets), how they split.
- [Find similar companies (lookalikes)](https://docs.breaknorm.co/api/endpoints/companies/find-similar): Records: one per company shown (each hit, every time it is shown); count_companies and list_filters are free.
- [Get companies by domain](https://docs.breaknorm.co/api/endpoints/companies/get-companies): Records: one per company returned.
- [Search companies](https://docs.breaknorm.co/api/endpoints/companies/search-companies): Records: one per company shown (each hit, every time it is shown); count_companies and list_filters are free.
- [Run several searches and merge them](https://docs.breaknorm.co/api/endpoints/companies/search-many): Records: one per company shown (each hit, every time it is shown); count_companies and list_filters are free.
- [Segment companies](https://docs.breaknorm.co/api/endpoints/companies/segment-companies): Split a set of companies into sub-segments you can write ONE message to.
- [Count job postings](https://docs.breaknorm.co/api/endpoints/jobs/count-jobs): Free.
- [Company activity (jobs intelligence)](https://docs.breaknorm.co/api/endpoints/jobs/get-company-activity): Records: one per company found.
- [Read job postings (full text)](https://docs.breaknorm.co/api/endpoints/jobs/get-job-postings): Records: one per posting returned.
- [Search job postings](https://docs.breaknorm.co/api/endpoints/jobs/search-jobs): Records: one per posting shown; count_jobs is free.
- [Check known companies' pages for words](https://docs.breaknorm.co/api/endpoints/pages/check-pages): For up to 50 companies you already have, which of up to 10 terms appear on their crawled pages.
- [List a company's crawled pages](https://docs.breaknorm.co/api/endpoints/pages/get-company-pages): The pages we crawled from a company's website: page_id, url, kind, when it was fetched and its length.
- [Read a crawled page](https://docs.breaknorm.co/api/endpoints/pages/get-page): The markdown of one crawled page of a company's website — by page_id, or by domain + kind for the newest page of that kind.
- [Count people](https://docs.breaknorm.co/api/endpoints/people/count-people): How many people match — and at how many companies — before you pull them.
- [Find a company's decision makers live](https://docs.breaknorm.co/api/endpoints/people/find-people-live): For companies where search_people / get_contacts return nobody.
- [Get (and re-check) a person's contacts](https://docs.breaknorm.co/api/endpoints/people/get-contacts): The contacts of up to 25 people, with every address checked again when its verdict is older than max_age_days or never checked.
- [Get live people results](https://docs.breaknorm.co/api/endpoints/people/get-live-people-result): Current result of find_people_live lookups (lookup_ids from its answer).
- [Get people by id](https://docs.breaknorm.co/api/endpoints/people/get-people): Full records for up to 100 people by person_id.
- [List people filter values](https://docs.breaknorm.co/api/endpoints/people/list-people-values): The values of a person field with how many people carry each.
- [Search people (contacts at companies)](https://docs.breaknorm.co/api/endpoints/people/search-people): Find people — decision makers, a team, a persona — with their contacts, at the companies you choose.
- [Find decision makers live for many companies](https://docs.breaknorm.co/api/endpoints/people/start-live-people-job): find_people_live for a list of companies (items=[{domain, company_name?, ref?}], up to your plan's e-mail batch size).
- [Add companies to a list](https://docs.breaknorm.co/api/endpoints/lists/add-to-list): Add companies to one of your lists.
- [Create a company list](https://docs.breaknorm.co/api/endpoints/lists/create-list): Create a list of companies (by domain).
- [Delete a list](https://docs.breaknorm.co/api/endpoints/lists/delete-list): Delete one of your lists (REST and dashboard only).
- [Get your lists](https://docs.breaknorm.co/api/endpoints/lists/get-lists): Your organization's company lists (id, name, kind, client, auto_exclude, size, how many the index knows).
- [Remove companies from a list](https://docs.breaknorm.co/api/endpoints/lists/remove-from-list): Remove domains from one of your lists.
- [Cancel a job](https://docs.breaknorm.co/api/endpoints/exports/cancel-job): Cancel a queued or running job.
- [Get a job's status and result](https://docs.breaknorm.co/api/endpoints/exports/get-job): Status and result of an export, e-mail, list-import or live-people job (job_id), with a fresh 24 h download link once done.
- [Export a full company list](https://docs.breaknorm.co/api/endpoints/exports/start-export): Export EVERY company matching a search or a lookalike — not just the top 100.
- [Find a person's e-mail address](https://docs.breaknorm.co/api/endpoints/email/find-email): Find the work e-mail address of a person from their name and company domain, verified against the mail server.
- [Get a pending e-mail result](https://docs.breaknorm.co/api/endpoints/email/get-email-result): Result of a find_email / verify_email that answered {status:'pending'}.
- [Verify or find e-mails in bulk](https://docs.breaknorm.co/api/endpoints/email/start-email-job): Verify a list of e-mail addresses or find addresses for people.
- [Verify an e-mail address](https://docs.breaknorm.co/api/endpoints/email/verify-email): Check whether an e-mail address is deliverable, without sending mail.
- [Get plan and usage](https://docs.breaknorm.co/api/endpoints/account/get-usage): Your organization's plan, access state and allowance in records, with two rolling windows — used, left and limit for each.
- [Create a subscription (webhook and/or people list)](https://docs.breaknorm.co/api/endpoints/webhooks/create-subscription): Subscribe to events and deliver the matches to a webhook endpoint and/or a people list.
- [Create a webhook endpoint](https://docs.breaknorm.co/api/endpoints/webhooks/create-webhook-endpoint): Register a receiver URL for event subscriptions.
- [Delete a subscription](https://docs.breaknorm.co/api/endpoints/webhooks/delete-subscription): Delete a subscription (REST and dashboard only; soft-deleted for audit).
- [Delete a webhook endpoint](https://docs.breaknorm.co/api/endpoints/webhooks/delete-webhook-endpoint): Delete an endpoint (REST and dashboard only; soft-deleted for audit).
- [Describe events and payload fields](https://docs.breaknorm.co/api/endpoints/webhooks/describe-events): The event catalogue for subscriptions and list_events.
- [List events (polling feed)](https://docs.breaknorm.co/api/endpoints/webhooks/list-events): Events in the order we recorded them, after a cursor.
- [List a subscription's matches](https://docs.breaknorm.co/api/endpoints/webhooks/list-subscription-matches): What a subscription did, newest first: each matched event with its state, suppressed_reason, enrichment status, and every delivery attempt.
- [List subscriptions](https://docs.breaknorm.co/api/endpoints/webhooks/list-subscriptions): Your organization's event subscriptions (full stored body, status active | paused | invalid with invalid_reason, version, matched_total).
- [List webhook endpoints](https://docs.breaknorm.co/api/endpoints/webhooks/list-webhook-endpoints): Your organization's webhook endpoints with status (pending | active | paused | disabled) and delivery health.
- [Preview a subscription](https://docs.breaknorm.co/api/endpoints/webhooks/preview-subscription): Dry run of a subscription body over the recorded events of the last `window_days`.
- [Redeliver](https://docs.breaknorm.co/api/endpoints/webhooks/redeliver): Queue new delivery attempts with the ORIGINAL stored bytes (nothing is re-rendered or re-charged).
- [Send a test event](https://docs.breaknorm.co/api/endpoints/webhooks/send-test-event): Queue ONE test delivery to the subscription's endpoint.
- [Update a subscription](https://docs.breaknorm.co/api/endpoints/webhooks/update-subscription): Change any part of a subscription (every key optional; a given key replaces the stored one whole) and/or set status active | paused.
- [Update a webhook endpoint](https://docs.breaknorm.co/api/endpoints/webhooks/update-webhook-endpoint): Change an endpoint.
- [Collect a post's engagers](https://docs.breaknorm.co/api/endpoints/monitors/collect-post): Shorthand for create_monitor: collect the commenters of ONE LinkedIn post now.
- [Create a monitor](https://docs.breaknorm.co/api/endpoints/monitors/create-monitor): Watch a LinkedIn profile's posts or one post and collect the people who engaged; or watch a people list for job changes.
- [Delete a monitor](https://docs.breaknorm.co/api/endpoints/monitors/delete-monitor): Delete a monitor (REST and dashboard only; soft-deleted for audit).
- [Describe monitors](https://docs.breaknorm.co/api/endpoints/monitors/describe-monitors): What a LinkedIn monitor is and how to use one.
- [Estimate a monitor](https://docs.breaknorm.co/api/endpoints/monitors/estimate-monitor): Before creating: how many people a profile's posts draw per month or one post's counts, and the records that would cost if every one of them were delivered — comments only vs…
- [List a monitor's people](https://docs.breaknorm.co/api/endpoints/monitors/list-monitor-people): The people a monitor collected, newest first.
- [List monitors](https://docs.breaknorm.co/api/endpoints/monitors/list-monitors): Your organization's monitors with status, target, settings and counters (posts, people collected, resolved, last poll).
- [Update a monitor](https://docs.breaknorm.co/api/endpoints/monitors/update-monitor): Pause / resume a monitor, or change its name, collect settings, exclude or limits.
- [Add people to a people list](https://docs.breaknorm.co/api/endpoints/people_lists/add-people-list-items): Add people by LinkedIn profile URL (up to 5000 per call), with optional name, title, company and e-mail.
- [Create a people list](https://docs.breaknorm.co/api/endpoints/people_lists/create-people-list): Create a list of PEOPLE.
- [Delete a people list](https://docs.breaknorm.co/api/endpoints/people_lists/delete-people-list): Delete one of your people lists (REST and dashboard only; soft-deleted for audit).
- [Read a people list](https://docs.breaknorm.co/api/endpoints/people_lists/list-people-list-items): The people on one of your people lists, newest first, with the fields you ask for.
- [List your people lists](https://docs.breaknorm.co/api/endpoints/people_lists/list-people-lists): Your organization's people lists (id, name, client, size, version).
- [Remove people from a people list](https://docs.breaknorm.co/api/endpoints/people_lists/remove-people-list-items): Remove people (by LinkedIn profile URL) from one of your people lists.

## Help centre

- [Help centre](https://docs.breaknorm.co/support): Plain answers about the data, your allowance, exclusions, e-mail and the things that go wrong.
- [Connect your agent](https://docs.breaknorm.co/support/getting-started/connect-your-agent): Using Breaknorm from Claude, ChatGPT, Claude Code or Cursor — the short version.
- [Your first search](https://docs.breaknorm.co/support/getting-started/first-search): How to describe the companies you want so Breaknorm finds them.
- [Reading a company record](https://docs.breaknorm.co/support/getting-started/reading-a-profile): What each field on a company means, where it came from, and when to trust it less.
- [Exclusions, lists and exports](https://docs.breaknorm.co/support/getting-started/lists-and-exports): Keeping your customers out of every result, uploading a list from a file, and getting the full list out.
- [Finding and verifying e-mails](https://docs.breaknorm.co/support/getting-started/email): Find a person's work address from their name and company, or check whether an address is real — one at a time or by the file.
- [Coverage](https://docs.breaknorm.co/support/data/coverage): How many companies are in Breaknorm, in which countries, and what is not in it.
- [Where the data comes from](https://docs.breaknorm.co/support/data/sources): Companies' own websites first; published figures for size where they exist.
- [Estimates and how they're marked](https://docs.breaknorm.co/support/data/estimates): Which fields are derived rather than published, how to tell, and how much to lean on them.
- [How fresh the data is](https://docs.breaknorm.co/support/data/freshness): The dates every company record carries, and what they tell you.
- [People and contact data](https://docs.breaknorm.co/support/data/contacts): What you can do with people today — and what is coming.
- [Plans](https://docs.breaknorm.co/support/account/plans): What each plan includes, and the numbers that separate them.
- [How the allowance works](https://docs.breaknorm.co/support/account/limits): One allowance, two rolling windows, every activity at its own weight — in plain language.
- [Billing and invoices](https://docs.breaknorm.co/support/account/billing): Payment, invoices, and what happens when a card fails.
- [Cancelling](https://docs.breaknorm.co/support/account/cancelling): A few clicks, no retention call, and access until the end of what you paid for.
- [Your data and privacy](https://docs.breaknorm.co/support/account/data-and-privacy): What we store about you, what we hold about companies, where it runs, and how to exercise your rights.
- [My agent isn’t connecting](https://docs.breaknorm.co/support/troubleshooting/agent-not-connecting): The things that cause this, in the order they're worth checking.
- [A search returns nothing](https://docs.breaknorm.co/support/troubleshooting/no-results): Almost always the wording or one filter too many — here's how to find which.
- [I hit a limit](https://docs.breaknorm.co/support/troubleshooting/hit-a-limit): What each limit message means and what to do about it.
- [A result looks wrong](https://docs.breaknorm.co/support/troubleshooting/wrong-company): Misdescribed, wrong size, or the wrong company — each has a different fix.
- [Contact us](https://docs.breaknorm.co/support/contact): One email address, read by a person, usually answered within a working day.

## Optional

- [Complete documentation, one file](https://docs.breaknorm.co/llms-full.txt)
- [API & MCP reference only](https://docs.breaknorm.co/llms/api.txt)
- [Help centre only](https://docs.breaknorm.co/llms/support.txt)