# Datamerge

> Enrich companies and find B2B contacts using the DataMerge MCP server (mcp.datamerge.ai). Use when the user needs company firmographic data, validated contact emails or phone numbers, lookalike company discovery, corporate hierarchy data, or wants to manage lists of target accounts. Access to 375M+ companies globally. Requires a DataMerge API key (free credits at app.datamerge.ai).

- Skill: `dvcrn/datamerge` (Agent Skill)
- Install (CLI): `npx skillmds@latest add dvcrn/datamerge`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/datamerge/raw
- Safety review: pending (external: skill-scanner FAIL, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/datamerge

---


# 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