{"data":{"name":"com.emailmovers/mydatahub","title":"MyDataHub","description":"UK B2B contact counts, quotes and lists, by Emailmovers","version":"2.0.0","websiteUrl":"https://emailmovers.com/mydatahub/","repositoryUrl":null,"remotes":[{"type":"streamable-http","url":"https://mydatahub.emailmovers.com/mcp","headers":[{"description":"Optional. A MyDataHub API key or agent key (mdh_live_...), made in the app under API keys. Without one, counts, breakdowns, previews and quotes still work, with rounded figures.","value":"Bearer {api_key}","isSecret":true,"variables":{"api_key":{"description":"MyDataHub API key or agent key","isSecret":true,"placeholder":"mdh_live_..."}},"name":"Authorization"}]}],"packages":[],"status":"active","isLatest":true,"publishedAt":"2026-11-09T16:24:11.207Z","updatedAt":"2026-11-09T16:24:11.207Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"source":"official-registry","sourceId":"com.emailmovers/mydatahub","verification":"official","confidence":100,"stars":null,"updatedAt":"2026-11-09T16:24:11.207Z","title":"MyDataHub","description":"UK B2B contact counts, quotes and lists, by Emailmovers","websiteUrl":"https://emailmovers.com/mydatahub/","repositoryUrl":null}],"toolIndex":{"tools":[{"serverName":"com.emailmovers/mydatahub","endpointFingerprint":"4095f069b618dbc15e63a1fd53768b5a184a62fcd200aa4cf68cd54c5019440e","name":"check_suppression","title":"Check suppression","description":"Checks the suppression status of up to 1,000 delivered records by record id, as of now, and names the lists that suppress each. Use it before every send, because objections reach records after delivery. Free; it needs suppressions:read. Leave suppressed records out of the send, and call report_objection when someone objects. Lawful basis is UK GDPR Article 6(1)(f) legitimate interests; email audiences include corporate subscribers only by default (PECR), so sole traders and ordinary partnerships are left out unless the toggle is changed.","inputSchema":{"type":"object","properties":{"record_ids":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"string","pattern":"^contact_[0-7][0-9A-HJKMNP-TV-Z]{25}$","description":"Format: a contact id: contact_ followed by a 26 character ULID in upper case Crockford base32, such as contact_01JA9X2V7XN3M9R6T1Y5W8ZAK8.","examples":["contact_01JA9X2V7XN3M9R6T1Y5W8ZAK8"]}}},"required":["record_ids"],"additionalProperties":false,"description":"Records to check before a send."},"annotations":{"title":"Check suppression","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"b5e68d183f97704abe6da6da81aaa0f4fe9b520cb7dae66de382a55f3efd563a","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T11:47:07.863Z","metadataTrust":"untrusted"},{"serverName":"com.emailmovers/mydatahub","endpointFingerprint":"4095f069b618dbc15e63a1fd53768b5a184a62fcd200aa4cf68cd54c5019440e","name":"compile_audience","title":"Compile a brief","description":"Compiles a plain English brief, such as 300 finance directors at law firms in Manchester, into an audience definition with a one-sentence readback, editable chips and any questions to answer first. Use it first for a request in words, read the readback to the user and settle the questions before counting. Words that match no filter come back in unrecognised, never guessed. Free and needs no account; pass the audience to count_audience next. Lawful basis is UK GDPR Article 6(1)(f) legitimate interests; email audiences include corporate subscribers only by default (PECR), so sole traders and ordinary partnerships are left out unless the toggle is changed.","inputSchema":{"type":"object","properties":{"brief":{"type":"string","minLength":3,"maxLength":2000,"description":"A plain English brief, such as \"300 finance directors at law firms in Manchester\"."},"dataset":{"type":"string","enum":["uk_contacts","ie_contacts","global_contacts"],"description":"The dataset an audience draws from. uk_contacts is live; ie_contacts and global_contacts are listed but not yet served."}},"required":["brief"],"additionalProperties":false,"description":"A brief to compile into an audience definition."},"annotations":{"title":"Compile a brief","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"41985a3e9afab20cf9c0fbe6d74c7b800202e648e14419eca3ee4241f00969ef","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T11:47:07.863Z","metadataTrust":"untrusted"},{"serverName":"com.emailmovers/mydatahub","endpointFingerprint":"4095f069b618dbc15e63a1fd53768b5a184a62fcd200aa4cf68cd54c5019440e","name":"count_audience","title":"Count an audience","description":"Counts UK contacts and companies matching an audience, inline or a saved aud_ id, and returns Total, New to you and Emailable, up to three breakdowns, quality, the compliance summary, a price estimate and a count id. Use it whenever a filter changes, and before preview_records or quote_order, which both take the count id. Free and needs no account; anonymous and trial callers see counts under 100 and breakdown cells rounded to the nearest 5 (disclosure says which), and exact small counts need a paid plan. It returns no contact details, and over MCP a cross-tab holds at most 200 cells (truncated true; GET /v1/counts/{id} has the rest). Lawful basis is UK GDPR Article 6(1)(f) legitimate interests; email audiences include corporate subscribers only by default (PECR), so sole traders and ordinary partnerships are left out unless the toggle is changed.","inputSchema":{"type":"object","properties":{"audience":{"type":["string","object"],"$ref":"#/$defs/AudienceRef"},"level":{"default":"contact","type":"string","enum":["contact","company"],"description":"contact (the default) or company. Contacts and companies come back together either way."},"breakdown_by":{"maxItems":3,"type":"array","items":{"type":"string","enum":["company.sic_2007","company.business_class","company.employee_band","company.turnover_band","company.fleet_band","company.type","company.status","company.subscriber_class","site.region","site.county","site.town","site.postcode","contact.title_family","contact.job_function","contact.job_level_rank","email.exists","email.type","phone.exists","phone.tps_ctps_status"],"description":"A field a count can be broken down by."},"description":"Up to three fields to break the count down by, each once, such as industry by seniority by region. Returns the top 50 cells per field plus other.","uniqueItems":true}},"required":["audience"],"additionalProperties":false,"description":"An audience, a level and up to three breakdown fields. Free, and needs no account.","$defs":{"AllGroup":{"type":"object","properties":{"all":{"minItems":1,"type":"array","items":{"$ref":"#/$defs/WhereNode"}}},"required":["all"],"additionalProperties":false,"description":"AND: every node inside must match."},"AnyGroup":{"type":"object","properties":{"any":{"minItems":1,"type":"array","items":{"$ref":"#/$defs/WhereNode"}}},"required":["any"],"additionalProperties":false,"description":"OR: at least one node inside must match."},"Audience":{"type":"object","properties":{"schema":{"type":"string","const":"mydatahub.audience/1","description":"The definition's namespace and version. Older versions are upgraded by a pure function."},"dataset":{"type":"string","enum":["uk_contacts","ie_contacts","global_contacts"],"description":"The dataset an audience draws from. uk_contacts is live; ie_contacts and global_contacts are listed but not yet served."},"dataset_version":{"description":"The weekly build to count against, such as 2026-W39. Left out, the current version is filled in and returned.","type":"string","pattern":"^[0-9]{4}-W(0[1-9]|[1-4][0-9]|5[0-3])$","examples":["2026-W39"]},"where":{"description":"The filters. Left out, the audience is the whole dataset after the defaults.","$ref":"#/$defs/WhereNode"},"email_policy":{"$ref":"#/$defs/EmailPolicy"},"dedupe":{"type":"string","enum":["none","one_per_company","one_per_site"],"description":"none keeps every matching contact, one_per_company keeps one contact per company, one_per_site keeps one per site. Default none."}},"required":["schema"],"additionalProperties":false,"title":"MyDataHub audience definition (mydatahub.audience/1)","description":"Who you want, as filters grouped by entity (company., site., contact., email., phone., signal.). The server fills its defaults (active companies, named emails, corporate subscribers, the current dataset_version) and returns the effective definition with every count."},"AudienceRef":{"anyOf":[{"type":"string","pattern":"^aud_[0-7][0-9A-HJKMNP-TV-Z]{25}$","description":"Format: an audience id: aud_ followed by a 26 character ULID in upper case Crockford base32, such as aud_01JB4H2K9V6XN3M9R6T1Y5W8ZA.","examples":["aud_01JB4H2K9V6XN3M9R6T1Y5W8ZA"]},{"$ref":"#/$defs/Audience"}],"description":"An audience definition (mydatahub.audience/1) inline, or the aud_ id of a saved audience."},"BetweenFilter":{"type":"object","properties":{"field":{"type":"string","enum":["company.employee_band","company.turnover_band","company.fleet_band","contact.job_level_rank","email.deliverability_score"]},"op":{"type":"string","const":"between"},"from":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"number"}],"description":"A band code or a number from the field's order."},"to":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"number"}],"description":"A band code or a number from the field's order."}},"required":["field","op","from","to"],"additionalProperties":false,"description":"The field lies from one value to another inclusive, over the field's order.","examples":[{"field":"company.employee_band","op":"between","from":"10-19","to":"200-349"}]},"BundleNode":{"type":"object","properties":{"bundle":{"type":"string","enum":["sdm","manager_and_above","owner_managed"]}},"required":["bundle"],"additionalProperties":false,"description":"A title bundle, resolved to its filters in the effective definition: sdm (senior decision makers), manager_and_above (managers and above), owner_managed (owner managed)."},"EmailPolicy":{"type":"object","properties":{"min_deliverability_score":{"description":"Lowest deliverability score counted, 0 to 100. Default 70.","type":"integer","minimum":0,"maximum":100},"allow_catch_all":{"description":"Whether catch-all addresses count. Default false.","type":"boolean"}},"additionalProperties":false,"description":"Email quality floor. Defaults: min_deliverability_score 70, allow_catch_all false."},"Filter":{"oneOf":[{"$ref":"#/$defs/InFilter"},{"$ref":"#/$defs/BetweenFilter"},{"$ref":"#/$defs/GteFilter"},{"$ref":"#/$defs/LteFilter"},{"$ref":"#/$defs/MatchesFilter"},{"$ref":"#/$defs/WithinRadiusFilter"},{"$ref":"#/$defs/InListFilter"},{"$ref":"#/$defs/SinceFilter"}],"description":"One criterion: a field from GET /v1/catalogue/filters, an operator and its operands. Exclusions nest under not."},"GteFilter":{"type":"object","properties":{"field":{"type":"string","enum":["company.employee_band","company.turnover_band","company.fleet_band","contact.job_level_rank","email.deliverability_score"]},"op":{"type":"string","const":"gte"},"value":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"number"}],"description":"A band code or a number from the field's order."}},"required":["field","op","value"],"additionalProperties":false,"description":"The field is at or after the value in its order: for bands, the band and every larger one.","examples":[{"field":"company.employee_band","op":"gte","value":"50-99"}]},"InFilter":{"type":"object","properties":{"field":{"type":"string","enum":["company.sic_2007","company.business_class","company.employee_band","company.turnover_band","company.fleet_band","company.type","company.status","company.subscriber_class","company.companies_house_number","site.region","site.county","site.town","site.postcode","contact.title_family","contact.job_function","contact.job_level_rank","contact.premium","email.exists","email.type","phone.exists","phone.tps_ctps_status"]},"op":{"type":"string","const":"in"},"values":{"minItems":1,"maxItems":10000,"type":"array","items":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"number"},{"type":"boolean"}],"description":"A code, a rank or a boolean, as the field's catalogue lists it."}}},"required":["field","op","values"],"additionalProperties":false,"description":"The field holds one of the listed codes.","examples":[{"field":"company.sic_2007","op":"in","values":["C"]}]},"InListFilter":{"type":"object","properties":{"field":{"type":"string","enum":["company.companies_house_number","contact.title","email.address_sha256","email.domain_sha256","phone.e164_sha256"]},"op":{"type":"string","const":"in_list"},"list_id":{"type":"string","pattern":"^sup_[0-7][0-9A-HJKMNP-TV-Z]{25}$","description":"Format: a suppression list id: sup_ followed by a 26 character ULID in upper case Crockford base32, such as sup_01JB4H7Q2V7XN3M9R6T1Y5W8ZA.","examples":["sup_01JB4H7Q2V7XN3M9R6T1Y5W8ZA"]}},"required":["field","op","list_id"],"additionalProperties":false,"description":"The record's hashed email, domain, phone, company number or title term is on a suppression list. Usually nested under not; each list reports the records it removed.","examples":[{"field":"email.address_sha256","op":"in_list","list_id":"sup_01JB4H7Q2V7XN3M9R6T1Y5W8ZA"}]},"LteFilter":{"type":"object","properties":{"field":{"type":"string","enum":["company.employee_band","company.turnover_band","company.fleet_band","contact.job_level_rank","contact.company_contact_rank","email.deliverability_score"]},"op":{"type":"string","const":"lte"},"value":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"number"}],"description":"A band code or a number from the field's order."}},"required":["field","op","value"],"additionalProperties":false,"description":"The field is at or before the value in its order. Rank 1 is the most senior, so Director and above is contact.job_level_rank lte 6.","examples":[{"field":"contact.job_level_rank","op":"lte","value":6}]},"MatchesFilter":{"type":"object","properties":{"field":{"type":"string","enum":["contact.title"]},"op":{"type":"string","const":"matches"},"terms":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}},"mode":{"type":"string","enum":["contains","starts_with","exact"],"description":"contains (the default) matches titles containing a term, starts_with matches titles beginning with it, exact takes verbatim titles with no expansion."},"expand":{"description":"Expansion sets to apply, each once: plural_singular, department_synonyms, ampersand_and, abbreviations, permutations. Left out, the first four apply; an empty list applies none. Not used with mode exact.","uniqueItems":true,"maxItems":5,"type":"array","items":{"type":"string","enum":["plural_singular","department_synonyms","ampersand_and","abbreviations","permutations"]}},"exclude_terms":{"description":"Expanded terms removed by hand. Kept in the definition so the count stays reproducible when the title dictionary changes.","maxItems":500,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["field","op","terms"],"additionalProperties":false,"description":"Job title keyword match. mode contains (the default) or starts_with expands each term with the expansion sets; mode exact matches verbatim titles. Every expanded term is returned with the count.","examples":[{"field":"contact.title","op":"matches","terms":["marketing manager"],"mode":"contains","expand":["plural_singular","department_synonyms","ampersand_and","abbreviations"]}],"allOf":[{"if":{"type":"object","properties":{"mode":{"const":"exact"}},"required":["mode"]},"then":{"type":"object","properties":{"expand":{"type":"array","maxItems":0},"exclude_terms":{"type":"array","maxItems":0}}}}]},"NotGroup":{"type":"object","properties":{"not":{"$ref":"#/$defs/WhereNode"}},"required":["not"],"additionalProperties":false,"description":"Negation: the single node inside must not match."},"PlaceCentre":{"type":"object","properties":{"place":{"type":"string","minLength":1,"maxLength":100,"description":"A place name, resolved with resolve_location, such as Leeds."},"code":{"description":"The ONS geography code of the chosen candidate when resolve_location found more than one, such as E08000035 for the Leeds district.","type":"string","minLength":1,"maxLength":20}},"required":["place"],"additionalProperties":false,"description":"A named place. Ambiguous names come back from resolve_location as candidates, never a silent choice."},"PointCentre":{"type":"object","properties":{"lat":{"type":"number","minimum":49,"maximum":61},"lon":{"type":"number","minimum":-9,"maximum":2}},"required":["lat","lon"],"additionalProperties":false,"description":"A latitude and longitude in WGS84 degrees."},"PostcodeCentre":{"type":"object","properties":{"postcode":{"type":"string","pattern":"^[A-Za-z]{1,2}([0-9][0-9A-Za-z]?( [0-9]([A-Za-z]{2})?| ?[0-9][A-Za-z]{2})?)?$","description":"The centroid of a postcode unit, sector, district or area, such as LS1 4AP."}},"required":["postcode"],"additionalProperties":false,"description":"A postcode centroid from ONSPD."},"RadiusCentre":{"anyOf":[{"$ref":"#/$defs/PlaceCentre"},{"$ref":"#/$defs/PostcodeCentre"},{"$ref":"#/$defs/PointCentre"}],"description":"The centre of a radius: a place, a postcode or a latitude and longitude."},"SinceFilter":{"type":"object","properties":{"field":{"type":"string","enum":["contact.last_validated_at","email.last_verified_at","signal.type","signal.observed_at"]},"op":{"type":"string","const":"since"},"days":{"type":"integer","minimum":1,"maximum":3650},"values":{"description":"For signal.type only: the signal types to look for, such as company.incorporated.","minItems":1,"maxItems":10000,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["field","op","days"],"additionalProperties":false,"description":"Within the last N days: a date field, or a Companies House signal of the listed types on signal.type.","examples":[{"field":"signal.type","op":"since","values":["company.incorporated"],"days":90}]},"WhereNode":{"anyOf":[{"$ref":"#/$defs/AllGroup"},{"$ref":"#/$defs/AnyGroup"},{"$ref":"#/$defs/NotGroup"},{"$ref":"#/$defs/BundleNode"},{"$ref":"#/$defs/Filter"}],"description":"A group (all, any, not), a title bundle or a filter. Groups nest up to 32 deep, and a where tree holds up to 1,000 filters, groups and bundles."},"WithinRadiusFilter":{"type":"object","properties":{"field":{"type":"string","enum":["site.location"]},"op":{"type":"string","const":"within_radius"},"centre":{"$ref":"#/$defs/RadiusCentre"},"radius_miles":{"type":"number","minimum":1,"maximum":100,"description":"Radius in miles, 1 to 100. Under 5 miles needs an account."}},"required":["field","op","centre","radius_miles"],"additionalProperties":false,"description":"Sites within radius_miles of the centre. The count reports the centroid used and the postcodes matched.","examples":[{"field":"site.location","op":"within_radius","centre":{"place":"Leeds"},"radius_miles":20}]}}},"annotations":{"title":"Count an audience","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"dab8cf121f679fcfef3b5233219c8f0922deaf1089fedf55a0d0fc498ca3ac1d","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T11:47:07.863Z","metadataTrust":"untrusted"},{"serverName":"com.emailmovers/mydatahub","endpointFingerprint":"4095f069b618dbc15e63a1fd53768b5a184a62fcd200aa4cf68cd54c5019440e","name":"create_order","title":"Create an order (spends credits)","description":"Spends 1 credit per complete UK record against a live machine quote from quote_order, and queues the order. It needs the quote_id and an idempotency_key to reuse on any retry, so a retry never charges twice; a flag set by a model is never consent. Where the host supports elicitation the user confirms the spend in a form or on mydatahub.emailmovers.com; otherwise an agent key must cover it within its per-order cap and monthly budget. If neither applies nothing is charged: the result is a confirmation-required error with an approval_url to give the user, so keep the quote_id; a short balance returns a top_up_url. Call get_order until the status is ready, then fetch_order_records. Lawful basis is UK GDPR Article 6(1)(f) legitimate interests; email audiences include corporate subscribers only by default (PECR), so sole traders and ordinary partnerships are left out unless the toggle is changed.","inputSchema":{"type":"object","properties":{"quote_id":{"type":"string","pattern":"^qte_[0-7][0-9A-HJKMNP-TV-Z]{25}$","description":"A live machine quote from quote_order. Without one nothing is charged.","examples":["qte_01JB4M2R6T1Y5W8ZAK8Q2V7XN3"]},"name":{"type":"string","minLength":1,"maxLength":200},"delivery":{"description":"api (fetch records), csv (signed download) and google_sheets. Default api.","minItems":1,"type":"array","items":{"type":"string","enum":["api","csv","google_sheets"]}},"confirmation_token":{"type":"string","minLength":16,"maxLength":2000,"description":"The token the approval page on mydatahub.emailmovers.com returns once the signed-in person approves. It is bound to that person (their sub), this spend (the machine quote_id, or the enrichment or push) and an expiry no later than the quote's, and it is redeemable once."},"idempotency_key":{"type":"string","minLength":1,"maxLength":255,"description":"Any unique string, such as a V4 UUID. Reuse it when retrying the same order so it is never charged twice; a different order needs a new key."}},"required":["quote_id","idempotency_key"],"additionalProperties":false},"annotations":{"title":"Create an order (spends credits)","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"09e21c8d3a5aee6113cd09be22bfdbea6fb1d669538d55667e251a91f7a3a1a5","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T11:47:07.863Z","metadataTrust":"untrusted"},{"serverName":"com.emailmovers/mydatahub","endpointFingerprint":"4095f069b618dbc15e63a1fd53768b5a184a62fcd200aa4cf68cd54c5019440e","name":"enrich_contact","title":"Enrich a contact (spends credits)","description":"Returns the full record for one known person, matched by email or by name with a company name, number or domain. It spends 1 credit only on a confident match, and 0 on no match or when you already hold the record under licence, so a repeat never charges twice. Like create_order it needs the user's confirmation (a form, or the confirmation_token from an approval_url) or an agent key whose allowed_tools include enrich_contact within its per-order cap and monthly budget; otherwise nothing is charged and it returns confirmation-required or agent-budget-exceeded. It needs enrich:write; use it for a single named person, and the result gives credits_charged and the balance left. Lawful basis is UK GDPR Article 6(1)(f) legitimate interests; email audiences include corporate subscribers only by default (PECR), so sole traders and ordinary partnerships are left out unless the toggle is changed.","inputSchema":{"type":"object","properties":{"email":{"type":"string","format":"email"},"first_name":{"type":"string","minLength":1,"maxLength":100},"last_name":{"type":"string","minLength":1,"maxLength":100},"company_name":{"type":"string","minLength":1,"maxLength":200},"company_number":{"type":"string","pattern":"^[A-Z0-9]{8}$","description":"Eight characters in upper case, such as 05046417 or SC123456."},"domain":{"type":"string","minLength":3,"maxLength":253},"confirmation_token":{"type":"string","minLength":16,"maxLength":2000,"description":"The token the approval page on mydatahub.emailmovers.com returns once the signed-in person approves. It is bound to that person (their sub), this spend (the machine quote_id, or the enrichment or push) and an expiry no later than the quote's, and it is redeemable once."}},"additionalProperties":false,"description":"One known person to match. Send email, or first_name and last_name with company_name, company_number or domain.","anyOf":[{"type":"object","properties":{"email":true},"required":["email"]},{"type":"object","properties":{"first_name":true,"last_name":true},"required":["first_name","last_name"],"anyOf":[{"type":"object","properties":{"company_name":true},"required":["company_name"]},{"type":"object","properties":{"company_number":true},"required":["company_number"]},{"type":"object","properties":{"domain":true},"required":["domain"]}]}]},"annotations":{"title":"Enrich a contact (spends credits)","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"26ace60cb9e401174963c059014b8752c1617bdbe1241282c0b02c85496573b1","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T11:47:07.863Z","metadataTrust":"untrusted"},{"serverName":"com.emailmovers/mydatahub","endpointFingerprint":"4095f069b618dbc15e63a1fd53768b5a184a62fcd200aa4cf68cd54c5019440e","name":"expand_job_titles","title":"Expand job titles","description":"Expands title keywords into every matching title (plurals, department synonyms, ampersands, abbreviations such as CEO), each with a count, or shows what a bundle such as sdm resolves to. Use it before counting so the user can see and edit which titles a keyword covers; nothing is expanded silently. Free and needs no account. Put the returned filter into the audience, then call count_audience. Lawful basis is UK GDPR Article 6(1)(f) legitimate interests; email audiences include corporate subscribers only by default (PECR), so sole traders and ordinary partnerships are left out unless the toggle is changed.","inputSchema":{"type":"object","properties":{"terms":{"description":"Title keywords to expand, such as marketing manager.","minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}},"bundle":{"description":"A title bundle to show: sdm, manager_and_above or owner_managed.","type":"string","enum":["sdm","manager_and_above","owner_managed"]},"mode":{"type":"string","enum":["contains","starts_with","exact"],"description":"contains (the default) matches titles containing a term, starts_with matches titles beginning with it, exact takes verbatim titles with no expansion."},"expand":{"description":"Expansion sets to apply, each once. Left out, the four default sets apply.","uniqueItems":true,"type":"array","items":{"type":"string","enum":["plural_singular","department_synonyms","ampersand_and","abbreviations","permutations"]}},"dataset":{"type":"string","enum":["uk_contacts","ie_contacts","global_contacts"],"description":"The dataset an audience draws from. uk_contacts is live; ie_contacts and global_contacts are listed but not yet served."}},"additionalProperties":false,"description":"Keywords or a bundle to expand into an editable title list: exactly one of terms or bundle.","oneOf":[{"type":"object","properties":{"terms":true},"required":["terms"]},{"type":"object","properties":{"bundle":true},"required":["bundle"]}]},"annotations":{"title":"Expand job titles","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"0f89005d3e7a2573551fc54cea4c6ffd90557ec29c5b1a306aaf99c799a4f6a4","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T11:47:07.863Z","metadataTrust":"untrusted"},{"serverName":"com.emailmovers/mydatahub","endpointFingerprint":"4095f069b618dbc15e63a1fd53768b5a184a62fcd200aa4cf68cd54c5019440e","name":"fetch_order_records","title":"Fetch order records","description":"Returns a page of an order's delivered records (50 by default, up to 100) with the licence block on every page, as JSON or, on request, as CSV. Pages stay under about 8,000 tokens, with approx_tokens on each; pass next_cursor to continue. Fetching again under licence costs 0 credits; it needs records:read. Call check_suppression before any send, and get_compliance_receipt for proof of screening. Lawful basis is UK GDPR Article 6(1)(f) legitimate interests; email audiences include corporate subscribers only by default (PECR), so sole traders and ordinary partnerships are left out unless the toggle is changed.","inputSchema":{"type":"object","properties":{"order_id":{"type":"string","pattern":"^ord_[0-7][0-9A-HJKMNP-TV-Z]{25}$","description":"The order whose records to fetch. It must be ready.","examples":["ord_01JB4N9S3W2X6Y7Z8A1B2C3D4E"]},"cursor":{"type":"string","minLength":1,"maxLength":512,"description":"An opaque cursor from next_cursor. Pass it back unchanged."},"limit":{"description":"Records per page, 1 to 100 over MCP so a result stays under about 8,000 tokens. Default 50.","default":50,"type":"integer","minimum":1,"maximum":100},"format":{"description":"json (default) or csv.","default":"json","type":"string","enum":["json","csv"]},"fields":{"description":"Columns to return; default the order's field set.","type":"array","items":{"type":"string","pattern":"^[a-z0-9_]+$"}}},"required":["order_id"],"additionalProperties":false},"annotations":{"title":"Fetch order records","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"0bd83021261041353463fcdc346fcd24d3ad6e61d74d5bdf38ba43ba0aa888f1","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T11:47:07.863Z","metadataTrust":"untrusted"},{"serverName":"com.emailmovers/mydatahub","endpointFingerprint":"4095f069b618dbc15e63a1fd53768b5a184a62fcd200aa4cf68cd54c5019440e","name":"get_account","title":"Account and balance","description":"Returns the organisation's credit balance by source, plan, per-action prices and rate limit, and for an agent key its monthly budget and per-order cap. Use it before quoting a large order, or when a spend is refused, to see what remains. Free; it needs a token with account:read. Top-ups happen on mydatahub.emailmovers.com, never inside a tool. Lawful basis is UK GDPR Article 6(1)(f) legitimate interests; email audiences include corporate subscribers only by default (PECR), so sole traders and ordinary partnerships are left out unless the toggle is changed.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"annotations":{"title":"Account and balance","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"53b7c05bd91f3ad97b01ad7e9cd7bd870740218ed03bc4a4e41093573b0aefc8","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T11:47:07.863Z","metadataTrust":"untrusted"},{"serverName":"com.emailmovers/mydatahub","endpointFingerprint":"4095f069b618dbc15e63a1fd53768b5a184a62fcd200aa4cf68cd54c5019440e","name":"get_compliance_receipt","title":"Get a compliance receipt","description":"Returns an order's signed compliance receipt: an ES256 JWS with its decoded claims and a PDF link, covering records delivered, suppression removals, subscriber classes, TPS screening, Article 14 status, the licence and the file hash. Use it to prove to the user, a colleague or another agent that a list is licensed and screened; anyone can verify it with POST /v1/compliance/receipts/verify. Free; it needs orders:read. Lawful basis is UK GDPR Article 6(1)(f) legitimate interests; email audiences include corporate subscribers only by default (PECR), so sole traders and ordinary partnerships are left out unless the toggle is changed.","inputSchema":{"type":"object","properties":{"order_id":{"type":"string","pattern":"^ord_[0-7][0-9A-HJKMNP-TV-Z]{25}$","description":"The order the receipt covers.","examples":["ord_01JB4N9S3W2X6Y7Z8A1B2C3D4E"]}},"required":["order_id"],"additionalProperties":false},"annotations":{"title":"Get a compliance receipt","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"baec0cdd3c995885fe5b165d3a6b707f737ac7acfd79b19bac2188e9852390b3","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T11:47:07.863Z","metadataTrust":"untrusted"},{"serverName":"com.emailmovers/mydatahub","endpointFingerprint":"4095f069b618dbc15e63a1fd53768b5a184a62fcd200aa4cf68cd54c5019440e","name":"get_order","title":"Get order status","description":"Returns one order's status (queued, building, verifying, ready, failed or cancelled), counts, charges, licence and links to its records, download and receipt, or the recent orders when order_id is left out. Use it after create_order to wait for ready, or rely on the order.ready webhook. Free; it needs orders:read. Call fetch_order_records once the status is ready. Lawful basis is UK GDPR Article 6(1)(f) legitimate interests; email audiences include corporate subscribers only by default (PECR), so sole traders and ordinary partnerships are left out unless the toggle is changed.","inputSchema":{"type":"object","properties":{"order_id":{"description":"The order to return. Leave it out for the recent orders, newest first.","type":"string","pattern":"^ord_[0-7][0-9A-HJKMNP-TV-Z]{25}$","examples":["ord_01JB4N9S3W2X6Y7Z8A1B2C3D4E"]},"status":{"type":"string","enum":["queued","building","verifying","ready","failed","cancelled"],"description":"queued, building, verifying, ready; failed if processing failed; cancelled (only while queued)."},"limit":{"description":"Items per page, 1 to 100. Default 25.","default":25,"type":"integer","minimum":1,"maximum":100},"cursor":{"type":"string","minLength":1,"maxLength":512,"description":"An opaque cursor from next_cursor. Pass it back unchanged."}},"additionalProperties":false},"annotations":{"title":"Get order status","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"f2bd20409b8661a2286ec7d1513b707df98be84ff2f5c69ebb3811fe9053f2e2","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T11:47:07.863Z","metadataTrust":"untrusted"},{"serverName":"com.emailmovers/mydatahub","endpointFingerprint":"4095f069b618dbc15e63a1fd53768b5a184a62fcd200aa4cf68cd54c5019440e","name":"get_plans","title":"Plans and prices","description":"Returns the plans of MyDataHub by Emailmovers, the UK B2B count engine: credit packs, credit rules, licence terms, the bounce warranty and the free trial, in GBP excluding VAT. Use it when the user asks what a list costs or which plan fits; it is free and needs no account. One credit buys one complete UK record at the same price in the app, the API and here. Call get_account for the caller's own balance, or count_audience to size a list. Lawful basis is UK GDPR Article 6(1)(f) legitimate interests; email audiences include corporate subscribers only by default (PECR), so sole traders and ordinary partnerships are left out unless the toggle is changed.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"annotations":{"title":"Plans and prices","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"208b2ddc25d6f2e71f8cd6cc7428a4102b20af96628fdc60ce692b835f9f7f19","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T11:47:07.863Z","metadataTrust":"untrusted"},{"serverName":"com.emailmovers/mydatahub","endpointFingerprint":"4095f069b618dbc15e63a1fd53768b5a184a62fcd200aa4cf68cd54c5019440e","name":"list_audiences","title":"List saved audiences","description":"Lists the organisation's saved audiences with their current counts and last refresh, newest first, optionally filtered by name. Use it to find an aud_ id to count, quote or share. Free; it needs audiences:read. Pass an aud_ id to count_audience for a fresh count. Lawful basis is UK GDPR Article 6(1)(f) legitimate interests; email audiences include corporate subscribers only by default (PECR), so sole traders and ordinary partnerships are left out unless the toggle is changed.","inputSchema":{"type":"object","properties":{"q":{"description":"Filter by name.","type":"string","maxLength":100},"limit":{"description":"Items per page, 1 to 100. Default 25.","default":25,"type":"integer","minimum":1,"maximum":100},"cursor":{"type":"string","minLength":1,"maxLength":512,"description":"An opaque cursor from next_cursor. Pass it back unchanged."}},"additionalProperties":false},"annotations":{"title":"List saved audiences","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"a8b8796d40b13205bcdf44c34a6c128c21586c4657fcddd6e4a1006019d8e4ea","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T11:47:07.863Z","metadataTrust":"untrusted"},{"serverName":"com.emailmovers/mydatahub","endpointFingerprint":"4095f069b618dbc15e63a1fd53768b5a184a62fcd200aa4cf68cd54c5019440e","name":"list_field_sets","title":"List field sets","description":"Lists the field sets an order can deliver, such as standard or standard_telephone, with their exact columns. Every field set costs 1 credit a record, with no telephone, download or API surcharge. Use it to pick the field_set for quote_order; it is free and needs no account. Lawful basis is UK GDPR Article 6(1)(f) legitimate interests; email audiences include corporate subscribers only by default (PECR), so sole traders and ordinary partnerships are left out unless the toggle is changed.","inputSchema":{"type":"object","properties":{"limit":{"description":"Items per page, 1 to 100. Default 25.","default":25,"type":"integer","minimum":1,"maximum":100},"cursor":{"type":"string","minLength":1,"maxLength":512,"description":"An opaque cursor from next_cursor. Pass it back unchanged."}},"additionalProperties":false},"annotations":{"title":"List field sets","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"388a250f438b0de355764db823fea7bf0b6e73ef8498cef36a63231b877f6fde","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T11:47:07.863Z","metadataTrust":"untrusted"},{"serverName":"com.emailmovers/mydatahub","endpointFingerprint":"4095f069b618dbc15e63a1fd53768b5a184a62fcd200aa4cf68cd54c5019440e","name":"list_filters","title":"Filter catalogue","description":"Lists every filterable field of the audience definition (mydatahub.audience/1) with its group, type, operators, value count and default, plus the datasets. Use it first to learn field names such as company.employee_band or site.town before building an audience by hand. Free and needs no account; the same catalogue is the mydatahub://catalogue resource. Call search_filter_values to find the codes for one field. Lawful basis is UK GDPR Article 6(1)(f) legitimate interests; email audiences include corporate subscribers only by default (PECR), so sole traders and ordinary partnerships are left out unless the toggle is changed.","inputSchema":{"type":"object","properties":{"dataset":{"type":"string","enum":["uk_contacts","ie_contacts","global_contacts"],"description":"The dataset an audience draws from. uk_contacts is live; ie_contacts and global_contacts are listed but not yet served."}},"additionalProperties":false},"annotations":{"title":"Filter catalogue","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"06e5f82a9a7fe3811a459e2220ca8b78bc3dd3699c7c71a77f7e6816c597f8e6","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T11:47:07.863Z","metadataTrust":"untrusted"},{"serverName":"com.emailmovers/mydatahub","endpointFingerprint":"4095f069b618dbc15e63a1fd53768b5a184a62fcd200aa4cf68cd54c5019440e","name":"lookup_company","title":"Look up a company","description":"Looks up one company by Companies House number, domain or name and returns its Companies House fields and compliance facts, and for a signed-in caller the contacts held there by job level. It returns no contact details: use enrich_contact for one known person, or count_audience for everyone at the company. Free and needs no account, though the contacts held are a single company count that needs an account (null when signed out). Lawful basis is UK GDPR Article 6(1)(f) legitimate interests; email audiences include corporate subscribers only by default (PECR), so sole traders and ordinary partnerships are left out unless the toggle is changed.","inputSchema":{"type":"object","properties":{"company_number":{"type":"string","pattern":"^[A-Z0-9]{8}$","description":"Eight characters in upper case, such as 05046417 or SC123456."},"domain":{"type":"string","minLength":3,"maxLength":253},"name":{"type":"string","minLength":2,"maxLength":200},"town":{"description":"Narrows a name search.","type":"string","maxLength":100}},"additionalProperties":false,"description":"A company by exactly one of number, domain or name.","oneOf":[{"type":"object","properties":{"company_number":true},"required":["company_number"]},{"type":"object","properties":{"domain":true},"required":["domain"]},{"type":"object","properties":{"name":true},"required":["name"]}]},"annotations":{"title":"Look up a company","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"47c9470922c6d6709c68c8e084dcf1a19d5dfa248131bf7b38ae841c5453e6c0","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T11:47:07.863Z","metadataTrust":"untrusted"},{"serverName":"com.emailmovers/mydatahub","endpointFingerprint":"4095f069b618dbc15e63a1fd53768b5a184a62fcd200aa4cf68cd54c5019440e","name":"preview_records","title":"Preview sample records","description":"Returns up to 25 masked sample rows (10 by default) for an audience or a count id, each with verification badges, why it matches and a provenance card. Use it after count_audience to show the user what the records look like before quoting. Free: emails and phones are masked on the server, a repeat returns the same rows, and no rows come back when the count is under 25. Call quote_order next to price the records. Lawful basis is UK GDPR Article 6(1)(f) legitimate interests; email audiences include corporate subscribers only by default (PECR), so sole traders and ordinary partnerships are left out unless the toggle is changed.","inputSchema":{"type":"object","properties":{"audience":{"type":["string","object"],"$ref":"#/$defs/AudienceRef"},"count_id":{"description":"A count id instead of an audience.","type":"string","pattern":"^cnt_[A-Za-z2-7]{20}$","examples":["cnt_7K2PQ4MAXN3R6TBY5WDZ"]},"limit":{"description":"Rows to return, 1 to 25. Default 10.","default":10,"type":"integer","minimum":1,"maximum":25},"shuffle":{"description":"Draw a new seed. Counts against your rate budget and is logged. Default false, so a repeat returns the same rows.","default":false,"type":"boolean"}},"additionalProperties":false,"description":"The audience or count to sample: exactly one of audience or count_id.","oneOf":[{"type":"object","properties":{"audience":true},"required":["audience"]},{"type":"object","properties":{"count_id":true},"required":["count_id"]}],"$defs":{"AllGroup":{"type":"object","properties":{"all":{"minItems":1,"type":"array","items":{"$ref":"#/$defs/WhereNode"}}},"required":["all"],"additionalProperties":false,"description":"AND: every node inside must match."},"AnyGroup":{"type":"object","properties":{"any":{"minItems":1,"type":"array","items":{"$ref":"#/$defs/WhereNode"}}},"required":["any"],"additionalProperties":false,"description":"OR: at least one node inside must match."},"Audience":{"type":"object","properties":{"schema":{"type":"string","const":"mydatahub.audience/1","description":"The definition's namespace and version. Older versions are upgraded by a pure function."},"dataset":{"type":"string","enum":["uk_contacts","ie_contacts","global_contacts"],"description":"The dataset an audience draws from. uk_contacts is live; ie_contacts and global_contacts are listed but not yet served."},"dataset_version":{"description":"The weekly build to count against, such as 2026-W39. Left out, the current version is filled in and returned.","type":"string","pattern":"^[0-9]{4}-W(0[1-9]|[1-4][0-9]|5[0-3])$","examples":["2026-W39"]},"where":{"description":"The filters. Left out, the audience is the whole dataset after the defaults.","$ref":"#/$defs/WhereNode"},"email_policy":{"$ref":"#/$defs/EmailPolicy"},"dedupe":{"type":"string","enum":["none","one_per_company","one_per_site"],"description":"none keeps every matching contact, one_per_company keeps one contact per company, one_per_site keeps one per site. Default none."}},"required":["schema"],"additionalProperties":false,"title":"MyDataHub audience definition (mydatahub.audience/1)","description":"Who you want, as filters grouped by entity (company., site., contact., email., phone., signal.). The server fills its defaults (active companies, named emails, corporate subscribers, the current dataset_version) and returns the effective definition with every count."},"AudienceRef":{"anyOf":[{"type":"string","pattern":"^aud_[0-7][0-9A-HJKMNP-TV-Z]{25}$","description":"Format: an audience id: aud_ followed by a 26 character ULID in upper case Crockford base32, such as aud_01JB4H2K9V6XN3M9R6T1Y5W8ZA.","examples":["aud_01JB4H2K9V6XN3M9R6T1Y5W8ZA"]},{"$ref":"#/$defs/Audience"}],"description":"An audience definition (mydatahub.audience/1) inline, or the aud_ id of a saved audience."},"BetweenFilter":{"type":"object","properties":{"field":{"type":"string","enum":["company.employee_band","company.turnover_band","company.fleet_band","contact.job_level_rank","email.deliverability_score"]},"op":{"type":"string","const":"between"},"from":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"number"}],"description":"A band code or a number from the field's order."},"to":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"number"}],"description":"A band code or a number from the field's order."}},"required":["field","op","from","to"],"additionalProperties":false,"description":"The field lies from one value to another inclusive, over the field's order.","examples":[{"field":"company.employee_band","op":"between","from":"10-19","to":"200-349"}]},"BundleNode":{"type":"object","properties":{"bundle":{"type":"string","enum":["sdm","manager_and_above","owner_managed"]}},"required":["bundle"],"additionalProperties":false,"description":"A title bundle, resolved to its filters in the effective definition: sdm (senior decision makers), manager_and_above (managers and above), owner_managed (owner managed)."},"EmailPolicy":{"type":"object","properties":{"min_deliverability_score":{"description":"Lowest deliverability score counted, 0 to 100. Default 70.","type":"integer","minimum":0,"maximum":100},"allow_catch_all":{"description":"Whether catch-all addresses count. Default false.","type":"boolean"}},"additionalProperties":false,"description":"Email quality floor. Defaults: min_deliverability_score 70, allow_catch_all false."},"Filter":{"oneOf":[{"$ref":"#/$defs/InFilter"},{"$ref":"#/$defs/BetweenFilter"},{"$ref":"#/$defs/GteFilter"},{"$ref":"#/$defs/LteFilter"},{"$ref":"#/$defs/MatchesFilter"},{"$ref":"#/$defs/WithinRadiusFilter"},{"$ref":"#/$defs/InListFilter"},{"$ref":"#/$defs/SinceFilter"}],"description":"One criterion: a field from GET /v1/catalogue/filters, an operator and its operands. Exclusions nest under not."},"GteFilter":{"type":"object","properties":{"field":{"type":"string","enum":["company.employee_band","company.turnover_band","company.fleet_band","contact.job_level_rank","email.deliverability_score"]},"op":{"type":"string","const":"gte"},"value":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"number"}],"description":"A band code or a number from the field's order."}},"required":["field","op","value"],"additionalProperties":false,"description":"The field is at or after the value in its order: for bands, the band and every larger one.","examples":[{"field":"company.employee_band","op":"gte","value":"50-99"}]},"InFilter":{"type":"object","properties":{"field":{"type":"string","enum":["company.sic_2007","company.business_class","company.employee_band","company.turnover_band","company.fleet_band","company.type","company.status","company.subscriber_class","company.companies_house_number","site.region","site.county","site.town","site.postcode","contact.title_family","contact.job_function","contact.job_level_rank","contact.premium","email.exists","email.type","phone.exists","phone.tps_ctps_status"]},"op":{"type":"string","const":"in"},"values":{"minItems":1,"maxItems":10000,"type":"array","items":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"number"},{"type":"boolean"}],"description":"A code, a rank or a boolean, as the field's catalogue lists it."}}},"required":["field","op","values"],"additionalProperties":false,"description":"The field holds one of the listed codes.","examples":[{"field":"company.sic_2007","op":"in","values":["C"]}]},"InListFilter":{"type":"object","properties":{"field":{"type":"string","enum":["company.companies_house_number","contact.title","email.address_sha256","email.domain_sha256","phone.e164_sha256"]},"op":{"type":"string","const":"in_list"},"list_id":{"type":"string","pattern":"^sup_[0-7][0-9A-HJKMNP-TV-Z]{25}$","description":"Format: a suppression list id: sup_ followed by a 26 character ULID in upper case Crockford base32, such as sup_01JB4H7Q2V7XN3M9R6T1Y5W8ZA.","examples":["sup_01JB4H7Q2V7XN3M9R6T1Y5W8ZA"]}},"required":["field","op","list_id"],"additionalProperties":false,"description":"The record's hashed email, domain, phone, company number or title term is on a suppression list. Usually nested under not; each list reports the records it removed.","examples":[{"field":"email.address_sha256","op":"in_list","list_id":"sup_01JB4H7Q2V7XN3M9R6T1Y5W8ZA"}]},"LteFilter":{"type":"object","properties":{"field":{"type":"string","enum":["company.employee_band","company.turnover_band","company.fleet_band","contact.job_level_rank","contact.company_contact_rank","email.deliverability_score"]},"op":{"type":"string","const":"lte"},"value":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"number"}],"description":"A band code or a number from the field's order."}},"required":["field","op","value"],"additionalProperties":false,"description":"The field is at or before the value in its order. Rank 1 is the most senior, so Director and above is contact.job_level_rank lte 6.","examples":[{"field":"contact.job_level_rank","op":"lte","value":6}]},"MatchesFilter":{"type":"object","properties":{"field":{"type":"string","enum":["contact.title"]},"op":{"type":"string","const":"matches"},"terms":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}},"mode":{"type":"string","enum":["contains","starts_with","exact"],"description":"contains (the default) matches titles containing a term, starts_with matches titles beginning with it, exact takes verbatim titles with no expansion."},"expand":{"description":"Expansion sets to apply, each once: plural_singular, department_synonyms, ampersand_and, abbreviations, permutations. Left out, the first four apply; an empty list applies none. Not used with mode exact.","uniqueItems":true,"maxItems":5,"type":"array","items":{"type":"string","enum":["plural_singular","department_synonyms","ampersand_and","abbreviations","permutations"]}},"exclude_terms":{"description":"Expanded terms removed by hand. Kept in the definition so the count stays reproducible when the title dictionary changes.","maxItems":500,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["field","op","terms"],"additionalProperties":false,"description":"Job title keyword match. mode contains (the default) or starts_with expands each term with the expansion sets; mode exact matches verbatim titles. Every expanded term is returned with the count.","examples":[{"field":"contact.title","op":"matches","terms":["marketing manager"],"mode":"contains","expand":["plural_singular","department_synonyms","ampersand_and","abbreviations"]}],"allOf":[{"if":{"type":"object","properties":{"mode":{"const":"exact"}},"required":["mode"]},"then":{"type":"object","properties":{"expand":{"type":"array","maxItems":0},"exclude_terms":{"type":"array","maxItems":0}}}}]},"NotGroup":{"type":"object","properties":{"not":{"$ref":"#/$defs/WhereNode"}},"required":["not"],"additionalProperties":false,"description":"Negation: the single node inside must not match."},"PlaceCentre":{"type":"object","properties":{"place":{"type":"string","minLength":1,"maxLength":100,"description":"A place name, resolved with resolve_location, such as Leeds."},"code":{"description":"The ONS geography code of the chosen candidate when resolve_location found more than one, such as E08000035 for the Leeds district.","type":"string","minLength":1,"maxLength":20}},"required":["place"],"additionalProperties":false,"description":"A named place. Ambiguous names come back from resolve_location as candidates, never a silent choice."},"PointCentre":{"type":"object","properties":{"lat":{"type":"number","minimum":49,"maximum":61},"lon":{"type":"number","minimum":-9,"maximum":2}},"required":["lat","lon"],"additionalProperties":false,"description":"A latitude and longitude in WGS84 degrees."},"PostcodeCentre":{"type":"object","properties":{"postcode":{"type":"string","pattern":"^[A-Za-z]{1,2}([0-9][0-9A-Za-z]?( [0-9]([A-Za-z]{2})?| ?[0-9][A-Za-z]{2})?)?$","description":"The centroid of a postcode unit, sector, district or area, such as LS1 4AP."}},"required":["postcode"],"additionalProperties":false,"description":"A postcode centroid from ONSPD."},"RadiusCentre":{"anyOf":[{"$ref":"#/$defs/PlaceCentre"},{"$ref":"#/$defs/PostcodeCentre"},{"$ref":"#/$defs/PointCentre"}],"description":"The centre of a radius: a place, a postcode or a latitude and longitude."},"SinceFilter":{"type":"object","properties":{"field":{"type":"string","enum":["contact.last_validated_at","email.last_verified_at","signal.type","signal.observed_at"]},"op":{"type":"string","const":"since"},"days":{"type":"integer","minimum":1,"maximum":3650},"values":{"description":"For signal.type only: the signal types to look for, such as company.incorporated.","minItems":1,"maxItems":10000,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["field","op","days"],"additionalProperties":false,"description":"Within the last N days: a date field, or a Companies House signal of the listed types on signal.type.","examples":[{"field":"signal.type","op":"since","values":["company.incorporated"],"days":90}]},"WhereNode":{"anyOf":[{"$ref":"#/$defs/AllGroup"},{"$ref":"#/$defs/AnyGroup"},{"$ref":"#/$defs/NotGroup"},{"$ref":"#/$defs/BundleNode"},{"$ref":"#/$defs/Filter"}],"description":"A group (all, any, not), a title bundle or a filter. Groups nest up to 32 deep, and a where tree holds up to 1,000 filters, groups and bundles."},"WithinRadiusFilter":{"type":"object","properties":{"field":{"type":"string","enum":["site.location"]},"op":{"type":"string","const":"within_radius"},"centre":{"$ref":"#/$defs/RadiusCentre"},"radius_miles":{"type":"number","minimum":1,"maximum":100,"description":"Radius in miles, 1 to 100. Under 5 miles needs an account."}},"required":["field","op","centre","radius_miles"],"additionalProperties":false,"description":"Sites within radius_miles of the centre. The count reports the centroid used and the postcodes matched.","examples":[{"field":"site.location","op":"within_radius","centre":{"place":"Leeds"},"radius_miles":20}]}}},"annotations":{"title":"Preview sample records","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"0b399247cc5d6b6975d55b0840060cde2c26932650000c577f7dc6f3a88958b4","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T11:47:07.863Z","metadataTrust":"untrusted"},{"serverName":"com.emailmovers/mydatahub","endpointFingerprint":"4095f069b618dbc15e63a1fd53768b5a184a62fcd200aa4cf68cd54c5019440e","name":"push_to_crm","title":"Push an order to a CRM","description":"Pushes an order's records to a connected CRM such as HubSpot or Salesforce, keyed on mydatahub_record_id, as record operations only: nothing is ever sent to the contacts. dry_run defaults to true and reports what would be created, updated or skipped; a live push needs the user's confirmation or an agent key allowed push_to_crm on that connection, or it returns confirmation-required. Free; it needs pushes:write and a connection made in the app. Show the dry run to the user before a live push. Lawful basis is UK GDPR Article 6(1)(f) legitimate interests; email audiences include corporate subscribers only by default (PECR), so sole traders and ordinary partnerships are left out unless the toggle is changed.","inputSchema":{"type":"object","properties":{"order_id":{"type":"string","pattern":"^ord_[0-7][0-9A-HJKMNP-TV-Z]{25}$","description":"The order whose records to push.","examples":["ord_01JB4N9S3W2X6Y7Z8A1B2C3D4E"]},"connection_id":{"type":"string","pattern":"^conn_[0-7][0-9A-HJKMNP-TV-Z]{25}$","description":"Format: a CRM connection id: conn_ followed by a 26 character ULID in upper case Crockford base32, such as conn_01JB3Y2X6Y7Z8A1B2C3D4E5F6G.","examples":["conn_01JB3Y2X6Y7Z8A1B2C3D4E5F6G"]},"dry_run":{"description":"Default true: report what would change without writing. A live push needs approval: a person's confirmation, or an agent key allowed push_to_crm on this connection.","default":true,"type":"boolean"},"update_existing":{"description":"Update records already in the CRM, matched on mydatahub_record_id. Default true.","default":true,"type":"boolean"},"confirmation_token":{"type":"string","minLength":16,"maxLength":2000,"description":"The token the approval page on mydatahub.emailmovers.com returns once the signed-in person approves. It is bound to that person (their sub), this spend (the machine quote_id, or the enrichment or push) and an expiry no later than the quote's, and it is redeemable once."}},"required":["order_id","connection_id"],"additionalProperties":false},"annotations":{"title":"Push an order to a CRM","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"definitionHash":"c82b77f4de09e59ea7f8ff3cef0e67da6bddb41098df836cc33a2c121982f853","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T11:47:07.863Z","metadataTrust":"untrusted"},{"serverName":"com.emailmovers/mydatahub","endpointFingerprint":"4095f069b618dbc15e63a1fd53768b5a184a62fcd200aa4cf68cd54c5019440e","name":"quote_order","title":"Quote an order","description":"Creates a machine quote for a count: the records you would receive after removing ones already held and suppressed, the credits and GBP price, the licence, the warranty and any blockers. The quote_id lasts 24 hours and is bound to the dataset version; it is not a human sales quote, which is a 14 day PDF made in the app. Free and needs no account, and nothing is charged. Show the credits and price to the user, then call create_order with the quote_id. Lawful basis is UK GDPR Article 6(1)(f) legitimate interests; email audiences include corporate subscribers only by default (PECR), so sole traders and ordinary partnerships are left out unless the toggle is changed.","inputSchema":{"type":"object","properties":{"count_id":{"type":"string","pattern":"^cnt_[A-Za-z2-7]{20}$","description":"A count id from POST /v1/counts or count_audience. Either case is accepted; responses use upper case.","examples":["cnt_7K2PQ4MAXN3R6TBY5WDZ"]},"field_set":{"type":"string","pattern":"^[a-z0-9]+(_[a-z0-9]+)*$","description":"A field set id from GET /v1/field-sets, such as standard."},"limit":{"description":"Records to buy; left out, the whole count.","type":"integer","minimum":1,"maximum":1000000},"dedupe_against":{"description":"Remove records you already hold: from earlier orders, from a connected CRM, or both. Default previous_orders when signed in. crm and previous_orders_and_crm need connection_id.","default":"previous_orders","type":"string","enum":["none","previous_orders","crm","previous_orders_and_crm"]},"connection_id":{"description":"The CRM connection to check, only with dedupe_against crm or previous_orders_and_crm.","type":"string","pattern":"^conn_[0-7][0-9A-HJKMNP-TV-Z]{25}$","examples":["conn_01JB3Y2X6Y7Z8A1B2C3D4E5F6G"]},"licence":{"default":"multi_use_12m","type":"string","enum":["multi_use_12m","outright"],"description":"multi_use_12m (12 month multi-use, every plan) or outright (1.8 credits a record, proposed)."}},"required":["count_id","field_set"],"additionalProperties":false,"description":"What to price: a count, a field set, how many records and the licence. Free, and needs no account.","allOf":[{"if":{"type":"object","properties":{"dedupe_against":{"enum":["crm","previous_orders_and_crm"]}},"required":["dedupe_against"]},"then":{"type":"object","properties":{"connection_id":true},"required":["connection_id"]}},{"if":{"type":"object","properties":{"connection_id":true},"required":["connection_id"]},"then":{"type":"object","properties":{"dedupe_against":{"enum":["crm","previous_orders_and_crm"]}},"required":["dedupe_against"]}}]},"annotations":{"title":"Quote an order","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"d477ad5b3427f3e79a180979740f2af62823b122ab0a0c5d860c5ae1dcd914f0","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T11:47:07.863Z","metadataTrust":"untrusted"},{"serverName":"com.emailmovers/mydatahub","endpointFingerprint":"4095f069b618dbc15e63a1fd53768b5a184a62fcd200aa4cf68cd54c5019440e","name":"report_objection","title":"Report an objection","description":"Records an objection to direct marketing for one record, by record id or email hash. Scope licensee suppresses it for your organisation at once; scope emailmovers suppresses it database-wide within one working day and tells every licensee holding it. Free; it needs suppressions:write, and repeating the same objection returns the same suppression. Call it whenever a contact objects, in any channel. Lawful basis is UK GDPR Article 6(1)(f) legitimate interests; email audiences include corporate subscribers only by default (PECR), so sole traders and ordinary partnerships are left out unless the toggle is changed.","inputSchema":{"type":"object","properties":{"record_id":{"type":"string","pattern":"^contact_[0-7][0-9A-HJKMNP-TV-Z]{25}$","description":"Format: a contact id: contact_ followed by a 26 character ULID in upper case Crockford base32, such as contact_01JA9X2V7XN3M9R6T1Y5W8ZAK8.","examples":["contact_01JA9X2V7XN3M9R6T1Y5W8ZAK8"]},"email_sha256":{"description":"SHA-256 of the trimmed, lower cased address, when the record id is not known.","type":"string","pattern":"^[0-9a-f]{64}$"},"channel":{"type":"string","enum":["email","telephone","post","web_form","other"]},"received_at":{"type":"string","format":"date-time","description":"RFC 3339 date and time, with Z or an offset such as +01:00."},"scope":{"type":"string","enum":["licensee","emailmovers"],"description":"licensee suppresses the record for your organisation at once; emailmovers suppresses it database-wide within one working day."},"note":{"type":"string","maxLength":2000}},"required":["channel","received_at","scope"],"additionalProperties":false,"description":"An objection to direct marketing, to record and propagate: exactly one of record_id or email_sha256.","oneOf":[{"type":"object","properties":{"record_id":true},"required":["record_id"]},{"type":"object","properties":{"email_sha256":true},"required":["email_sha256"]}]},"annotations":{"title":"Report an objection","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"40c779d529d080f930cccfdd2cd3da1e78c9056d9e06b21d50213f093efd3b38","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T11:47:07.863Z","metadataTrust":"untrusted"},{"serverName":"com.emailmovers/mydatahub","endpointFingerprint":"4095f069b618dbc15e63a1fd53768b5a184a62fcd200aa4cf68cd54c5019440e","name":"resolve_location","title":"Resolve a location","description":"Turns free text such as 20 miles of Leeds, Yorkshire or LS1 into region, county, town, postcode or radius filters, each with a count and a ready filter. Ambiguous places come back as candidates with a question, so ask the user which they meant rather than choosing. Free and needs no account, though a radius under 5 miles needs an account. Add the chosen filter to the audience, then call count_audience. Lawful basis is UK GDPR Article 6(1)(f) legitimate interests; email audiences include corporate subscribers only by default (PECR), so sole traders and ordinary partnerships are left out unless the toggle is changed.","inputSchema":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":200,"description":"Free text such as \"20 miles of Leeds\", \"Yorkshire\" or \"SW1\"."},"radius_miles":{"type":"number","minimum":1,"maximum":100},"dataset":{"type":"string","enum":["uk_contacts","ie_contacts","global_contacts"],"description":"The dataset an audience draws from. uk_contacts is live; ie_contacts and global_contacts are listed but not yet served."}},"required":["text"],"additionalProperties":false,"description":"A place to resolve into geography filters."},"annotations":{"title":"Resolve a location","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"edb4b4fbf7e6ff435d23e8c158ba8d97458e7ce27c8386f838d6dbdd861f4f2a","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T11:47:07.863Z","metadataTrust":"untrusted"},{"serverName":"com.emailmovers/mydatahub","endpointFingerprint":"4095f069b618dbc15e63a1fd53768b5a184a62fcd200aa4cf68cd54c5019440e","name":"save_audience","title":"Save an audience","description":"Saves an audience definition under a name, shared across the organisation, or updates a saved one when audience_id is given. Use it when the user wants to keep, share or recount a list later; saving is free and needs audiences:write. Repeating the same call returns the same saved audience. Call list_audiences to find it again, or count_audience with its aud_ id. Lawful basis is UK GDPR Article 6(1)(f) legitimate interests; email audiences include corporate subscribers only by default (PECR), so sole traders and ordinary partnerships are left out unless the toggle is changed.","inputSchema":{"type":"object","properties":{"audience_id":{"description":"A saved audience to update. Leave it out to save a new one.","type":"string","pattern":"^aud_[0-7][0-9A-HJKMNP-TV-Z]{25}$","examples":["aud_01JB4H2K9V6XN3M9R6T1Y5W8ZA"]},"name":{"type":"string","minLength":1,"maxLength":200},"audience":{"type":"object","$ref":"#/$defs/Audience"},"brief":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}]}},"additionalProperties":false,"description":"Save a new audience (name and audience, brief optional) or update one (audience_id and at least one of name, audience or brief).","anyOf":[{"type":"object","properties":{"name":true,"audience":true,"brief":{"type":"string"}},"required":["name","audience"],"not":{"type":"object","properties":{"audience_id":true},"required":["audience_id"]}},{"type":"object","properties":{"audience_id":true},"required":["audience_id"],"anyOf":[{"type":"object","properties":{"name":true},"required":["name"]},{"type":"object","properties":{"audience":true},"required":["audience"]},{"type":"object","properties":{"brief":true},"required":["brief"]}]}],"$defs":{"AllGroup":{"type":"object","properties":{"all":{"minItems":1,"type":"array","items":{"$ref":"#/$defs/WhereNode"}}},"required":["all"],"additionalProperties":false,"description":"AND: every node inside must match."},"AnyGroup":{"type":"object","properties":{"any":{"minItems":1,"type":"array","items":{"$ref":"#/$defs/WhereNode"}}},"required":["any"],"additionalProperties":false,"description":"OR: at least one node inside must match."},"Audience":{"type":"object","properties":{"schema":{"type":"string","const":"mydatahub.audience/1","description":"The definition's namespace and version. Older versions are upgraded by a pure function."},"dataset":{"type":"string","enum":["uk_contacts","ie_contacts","global_contacts"],"description":"The dataset an audience draws from. uk_contacts is live; ie_contacts and global_contacts are listed but not yet served."},"dataset_version":{"description":"The weekly build to count against, such as 2026-W39. Left out, the current version is filled in and returned.","type":"string","pattern":"^[0-9]{4}-W(0[1-9]|[1-4][0-9]|5[0-3])$","examples":["2026-W39"]},"where":{"description":"The filters. Left out, the audience is the whole dataset after the defaults.","$ref":"#/$defs/WhereNode"},"email_policy":{"$ref":"#/$defs/EmailPolicy"},"dedupe":{"type":"string","enum":["none","one_per_company","one_per_site"],"description":"none keeps every matching contact, one_per_company keeps one contact per company, one_per_site keeps one per site. Default none."}},"required":["schema"],"additionalProperties":false,"title":"MyDataHub audience definition (mydatahub.audience/1)","description":"Who you want, as filters grouped by entity (company., site., contact., email., phone., signal.). The server fills its defaults (active companies, named emails, corporate subscribers, the current dataset_version) and returns the effective definition with every count."},"BetweenFilter":{"type":"object","properties":{"field":{"type":"string","enum":["company.employee_band","company.turnover_band","company.fleet_band","contact.job_level_rank","email.deliverability_score"]},"op":{"type":"string","const":"between"},"from":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"number"}],"description":"A band code or a number from the field's order."},"to":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"number"}],"description":"A band code or a number from the field's order."}},"required":["field","op","from","to"],"additionalProperties":false,"description":"The field lies from one value to another inclusive, over the field's order.","examples":[{"field":"company.employee_band","op":"between","from":"10-19","to":"200-349"}]},"BundleNode":{"type":"object","properties":{"bundle":{"type":"string","enum":["sdm","manager_and_above","owner_managed"]}},"required":["bundle"],"additionalProperties":false,"description":"A title bundle, resolved to its filters in the effective definition: sdm (senior decision makers), manager_and_above (managers and above), owner_managed (owner managed)."},"EmailPolicy":{"type":"object","properties":{"min_deliverability_score":{"description":"Lowest deliverability score counted, 0 to 100. Default 70.","type":"integer","minimum":0,"maximum":100},"allow_catch_all":{"description":"Whether catch-all addresses count. Default false.","type":"boolean"}},"additionalProperties":false,"description":"Email quality floor. Defaults: min_deliverability_score 70, allow_catch_all false."},"Filter":{"oneOf":[{"$ref":"#/$defs/InFilter"},{"$ref":"#/$defs/BetweenFilter"},{"$ref":"#/$defs/GteFilter"},{"$ref":"#/$defs/LteFilter"},{"$ref":"#/$defs/MatchesFilter"},{"$ref":"#/$defs/WithinRadiusFilter"},{"$ref":"#/$defs/InListFilter"},{"$ref":"#/$defs/SinceFilter"}],"description":"One criterion: a field from GET /v1/catalogue/filters, an operator and its operands. Exclusions nest under not."},"GteFilter":{"type":"object","properties":{"field":{"type":"string","enum":["company.employee_band","company.turnover_band","company.fleet_band","contact.job_level_rank","email.deliverability_score"]},"op":{"type":"string","const":"gte"},"value":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"number"}],"description":"A band code or a number from the field's order."}},"required":["field","op","value"],"additionalProperties":false,"description":"The field is at or after the value in its order: for bands, the band and every larger one.","examples":[{"field":"company.employee_band","op":"gte","value":"50-99"}]},"InFilter":{"type":"object","properties":{"field":{"type":"string","enum":["company.sic_2007","company.business_class","company.employee_band","company.turnover_band","company.fleet_band","company.type","company.status","company.subscriber_class","company.companies_house_number","site.region","site.county","site.town","site.postcode","contact.title_family","contact.job_function","contact.job_level_rank","contact.premium","email.exists","email.type","phone.exists","phone.tps_ctps_status"]},"op":{"type":"string","const":"in"},"values":{"minItems":1,"maxItems":10000,"type":"array","items":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"number"},{"type":"boolean"}],"description":"A code, a rank or a boolean, as the field's catalogue lists it."}}},"required":["field","op","values"],"additionalProperties":false,"description":"The field holds one of the listed codes.","examples":[{"field":"company.sic_2007","op":"in","values":["C"]}]},"InListFilter":{"type":"object","properties":{"field":{"type":"string","enum":["company.companies_house_number","contact.title","email.address_sha256","email.domain_sha256","phone.e164_sha256"]},"op":{"type":"string","const":"in_list"},"list_id":{"type":"string","pattern":"^sup_[0-7][0-9A-HJKMNP-TV-Z]{25}$","description":"Format: a suppression list id: sup_ followed by a 26 character ULID in upper case Crockford base32, such as sup_01JB4H7Q2V7XN3M9R6T1Y5W8ZA.","examples":["sup_01JB4H7Q2V7XN3M9R6T1Y5W8ZA"]}},"required":["field","op","list_id"],"additionalProperties":false,"description":"The record's hashed email, domain, phone, company number or title term is on a suppression list. Usually nested under not; each list reports the records it removed.","examples":[{"field":"email.address_sha256","op":"in_list","list_id":"sup_01JB4H7Q2V7XN3M9R6T1Y5W8ZA"}]},"LteFilter":{"type":"object","properties":{"field":{"type":"string","enum":["company.employee_band","company.turnover_band","company.fleet_band","contact.job_level_rank","contact.company_contact_rank","email.deliverability_score"]},"op":{"type":"string","const":"lte"},"value":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"number"}],"description":"A band code or a number from the field's order."}},"required":["field","op","value"],"additionalProperties":false,"description":"The field is at or before the value in its order. Rank 1 is the most senior, so Director and above is contact.job_level_rank lte 6.","examples":[{"field":"contact.job_level_rank","op":"lte","value":6}]},"MatchesFilter":{"type":"object","properties":{"field":{"type":"string","enum":["contact.title"]},"op":{"type":"string","const":"matches"},"terms":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}},"mode":{"type":"string","enum":["contains","starts_with","exact"],"description":"contains (the default) matches titles containing a term, starts_with matches titles beginning with it, exact takes verbatim titles with no expansion."},"expand":{"description":"Expansion sets to apply, each once: plural_singular, department_synonyms, ampersand_and, abbreviations, permutations. Left out, the first four apply; an empty list applies none. Not used with mode exact.","uniqueItems":true,"maxItems":5,"type":"array","items":{"type":"string","enum":["plural_singular","department_synonyms","ampersand_and","abbreviations","permutations"]}},"exclude_terms":{"description":"Expanded terms removed by hand. Kept in the definition so the count stays reproducible when the title dictionary changes.","maxItems":500,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["field","op","terms"],"additionalProperties":false,"description":"Job title keyword match. mode contains (the default) or starts_with expands each term with the expansion sets; mode exact matches verbatim titles. Every expanded term is returned with the count.","examples":[{"field":"contact.title","op":"matches","terms":["marketing manager"],"mode":"contains","expand":["plural_singular","department_synonyms","ampersand_and","abbreviations"]}],"allOf":[{"if":{"type":"object","properties":{"mode":{"const":"exact"}},"required":["mode"]},"then":{"type":"object","properties":{"expand":{"type":"array","maxItems":0},"exclude_terms":{"type":"array","maxItems":0}}}}]},"NotGroup":{"type":"object","properties":{"not":{"$ref":"#/$defs/WhereNode"}},"required":["not"],"additionalProperties":false,"description":"Negation: the single node inside must not match."},"PlaceCentre":{"type":"object","properties":{"place":{"type":"string","minLength":1,"maxLength":100,"description":"A place name, resolved with resolve_location, such as Leeds."},"code":{"description":"The ONS geography code of the chosen candidate when resolve_location found more than one, such as E08000035 for the Leeds district.","type":"string","minLength":1,"maxLength":20}},"required":["place"],"additionalProperties":false,"description":"A named place. Ambiguous names come back from resolve_location as candidates, never a silent choice."},"PointCentre":{"type":"object","properties":{"lat":{"type":"number","minimum":49,"maximum":61},"lon":{"type":"number","minimum":-9,"maximum":2}},"required":["lat","lon"],"additionalProperties":false,"description":"A latitude and longitude in WGS84 degrees."},"PostcodeCentre":{"type":"object","properties":{"postcode":{"type":"string","pattern":"^[A-Za-z]{1,2}([0-9][0-9A-Za-z]?( [0-9]([A-Za-z]{2})?| ?[0-9][A-Za-z]{2})?)?$","description":"The centroid of a postcode unit, sector, district or area, such as LS1 4AP."}},"required":["postcode"],"additionalProperties":false,"description":"A postcode centroid from ONSPD."},"RadiusCentre":{"anyOf":[{"$ref":"#/$defs/PlaceCentre"},{"$ref":"#/$defs/PostcodeCentre"},{"$ref":"#/$defs/PointCentre"}],"description":"The centre of a radius: a place, a postcode or a latitude and longitude."},"SinceFilter":{"type":"object","properties":{"field":{"type":"string","enum":["contact.last_validated_at","email.last_verified_at","signal.type","signal.observed_at"]},"op":{"type":"string","const":"since"},"days":{"type":"integer","minimum":1,"maximum":3650},"values":{"description":"For signal.type only: the signal types to look for, such as company.incorporated.","minItems":1,"maxItems":10000,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["field","op","days"],"additionalProperties":false,"description":"Within the last N days: a date field, or a Companies House signal of the listed types on signal.type.","examples":[{"field":"signal.type","op":"since","values":["company.incorporated"],"days":90}]},"WhereNode":{"anyOf":[{"$ref":"#/$defs/AllGroup"},{"$ref":"#/$defs/AnyGroup"},{"$ref":"#/$defs/NotGroup"},{"$ref":"#/$defs/BundleNode"},{"$ref":"#/$defs/Filter"}],"description":"A group (all, any, not), a title bundle or a filter. Groups nest up to 32 deep, and a where tree holds up to 1,000 filters, groups and bundles."},"WithinRadiusFilter":{"type":"object","properties":{"field":{"type":"string","enum":["site.location"]},"op":{"type":"string","const":"within_radius"},"centre":{"$ref":"#/$defs/RadiusCentre"},"radius_miles":{"type":"number","minimum":1,"maximum":100,"description":"Radius in miles, 1 to 100. Under 5 miles needs an account."}},"required":["field","op","centre","radius_miles"],"additionalProperties":false,"description":"Sites within radius_miles of the centre. The count reports the centroid used and the postcodes matched.","examples":[{"field":"site.location","op":"within_radius","centre":{"place":"Leeds"},"radius_miles":20}]}}},"annotations":{"title":"Save an audience","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"498e7e6a140367d1427a7621912ec30f7c4b0feadad264a574eba42b00ed6927","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T11:47:07.863Z","metadataTrust":"untrusted"},{"serverName":"com.emailmovers/mydatahub","endpointFingerprint":"4095f069b618dbc15e63a1fd53768b5a184a62fcd200aa4cf68cd54c5019440e","name":"search_filter_values","title":"Search filter values","description":"Searches the values of one field by text, such as towns matching leeds, and returns each code with its contact and company counts plus did_you_mean for near misses. Use the returned code in a filter rather than guessing one. Free and needs no account; results are paged with next_cursor. Call count_audience once the filters are chosen. Lawful basis is UK GDPR Article 6(1)(f) legitimate interests; email audiences include corporate subscribers only by default (PECR), so sole traders and ordinary partnerships are left out unless the toggle is changed.","inputSchema":{"type":"object","properties":{"dimension":{"type":"string","pattern":"^(company|site|contact|email|phone|signal)\\.[a-z0-9_]+$","description":"A field name from list_filters, such as site.town or company.sic_2007."},"q":{"description":"Text to search for.","type":"string","minLength":1,"maxLength":100},"dataset":{"type":"string","enum":["uk_contacts","ie_contacts","global_contacts"],"description":"The dataset an audience draws from. uk_contacts is live; ie_contacts and global_contacts are listed but not yet served."},"limit":{"description":"Items per page, 1 to 100. Default 25.","default":25,"type":"integer","minimum":1,"maximum":100},"cursor":{"type":"string","minLength":1,"maxLength":512,"description":"An opaque cursor from next_cursor. Pass it back unchanged."}},"required":["dimension"],"additionalProperties":false},"annotations":{"title":"Search filter values","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"45b3fd52159ffbb1730c42fa066fff825a3ecf5faaa72b2d12c999e345403bde","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T11:47:07.863Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"4095f069b618dbc15e63a1fd53768b5a184a62fcd200aa4cf68cd54c5019440e","protocol":"streamable-http","status":"indexed","toolCount":22,"observedAt":"2026-11-16T11:47:07.863Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"com.emailmovers/mydatahub":{"url":"https://mydatahub.emailmovers.com/mcp"}}},"Cursor":{"mcpServers":{"com.emailmovers/mydatahub":{"url":"https://mydatahub.emailmovers.com/mcp"}}},"VS Code":{"servers":{"com.emailmovers/mydatahub":{"type":"http","url":"https://mydatahub.emailmovers.com/mcp"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://mydatahub.emailmovers.com/mcp"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:com.emailmovers%2Fmydatahub","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/com.emailmovers%2Fmydatahub","name":"com.emailmovers/mydatahub","description":"UK B2B contact counts, quotes and lists, by Emailmovers","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://mydatahub.emailmovers.com/mcp"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":"https://emailmovers.com/mydatahub/","repositoryUrl":null,"version":"2.0.0"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"com.emailmovers/mydatahub","status":"online","lastCheckedAt":"2026-11-20T08:15:35.906Z","lastSuccessfulCheck":"2026-11-20T08:15:35.906Z","latencyMs":124,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T08:15:35.906Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T08:15:35.906Z"},"security":null,"timestamps":{"createdAt":"2026-11-09T16:24:11.207Z","updatedAt":"2026-11-09T16:24:11.207Z","observedAt":"2026-11-20T08:15:35.906Z"},"compatibility":{"serverVersion":"2.0.0","protocolVersions":[{"protocol":"mcp","version":null}]}}}}