Website · Docs · Get API Key

What it does

Encrata gives your AI agent real-time email intelligence, IP intelligence, monitoring, and contact list management through these tools:

| Tool | Description | Cost | |------|-------------|------| | lookup_email | Full person enrichment — name, company, role, industry, location, education, social profiles, breach history, registered services, news mentions | 1 credit | | validate_email | Check if an email is deliverable, invalid, or disposable | Free | | check_breaches | Check if an email has been exposed in data breaches | Free | | ip_lookup | IP intelligence — geolocation, ISP/ASN, security flags (VPN, proxy, Tor), company info | Free | | list_monitors | List all email monitors | Free | | create_monitor | Create a new monitor to track email changes over time | Free | | get_monitor | Get details of a specific monitor | Free | | trigger_monitor_run | Trigger an immediate enrichment run | 1 credit/email | | list_runs | List monitoring runs for a monitor or all monitors | Free | | get_run_results | Get enrichment results and detected changes for a run | Free | | list_contact_lists | List all contact lists | Free | | create_contact_list | Create a reusable email list | Free | | get_contact_list | Get details of a specific contact list | Free | | delete_contact_list | Delete a contact list permanently | Free | | list_contact_list_emails | List all emails in a contact list | Free | | add_emails_to_list | Add emails to a contact list | Free | | remove_emails_from_list | Remove emails from a contact list | Free | | list_bulk_jobs | List async bulk enrichment jobs | Free | | get_bulk_job | Get status and download URL of a bulk job | Free | | cancel_bulk_job | Cancel a pending/in-progress bulk job | Free |

Quick Start

1. Get an API key

Sign up at encrata.com and create an API key in Settings → API Keys.

2. Install

npm install -g encrata-mcp

3. Connect to your AI tool

Pick your tool below and add the config:

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "encrata": {
      "command": "npx",
      "args": ["-y", "encrata-mcp"],
      "env": {
        "ENCRATA_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

claude mcp add encrata -- npx -y encrata-mcp

# Set your API key
export ENCRATA_API_KEY="your-api-key"

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "encrata": {
      "command": "npx",
      "args": ["-y", "encrata-mcp"],
      "env": {
        "ENCRATA_API_KEY": "your-api-key"
      }
    }
  }
}

VS Code / GitHub Copilot

Add to .vscode/mcp.json in your project root:

{
  "servers": {
    "encrata": {
      "command": "npx",
      "args": ["-y", "encrata-mcp"],
      "env": {
        "ENCRATA_API_KEY": "your-api-key"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "encrata": {
      "command": "npx",
      "args": ["-y", "encrata-mcp"],
      "env": {
        "ENCRATA_API_KEY": "your-api-key"
      }
    }
  }
}

ChatGPT

ChatGPT supports MCP servers via the ChatGPT desktop app. Go to Settings → MCP Servers → Add and configure:

• Name: Encrata
• Command: npx -y encrata-mcp
• Environment: ENCRATA_API_KEY=your-api-key

Example Prompts

Once connected, try asking your AI:

• "Look up [email protected]"
• "Is [email protected] a valid email?"
• "Check if [email protected] has been in any data breaches"
• "Find me everything about the person behind [email protected]"
• "What can you tell me about the IP 8.8.8.8?"
• "Is this IP address a VPN or proxy: 1.2.3.4"
• "Validate these emails and tell me which ones are deliverable: [email protected], [email protected], [email protected]"
• "Create a monitor called 'Sales Leads' with these emails: [email protected], [email protected]"
• "List my monitors and trigger a run on Sales Leads"
• "Show me the results from the latest run"
• "Create a contact list called 'Engineering Team'"
• "Add [email protected] and [email protected] to my Engineering Team list"
• "Remove [email protected] from the Engineering Team list"
• "Show me all emails in my Engineering Team list"
• "Delete the Engineering Team list"
• "List my bulk jobs and check the status of the latest one"

Example Output

> Look up [email protected]

Name: Venkat
Email: [email protected]
Company: Unosend
Industry: Information Technology & Services
Validity: valid
LinkedIn: https://in.linkedin.com/in/venkatofl
Twitter: https://x.com/venkatofl

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | ENCRATA_API_KEY | Yes | — | Your Encrata API key | | ENCRATA_BASE_URL | No | https://encrata.com | API base URL (for self-hosted) |

How It Works

AI Agent (Claude/ChatGPT/Cursor/...)
  ↕ stdio (MCP protocol)
Encrata MCP Server (this package)
  ↕ HTTPS (JSON-RPC 2.0)
Encrata API (encrata.com/mcp)
  ↕ parallel enrichment
10+ data sources

The MCP server runs locally on your machine as a stdio process. It bridges your AI agent to the Encrata API using the Model Context Protocol. All enrichment happens server-side — no data sources or credentials needed locally.

Pricing

• lookup_email: 1 credit per fresh lookup (cached results within 24h are free)
• validate_email: Free
• check_breaches: Free
• ip_lookup: Free
• Monitor runs: 1 credit per email in the monitor
• All other tools (list, create, delete, manage): Free

Sign up at encrata.com to get free credits.

Links

• Encrata — Email intelligence platform
• Documentation — Full MCP guide
• API Reference — REST API docs
• GitHub — Source code

License

MIT