DataMerge MCP

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'apiKey': {'type': 'string', 'description': 'DataMerge API key. Get one at https://app.datamerge.ai (20 free credits).'}, 'baseUrl': {'type': 'string', 'description': 'Optional custom API base URL (default: https://api.datamerge.ai).'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['contacts', 'enrich_fields'], 'properties': {'contacts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': {}}, 'description': 'Array of contacts: either { linkedin_url } or { firstname, lastname, domain }.'}, 'enrich_fields': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Fields to enrich, e.g. ["contact.emails", "contact.phones"].'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['enrich_fields'], 'properties': {'domains': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Company domains to search.'}, 'webhook': {'type': 'string', 'description': 'Optional webhook URL to notify when the job completes.'}, 'location': {'type': 'object', 'description': 'Location filters: include/exclude with type and value (country, region, city).', 'additionalProperties': {}}, 'job_titles': {'type': 'object', 'properties': {'exclude': {'type': 'array', 'items': {'type': 'string'}}, 'include': {'type': 'object', 'description': 'Priority-keyed: {"1": ["CEO"], "2": ["VP Sales"]} â\x80\x94 priority "1" is highest.', 'additionalProperties': {'type': 'array', 'items': {'type': 'string'}}}}, 'description': 'Optional include/exclude job title filters.', 'additionalProperties': False}, 'company_list': {'type': 'string', 'description': 'List slug instead of domains.'}, 'enrich_fields': {'type': 'array', 'items': {'type': 'string'}, 'description': 'At least one of "contact.emails" or "contact.phones". Each email costs 1 credit; phone 4 credits.'}, 'max_results_per_company': {'type': 'number', 'description': 'Max contacts per company.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'domains': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Company domains to search.'}, 'webhook': {'type': 'string'}, 'location': {'type': 'object', 'additionalProperties': {}}, 'job_titles': {'type': 'object', 'properties': {'exclude': {'type': 'array', 'items': {'type': 'string'}}, 'include': {'type': 'object', 'description': 'Priority-keyed: {"1": ["CEO"], "2": ["VP"]} â\x80\x94 priority "1" is highest.', 'additionalProperties': {'type': 'array', 'items': {'type': 'string'}}}}, 'description': 'Optional include/exclude job title filters (priority-keyed include).', 'additionalProperties': False}, 'company_list': {'type': 'string', 'description': 'Alternative to domains: list slug to search across.'}, 'max_results_per_company': {'type': 'integer'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name', 'object_type'], 'properties': {'name': {'type': 'string', 'description': 'Display name for the new list.'}, 'object_type': {'enum': ['company', 'contact'], 'type': 'string', 'description': 'Whether the list holds company or contact records.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['object_type', 'list_slug'], 'properties': {'list_slug': {'type': 'string', 'description': 'List slug of the list to delete. System lists cannot be deleted.'}, 'object_type': {'enum': ['company', 'contact'], 'type': 'string', 'description': 'Type of list: company or contact.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'record_id': {'type': 'string', 'description': 'Your record UUID from a previous enrichment. Does not consume credits.'}, 'add_to_list': {'type': 'string', 'description': 'List slug to add the company to. Only valid when using datamerge_id.'}, 'datamerge_id': {'type': 'string', 'description': 'DataMerge company ID. Charges 1 credit.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['job_id'], 'properties': {'job_id': {'type': 'string', 'description': 'The enrichment job ID returned by start_company_enrichment. Poll until status is "completed" or "failed".'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['datamerge_id'], 'properties': {'page': {'type': 'integer', 'description': 'Page number for paginated results (1-based).'}, 'max_level': {'type': 'integer', 'description': 'Maximum hierarchy depth.'}, 'country_code': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Filter entities by ISO 2-letter country code(s).'}, 'datamerge_id': {'type': 'string', 'minLength': 1, 'description': 'DataMerge company ID. Required.'}, 'include_names': {'type': 'boolean', 'description': 'Include entity names. Charges 1 credit.'}, 'include_branches': {'type': 'boolean', 'description': 'Include branch entities.'}, 'only_subsidiaries': {'type': 'boolean', 'description': 'Return only subsidiaries.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['record_id'], 'properties': {'record_id': {'type': 'string', 'description': 'Contact record UUID from a previous contact_search or contact_enrich job. Does not consume credits.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['job_id'], 'properties': {'job_id': {'type': 'string', 'description': 'The contact enrich job ID returned by contact_enrich. Poll until status is "completed" or "failed".'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['job_id'], 'properties': {'job_id': {'type': 'string', 'description': 'The contact search job ID returned by contact_search. Poll until status is "completed" or "failed".'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'_': {'type': 'string', 'description': 'This tool takes no required parameters. Call with no arguments.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['object_type', 'list_slug'], 'properties': {'page': {'type': 'number', 'description': 'Page number for pagination (1-based).'}, 'sort_by': {'type': 'string', 'description': 'Field name to sort by.'}, 'list_slug': {'type': 'string', 'description': 'URL-safe list identifier (e.g. target-accounts).'}, 'page_size': {'type': 'number', 'description': 'Items per page (max 100).'}, 'sort_order': {'enum': ['asc', 'desc'], 'type': 'string', 'description': 'Sort direction: asc or desc.'}, 'object_type': {'enum': ['company', 'contact'], 'type': 'string', 'description': 'Type of list: company or contact.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'_': {'type': 'string', 'description': 'This tool takes no required parameters. Call with no arguments.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'object_type': {'enum': ['company', 'contact'], 'type': 'string', 'description': 'Filter lists by object type: company or contact.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['object_type', 'list_slug', 'item_id'], 'properties': {'item_id': {'type': 'string', 'description': 'Record UUID of the company or contact to remove from the list.'}, 'list_slug': {'type': 'string', 'description': 'List slug containing the item.'}, 'object_type': {'enum': ['company', 'contact'], 'type': 'string', 'description': 'Type of list: company or contact.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'list': {'type': 'string', 'description': 'List slug to add enriched companies to.'}, 'domain': {'type': 'string', 'description': 'Company website domain.'}, 'domains': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Batch: multiple domains in one job.'}, 'refresh': {'type': 'boolean', 'description': 'When true, bypass DataMerge dedup: always re-enrich and charge credits even if the domain is already on a list. Use for multi-tenant resellers (e.g. Faro).'}, 'webhook_url': {'type': 'string'}, 'company_name': {'type': 'string'}, 'country_code': {'type': 'string'}, 'strict_match': {'type': 'boolean'}, 'skip_if_exists': {'type': 'boolean'}, 'global_ultimate': {'type': 'boolean'}, 'max_wait_seconds': {'type': 'number', 'description': 'Server-side wait budget per call. Default 25, hard-capped to stay under 30s timeouts.'}, 'continuation_token': {'type': 'string', 'description': 'Opaque token from a prior pending response. When set, all other params are ignored.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'refresh': {'type': 'boolean', 'description': 'When true, bypass DataMerge dedup: always re-enrich every contact and charge credits, even if the same contact was enriched in the last 30 days. Use for multi-tenant resellers (e.g. Faro).'}, 'contacts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': {}}, 'description': "Array of contacts. Identify each with `linkedin_url` and/or (`firstname`+`lastname`). ALWAYS include `domain` (company website) when you know it â\x80\x94 FullEnrich's email accuracy drops sharply without a domain hint."}, 'enrich_fields': {'type': 'array', 'items': {'type': 'string'}, 'description': 'e.g. ["contact.emails","contact.phones"].'}, 'max_wait_seconds': {'type': 'number', 'description': 'Server-side wait budget per call. Default 25, hard-capped to stay under 30s timeouts.'}, 'return_any_domain': {'type': 'boolean', 'description': 'Set to true to allow enrichment for contacts that have no `domain`. FullEnrich will pick whichever current employer it considers most probable, which may not match what you expect for people with multiple plausible affiliations. Default false: server returns `status: "domain_required"` if any contact lacks `domain`.'}, 'continuation_token': {'type': 'string', 'description': 'Opaque token from a prior pending response. When set, all other params are ignored.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'list': {'type': 'string', 'description': 'Target contact list slug for results.'}, 'domains': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Company domains to search for contacts at.'}, 'refresh': {'type': 'boolean', 'description': 'When true, downstream enrichment bypasses dedup and always charges credits for each contact. Use for multi-tenant resellers (e.g. Faro).'}, 'location': {'type': 'object', 'properties': {'exclude': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'value'], 'properties': {'type': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}, 'include': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'value'], 'properties': {'type': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}}, 'description': 'Optional include/exclude location filters.', 'additionalProperties': False}, 'job_titles': {'type': 'object', 'properties': {'exclude': {'type': 'array', 'items': {'type': 'string'}}, 'include': {'type': 'object', 'additionalProperties': {'type': 'array', 'items': {'type': 'string'}}}}, 'description': 'Optional include/exclude job title filters.', 'additionalProperties': False}, 'company_list': {'type': 'string', 'description': 'Alternative to `domains`: company list slug.'}, 'enrich_fields': {'type': 'array', 'items': {'type': 'string'}, 'description': 'At least one of "contact.work_emails", "contact.emails", "contact.phones".'}, 'max_wait_seconds': {'type': 'number', 'description': 'Server-side wait budget per call. Default 25, hard-capped to stay under 30s timeouts.'}, 'continuation_token': {'type': 'string', 'description': 'Opaque token from a prior pending response. When set, all other params are ignored.'}, 'max_results_per_company': {'type': 'integer', 'description': 'Max contacts to return per company.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['domains'], 'properties': {'list': {'type': 'string', 'description': 'Target contact list slug.'}, 'domains': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Up to 10 company domains.'}, 'location': {'type': 'object', 'description': 'Optional include/exclude locations.', 'additionalProperties': {}}, 'job_titles': {'type': 'object', 'properties': {'exclude': {'type': 'array', 'items': {'type': 'string'}}, 'include': {'type': 'object', 'description': 'Priority-keyed: {"1": ["CEO"], "2": ["VP"]} â\x80\x94 priority "1" is highest. The API flattens this to a single array for the sync endpoint.', 'additionalProperties': {'type': 'array', 'items': {'type': 'string'}}}}, 'description': 'Optional include/exclude job title filters.', 'additionalProperties': False}, 'max_results_per_company': {'type': 'integer', 'description': 'Max contacts per company (1â\x80\x9310).'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'list': {'type': 'string', 'description': 'List slug to add enriched companies to.'}, 'domain': {'type': 'string', 'description': 'Company website domain (e.g. example.com).'}, 'domains': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Batch: multiple domains to enrich.'}, 'webhook_url': {'type': 'string', 'description': 'Optional webhook URL to receive job completion notifications.'}, 'company_name': {'type': 'string', 'description': 'Company name (used when domain is not available).'}, 'country_code': {'type': 'string', 'description': 'Optional ISO 2-letter country code to improve matching.'}, 'strict_match': {'type': 'boolean', 'description': 'When true, require a strict match for enrichment.'}, 'skip_if_exists': {'type': 'boolean', 'description': 'When true, skip domains that are already in the list.'}, 'global_ultimate': {'type': 'boolean', 'description': 'When true, always return the global ultimate parent.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'list': {'type': 'string', 'description': 'List slug to add enriched companies to.'}, 'domain': {'type': 'string', 'description': 'Company website domain (e.g. example.com).'}, 'domains': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Batch: multiple domains to enrich in one job.'}, 'webhook_url': {'type': 'string', 'description': 'Optional webhook URL to receive job completion notifications.'}, 'company_name': {'type': 'string', 'description': 'Company name (used when domain is not available).'}, 'country_code': {'type': 'string', 'description': 'Optional ISO 2-letter country code to improve matching.'}, 'strict_match': {'type': 'boolean', 'description': 'When true, require a strict match for enrichment.'}, 'skip_if_exists': {'type': 'boolean', 'description': 'When true, skip domains already in the list.'}, 'global_ultimate': {'type': 'boolean', 'description': 'When true, always return the global ultimate parent.'}, 'timeout_seconds': {'type': 'number', 'description': 'Maximum time to wait for completion (in seconds). Defaults to 60 seconds.'}, 'poll_interval_seconds': {'type': 'number', 'description': 'How often to poll the job status (in seconds). Defaults to 5 seconds.'}}, 'additionalProperties': False}