encrata-mcp

List all contact lists. Contact lists are reusable collections of emails that can be used as monitor data sources.

Create a new contact list. Optionally add initial emails. Lists can be used as data sources for monitors.

Get details of a specific contact list by ID, including name and email count.

Delete a contact list permanently. This cannot be undone.

List all email addresses in a specific contact list.

Add email addresses to an existing contact list.

Remove email addresses from a contact list.

Look up detailed intelligence about a person by their email address. Returns name, company, job role, industry, location, education, social profiles, breach history, registered services, news mentions, and email validity.

Validate an email address and return the full validity report (status, reason, confidence, role, disposable, provider, mx, domain_trust including DKIM/BIMI/DNSSEC, person_signal, smtp, canonical, free_provider, domain_info, mail_servers, footprint). Costs 1 credit per fresh lookup; repeats within the charge window are free.

Check if an email address has been exposed in known data breaches. Returns the number of breaches, affected services, and types of exposed data.

List all email monitors. Returns monitor names, status, frequency, email count, and last/next run times.

Create a new email monitor to track changes in person data over time. Provide a name and list of emails to monitor. When a person changes jobs, gets a new title, or appears in a breach — you

Get details of a specific monitor by ID, including its configuration, email count, and run schedule.

Trigger an immediate enrichment run for a monitor. Returns the run ID to track progress.

List monitoring runs for a specific monitor or all monitors. Shows run status, changes detected, and credits used.

Get enrichment results for a specific monitoring run. Returns person data snapshots and detected changes.

List the workspaces the authenticated account belongs to.

Create a new workspace. The slug is auto-generated when omitted.

Set the active workspace for subsequent calls.

Update the current workspace (admin only). Name is required; the slug regenerates if omitted. Pass workspace_id to target a specific workspace instead of the active one.

Permanently delete the CURRENT active workspace and all of its data (admin only). Switch first to be sure you are on the right one.

List members of the current workspace.

Invite an email to the current workspace with a role (admin, tech, or readonly).

Change a member

Remove a member from the current workspace.

List configured webhook endpoints for the current workspace.

Update a webhook. Only the fields you pass change; the rest keep their current values.

Delete a webhook endpoint. This stops all deliveries.

Send a test event to a webhook and report the real HTTP result from the endpoint.

Show recent delivery attempts for a webhook (event, status, HTTP code, attempts, time).

List recent async bulk enrichment jobs. Bulk jobs process >1,000 emails in the background. Returns job status, progress, and email counts.

Get detailed status of a specific bulk enrichment job, including progress, credits used, and download URL if completed.

Cancel a pending or in-progress bulk enrichment job. Already-processed emails are kept.

Create an async bulk email validity job from an inline email array. Credit use follows server-side billing rules (up to 1 credit per processed email). Poll get_email_job_status and get_email_job_results for progress.

Create an async bulk email identity job from an inline email array. Credit use follows server-side billing rules (up to 1 credit per processed email). Poll get_email_job_status and get_email_job_results for progress.

Create an async bulk password breach job. Provide SHA-1 hashes (preferred) and/or raw passwords (hashed server-side by API). Credit use follows server-side billing rules. Poll get_email_job_status and get_email_job_results for progress.

Get status and counters for a bulk email job. Free. Use this to poll async progress until completed/failed/cancelled.

Get paginated results for a bulk email job. Free. Call repeatedly using page/page_size until all pages are consumed.

Download a bulk email job as CSV text. Free. For very large outputs, this may be truncated in MCP response payloads.

Cancel a validity/identity/password bulk email job. Already-processed rows are kept.

Retry dead-lettered chunks for a validity/identity/password bulk email job.

List the workspace

Create a new API key. The full key is returned ONCE — store it immediately; it cannot be retrieved again.

Rename an API key.

Enable or disable an API key without deleting it.

Disable an API key, or permanently delete it with permanent=true.

Set an API key

Show the authenticated Encrata account: email, plan, remaining credits, role, and active workspace.

Return the remaining credit balance for the authenticated account and active workspace. Free.

List recent credit ledger entries (charges and top-ups) for the account. Free, read-only.