{"id":"com.emailmovers/mydatahub","slug":"com-emailmovers-mydatahub","title":"MyDataHub","description":"UK B2B contact counts, quotes and lists, by Emailmovers","version":"2.0.0","publisher":{"kind":"domain","id":"emailmovers.com","label":"emailmovers.com","url":"https://emailmovers.com"},"website":"https://emailmovers.com/mydatahub/","repository":"","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":[],"published":"2026-11-09","updated":"2026-11-09","status":"online","auth":"","latency_ms":1281,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"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 b","read_only":true},{"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 int","read_only":true},{"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 f","read_only":true},{"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; e","read_only":true},{"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. Lawf","read_only":true},{"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_audi","read_only":true},{"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 accoun","read_only":true},{"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 ","read_only":true},{"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 pri","read_only":true},{"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","read_only":false},{"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 s","read_only":true},{"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 (","read_only":true},{"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 ","read_only":true},{"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 i","read_only":false},{"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","read_only":true},{"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. L","read_only":true},{"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","read_only":false},{"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","read_only":true},{"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_t","read_only":false},{"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 audie","read_only":true},{"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.","read_only":false},{"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; i","read_only":true}],"server_info":{"name":"mydatahub","title":"MyDataHub","version":"2.0.0"},"category":"ecommerce","tags":["communication","analytics","developer"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-11-09","stars":0,"badges":["new"],"sponsor":null,"page":"https://agentsindex.org/agents/com-emailmovers-mydatahub/"}