# MCP tool reference

> The 22 MCP tools of https://mydatahub.emailmovers.com/mcp in their fixed order, and the 12 deprecated tools, generated from the tools/list result.

Source: https://emailmovers.com/mydatahub/docs/reference/mcp

The server at `https://mydatahub.emailmovers.com/mcp` returns 22 tools in this fixed order, with `ttlMs` 300000 and `cacheScope` public, so host prompt caches hit. Every tool has a title, annotations, an input schema that refuses unknown members, and an output schema.

> **Not yet live.** MyDataHub v2 is built and tested locally and is not yet live. The v2 hosts open at launch, date to confirm.

Looking is free: counting, previewing and quoting cost nothing. Only `create_order` and `enrich_contact` spend credits, and a spend needs a `quote_id` plus a person's confirmation or an agent key within its limits. See [Spending safely](https://emailmovers.com/mydatahub/docs/spending-safely.md).

## Tools

| # | Tool | Title | Cost | Kind | Scope |
| ---: | --- | --- | --- | --- | --- |
| 1 | [`get_plans`](https://emailmovers.com/mydatahub/docs/reference/mcp/get_plans.md) | Plans and prices | Free | read | none |
| 2 | [`get_account`](https://emailmovers.com/mydatahub/docs/reference/mcp/get_account.md) | Account and balance | Free | read | `account:read` |
| 3 | [`list_filters`](https://emailmovers.com/mydatahub/docs/reference/mcp/list_filters.md) | Filter catalogue | Free | read | none |
| 4 | [`search_filter_values`](https://emailmovers.com/mydatahub/docs/reference/mcp/search_filter_values.md) | Search filter values | Free | read | none |
| 5 | [`expand_job_titles`](https://emailmovers.com/mydatahub/docs/reference/mcp/expand_job_titles.md) | Expand job titles | Free | read | none |
| 6 | [`resolve_location`](https://emailmovers.com/mydatahub/docs/reference/mcp/resolve_location.md) | Resolve a location | Free | read | none |
| 7 | [`compile_audience`](https://emailmovers.com/mydatahub/docs/reference/mcp/compile_audience.md) | Compile a brief | Free | read | none |
| 8 | [`count_audience`](https://emailmovers.com/mydatahub/docs/reference/mcp/count_audience.md) | Count an audience | Free | read | none |
| 9 | [`preview_records`](https://emailmovers.com/mydatahub/docs/reference/mcp/preview_records.md) | Preview sample records | Free | read | none |
| 10 | [`save_audience`](https://emailmovers.com/mydatahub/docs/reference/mcp/save_audience.md) | Save an audience | Free | write | `audiences:write` |
| 11 | [`list_audiences`](https://emailmovers.com/mydatahub/docs/reference/mcp/list_audiences.md) | List saved audiences | Free | read | `audiences:read` |
| 12 | [`list_field_sets`](https://emailmovers.com/mydatahub/docs/reference/mcp/list_field_sets.md) | List field sets | Free | read | none |
| 13 | [`quote_order`](https://emailmovers.com/mydatahub/docs/reference/mcp/quote_order.md) | Quote an order | Free | read | none |
| 14 | [`create_order`](https://emailmovers.com/mydatahub/docs/reference/mcp/create_order.md) | Create an order (spends credits) | 1 credit per record | write | `orders:write` |
| 15 | [`get_order`](https://emailmovers.com/mydatahub/docs/reference/mcp/get_order.md) | Get order status | Free | read | `orders:read` |
| 16 | [`fetch_order_records`](https://emailmovers.com/mydatahub/docs/reference/mcp/fetch_order_records.md) | Fetch order records | Free under licence | read | `records:read` |
| 17 | [`push_to_crm`](https://emailmovers.com/mydatahub/docs/reference/mcp/push_to_crm.md) | Push an order to a CRM | Free | write, open world | `pushes:write` |
| 18 | [`lookup_company`](https://emailmovers.com/mydatahub/docs/reference/mcp/lookup_company.md) | Look up a company | Free | read | none |
| 19 | [`enrich_contact`](https://emailmovers.com/mydatahub/docs/reference/mcp/enrich_contact.md) | Enrich a contact (spends credits) | 1 credit on match | write | `enrich:write` |
| 20 | [`check_suppression`](https://emailmovers.com/mydatahub/docs/reference/mcp/check_suppression.md) | Check suppression | Free | read | `suppressions:read` |
| 21 | [`report_objection`](https://emailmovers.com/mydatahub/docs/reference/mcp/report_objection.md) | Report an objection | Free | write | `suppressions:write` |
| 22 | [`get_compliance_receipt`](https://emailmovers.com/mydatahub/docs/reference/mcp/get_compliance_receipt.md) | Get a compliance receipt | Free | read | `orders:read` |

## Deprecated tools

12 of today's 13 tools are still listed after the 22 above, with "Deprecated" in their titles. The thirteenth, `preview_records`, keeps its name: the new tool replaces it in place. They stop working 12 months after the v2 launch.

| Deprecated tool | Use instead |
| --- | --- |
| [`available_selection_categories`](https://emailmovers.com/mydatahub/docs/reference/mcp/available_selection_categories.md) | `list_filters` |
| [`available_selection_values`](https://emailmovers.com/mydatahub/docs/reference/mcp/available_selection_values.md) | `search_filter_values` |
| [`search_discrete_values`](https://emailmovers.com/mydatahub/docs/reference/mcp/search_discrete_values.md) | `search_filter_values` |
| [`create_search`](https://emailmovers.com/mydatahub/docs/reference/mcp/create_search.md) | `compile_audience`, then `count_audience` |
| [`clear_search`](https://emailmovers.com/mydatahub/docs/reference/mcp/clear_search.md) | `count_audience` |
| [`get_count`](https://emailmovers.com/mydatahub/docs/reference/mcp/get_count.md) | `count_audience` |
| [`save_selections`](https://emailmovers.com/mydatahub/docs/reference/mcp/save_selections.md) | `save_audience` |
| [`get_saved_selections`](https://emailmovers.com/mydatahub/docs/reference/mcp/get_saved_selections.md) | `list_audiences` |
| [`create_data_extract`](https://emailmovers.com/mydatahub/docs/reference/mcp/create_data_extract.md) | `quote_order`, then `create_order` |
| [`get_credits`](https://emailmovers.com/mydatahub/docs/reference/mcp/get_credits.md) | `get_account` |
| [`get_packs`](https://emailmovers.com/mydatahub/docs/reference/mcp/get_packs.md) | `list_field_sets` |
| [`get_pack_details`](https://emailmovers.com/mydatahub/docs/reference/mcp/get_pack_details.md) | `list_field_sets` |
