MCP server

Tool reference

Every tool the Breaknorm MCP server exposes — generated from the server itself.

The server at https://mcp.breaknorm.co/mcp exposes 59 tools. Each tool is also a REST endpoint with the same arguments — the linked page has both, with examples. A machine-readable list is at /tools.json.

Discover

Tool	What it does	Cost
`list_filters`	Every filterable facet with its type and coverage %, plus the search axes.	No record cost
`list_filter_values`	Existing values of a keyword facet with counts (and its coverage), optionally under filters.	No record cost

Companies

Tool	What it does	Cost
`search_companies`	Records: one per company shown (each hit, every time it is shown); count_companies and list_filters are free.	1 record per company shown
`search_many`	Records: one per company shown (each hit, every time it is shown); count_companies and list_filters are free.	1 record per company shown
`count_companies`	How many companies match a set of filters and literal guards — and, with `group_by` (≤3 keyword facets), how they split.	No record cost by default
`find_similar`	Records: one per company shown (each hit, every time it is shown); count_companies and list_filters are free.	1 record per company shown
`get_companies`	Records: one per company returned.	1 record per company returned
`segment_companies`	Split a set of companies into sub-segments you can write ONE message to.	No record cost by default

Jobs & hiring signals

Tool	What it does	Cost
`search_jobs`	Records: one per posting shown; count_jobs is free.	1 record per posting shown
`get_job_postings`	Records: one per posting returned.	1 record per posting returned
`count_jobs`	Free.	No record cost by default
`get_company_activity`	Records: one per company found.	1 record per company returned

Crawled pages

Tool	What it does	Cost
`get_company_pages`	The pages we crawled from a company’s website: page_id, url, kind, when it was fetched and its length.	No record cost
`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.	No record cost by default
`check_pages`	For up to 50 companies you already have, which of up to 10 terms appear on their crawled pages.	No record cost by default

People

Tool	What it does	Cost
`search_people`	Find people — decision makers, a team, a persona — with their contacts, at the companies you choose.	1 record per person shown
`count_people`	How many people match — and at how many companies — before you pull them.	No record cost by default
`get_people`	Full records for up to 100 people by person_id.	1 record per person shown
`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.	1 record per person shown (the re-check is free)
`list_people_values`	The values of a person field with how many people carry each.	No record cost
`find_people_live`	For companies where search_people / get_contacts return nobody.	2 records per company searched, found or not; a weekly ceiling per plan
`get_live_people_result`	Current result of find_people_live lookups (lookup_ids from its answer).	No record cost
`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).	2 records per company searched, found or not; a weekly ceiling per plan

Lists & exclusions

Tool	What it does	Cost
`create_list`	Create a list of companies (by domain).	No record cost
`add_to_list`	Add companies to one of your lists.	No record cost
`remove_from_list`	Remove domains from one of your lists.	No record cost
`get_lists`	Your organization’s company lists (id, name, kind, client, auto_exclude, size, how many the index knows).	No record cost

Exports & jobs

Tool	What it does	Cost
`start_export`	Export EVERY company matching a search or a lookalike — not just the top 100.	1 record per exported row (company or person)
`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.	No record cost
`cancel_job`	Cancel a queued or running job.	No record cost

E-mail

Tool	What it does	Cost
`find_email`	Find the work e-mail address of a person from their name and company domain, verified against the mail server.	2 records per address found
`verify_email`	Check whether an e-mail address is deliverable, without sending mail.	1 record per address checked
`get_email_result`	Result of a find_email / verify_email that answered {status:‘pending’}.	No record cost
`start_email_job`	Verify a list of e-mail addresses or find addresses for people.	1 record per row (verify) / per address found (find)

Account

Tool	What it does	Cost
`get_usage`	Your organization’s plan, access state and allowance in records, with two rolling windows — used, left and limit for each.	No record cost

Webhooks & events

Tool	What it does	Cost
`describe_events`	The event catalogue for subscriptions and list_events.	No record cost
`list_events`	Events in the order we recorded them, after a cursor.	1 record per event shown
`create_webhook_endpoint`	Register a receiver URL for event subscriptions.	No record cost
`list_webhook_endpoints`	Your organization’s webhook endpoints with status (pending \| active \| paused \| disabled) and delivery health.	No record cost
`update_webhook_endpoint`	Change an endpoint.	No record cost
`create_subscription`	Subscribe to events and deliver the matches to a webhook endpoint and/or a people list.	1 record per delivered payload with company fields (person_row per person from actions); creating is free
`preview_subscription`	Dry run of a subscription body over the recorded events of the last `window_days`.	No record cost
`list_subscriptions`	Your organization’s event subscriptions (full stored body, status active \| paused \| invalid with invalid_reason, version, matched_total).	No record cost
`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.	No record cost
`send_test_event`	Queue ONE test delivery to the subscription’s endpoint.	No record cost
`list_subscription_matches`	What a subscription did, newest first: each matched event with its state, suppressed_reason, enrichment status, and every delivery attempt.	No record cost
`redeliver`	Queue new delivery attempts with the ORIGINAL stored bytes (nothing is re-rendered or re-charged).	No record cost

LinkedIn monitors (post engagers, champion tracking)

Tool	What it does	Cost
`describe_monitors`	What a LinkedIn monitor is and how to use one.	No record cost
`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…	No record cost
`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.	40 records per person, once per monitor, when first delivered or listed: a commenter 40 records, a reactor 80; a profile monitor’s daily look for new posts 40 (monitor_poll); champion tracking: 80 per delivered change, the checks are free; e-mail found +2; creating and collecting are free
`collect_post`	Shorthand for create_monitor: collect the commenters of ONE LinkedIn post now.	40 records per person, once per monitor, when first delivered or listed: a commenter 40 records, a reactor 80; collecting is free
`list_monitors`	Your organization’s monitors with status, target, settings and counters (posts, people collected, resolved, last poll).	No record cost
`update_monitor`	Pause / resume a monitor, or change its name, collect settings, exclude or limits.	No record cost
`list_monitor_people`	The people a monitor collected, newest first.	40 records per person on first exposure (40 a commenter, 80 a reactor, once per monitor — a person a subscription already delivered is free here)

People lists

Tool	What it does	Cost
`create_people_list`	Create a list of PEOPLE.	No record cost
`list_people_lists`	Your organization’s people lists (id, name, client, size, version).	No record cost
`add_people_list_items`	Add people by LinkedIn profile URL (up to 5000 per call), with optional name, title, company and e-mail.	No record cost
`remove_people_list_items`	Remove people (by LinkedIn profile URL) from one of your people lists.	No record cost
`list_people_list_items`	The people on one of your people lists, newest first, with the fields you ask for.	1 record per person returned when e-mail fields are asked for