DataMerge

Connect to the DataMerge MCP server at https://mcp.datamerge.ai.

Auth

Call configure_datamerge with the user's API key before using any other tool. New users get 20 free credits at https://app.datamerge.ai.

Credits

• 1 credit: company enrichment, validated email
• 4 credits: mobile phone number
• record_id retrieval (get_company, get_contact): free — always use this to re-fetch

Core workflows

Enrich a company

Use start_company_enrichment_and_wait for single domains — it polls automatically and returns when complete. Use start_company_enrichment + get_company_enrichment_result for batch jobs.

Find contacts

1. contact_search with target domains and enrich_fields: ["contact.emails"]
2. Poll get_contact_search_status until completed
3. get_contact with each record_id to retrieve details (free)

Use job_titles to filter by seniority. Start with emails only — add "contact.phones" only if mobile numbers are explicitly needed (4× the cost).

Find lookalike companies

1. start_lookalike with companiesFilters.lookalikeDomains (seed domains)
2. Poll get_lookalike_status until completed
3. get_company with each record_id (free)

Company hierarchy

Enrich the company first to get a datamerge_id, then call get_company_hierarchy. Set include_names: true to get entity names (costs 1 credit).

Lists

• create_list to save a group of companies or contacts
• Pass list slug to enrichment/search jobs to add results automatically
• get_list_items to retrieve saved records
• Use skip_if_exists: true to avoid re-enriching duplicates

Tips

• Check get_credits_balance before running large batch jobs
• global_ultimate: true returns the top-level parent company instead of the subsidiary
• strict_match: true requires an exact domain match — use when precision matters over coverage