> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enrichley.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Enrichley MCP Server

> Use Enrichley email validation directly inside Claude, Cursor, and other AI assistants.

The Enrichley MCP server lets your AI assistant validate emails and check your account status without leaving the conversation. Connect once, then ask your assistant to validate a list of emails or check your remaining credits in plain language.

<Note>
  The Enrichley MCP server is in public beta. Setup steps and the server URL may change as we add features.
</Note>

<CardGroup cols={2}>
  <Card title="Setup Guide" icon="gear" href="/mcp/setup">
    Connect Enrichley MCP to Claude Code, Cursor, VS Code, or Codex in a couple of minutes.
  </Card>

  <Card title="Tools Reference" icon="wrench" href="/mcp/tools">
    The two tools, what they cost, and example agent prompts.
  </Card>

  <Card title="Authentication" icon="key" href="/mcp/authentication">
    How OAuth sign-in and account authorization work, plus security best practices.
  </Card>

  <Card title="Troubleshooting" icon="circle-question" href="/mcp/troubleshooting">
    Common issues and how to fix them.
  </Card>
</CardGroup>

## What you can do

Once connected, ask your AI assistant things like:

* *"Validate these emails: [john@acme.com](mailto:john@acme.com), [jane@stripe.com](mailto:jane@stripe.com), [bob@notion.so](mailto:bob@notion.so)"*
* *"Check my Enrichley credit balance."*
* *"Is [jane.doe@example.com](mailto:jane.doe@example.com) a valid email I can send to?"*

Your assistant calls the Enrichley API on your behalf, returns the validation result, and tells you how many credits you have left.

## Supported clients

The Enrichley MCP server works with any client that supports remote MCP servers over Streamable HTTP and OAuth.

| Client      | Status    |
| ----------- | --------- |
| Claude Code | Supported |
| Cursor      | Supported |
| VS Code     | Supported |
| Codex CLI   | Supported |

## How it works

<Steps>
  <Step title="Add the Enrichley MCP server to your AI client.">
    Use the install command for your client (see [Setup](/mcp/setup)).
  </Step>

  <Step title="Sign in and authorize once.">
    Your browser opens. Sign in to your Enrichley account and authorize the requested scopes. Your API key stays server-side — your AI client never sees it.
  </Step>

  <Step title="Start asking your assistant to validate emails.">
    Subsequent requests reuse the same authorization. You only do this once per client.
  </Step>
</Steps>

## MCP endpoint

```text theme={null}
https://mcp.enrichley.io/mcp
```

<Card title="Get started" icon="arrow-right" href="/mcp/setup">
  Connect Enrichley MCP to your AI assistant.
</Card>