[01 / 08]·MCP

Model Context Protocol
for email automation

An AI-native email interface. No polling, no parsing, no wiring. Give your agent an intent — get back an OTP in under 3 seconds.

[01 / 07]·Works With

Plugs into your stack

Any MCP-compatible agent — Claude Desktop, Cursor, Windsurf, n8n, Make, and more

Claude

AI Agent

Cursor

IDE

LangChain

Framework

OpenAI

LLM

n8n

n8n

Workflow

Windsurf

IDE

LangGraph

Agents

AutoGen

MS Agents

Make

Automation

CrewAI

Multi-agent

Llama

LLM

Gemini

LLM

Claude

AI Agent

Cursor

IDE

LangChain

Framework

OpenAI

LLM

n8n

n8n

Workflow

Windsurf

IDE

LangGraph

Agents

AutoGen

MS Agents

Make

Automation

CrewAI

Multi-agent

Llama

LLM

Gemini

LLM

Claude

AI Agent

Cursor

IDE

LangChain

Framework

OpenAI

LLM

n8n

n8n

Workflow

Windsurf

IDE

LangGraph

Agents

AutoGen

MS Agents

Make

Automation

CrewAI

Multi-agent

Llama

LLM

Gemini

LLM

Grok

LLM

AutoGen

Multi-agent

Claude

Sonnet

Cursor

Composer

LangChain

Framework

OpenAI

GPT

n8n

n8n

Workflow

Windsurf

Code AI

LangGraph

Agents

Make

iPaaS

CrewAI

Multi-agent

Llama

Meta

Grok

LLM

AutoGen

Multi-agent

Claude

Sonnet

Cursor

Composer

LangChain

Framework

OpenAI

GPT

n8n

n8n

Workflow

Windsurf

Code AI

LangGraph

Agents

Make

iPaaS

CrewAI

Multi-agent

Llama

Meta

Grok

LLM

AutoGen

Multi-agent

Claude

Sonnet

Cursor

Composer

LangChain

Framework

OpenAI

GPT

n8n

n8n

Workflow

Windsurf

Code AI

LangGraph

Agents

Make

iPaaS

CrewAI

Multi-agent

Llama

Meta

Gemini

Google

Grok

xAI

AutoGen

Microsoft

Ollama

Local LLM

Vercel

Deploy

Netlify

Edge

Railway

hosting

Render

hosting

Supabase

Database

MongoDB

Database

PostgreSQL

Database

Redis

Cache

Gemini

Google

Grok

xAI

AutoGen

Microsoft

Ollama

Local LLM

Vercel

Deploy

Netlify

Edge

Railway

hosting

Render

hosting

Supabase

Database

MongoDB

Database

PostgreSQL

Database

Redis

Cache

Gemini

Google

Grok

xAI

AutoGen

Microsoft

Ollama

Local LLM

Vercel

Deploy

Netlify

Edge

Railway

hosting

Render

hosting

Supabase

Database

MongoDB

Database

PostgreSQL

Database

Redis

Cache

[02 / 08]·How it works

From intent to OTP
in a single tool call

Your AI agent calls create_and_wait_for_otp(). The MCP server holds a long-poll connection, watches for incoming email via Redis pub/sub, extracts the verification code, and returns it — no callbacks, no webhooks, no polling loops.

MCP · Neural Flow
AI AgentClaude / GPT / CustomMCP Serverfce-mcp-servernpxFCE BackendRedis pub/subSMTP IngestAny email senderOTP ReturnedStructured JSON< 200ms
idle

0+

API Calls / Day

0+

Emails / Day

0+

Developers

[04 / 08]·Why MCP

Eleven tools.
Every workflow covered.

MCP tools expose email operations as first-class primitives. No REST endpoints, no webhook glue code — just intent-driven function calls that your agent can use directly.

Agent-native signup testing

Tell Claude to register on any site and extract the OTP. No boilerplate — just intent. The agent handles the entire flow from form submission to email verification.

await claude.runTask(
  "Register on acme.com and verify email"
)

CI / CD pipeline auth

Your test suite needs a fresh inbox per run. One MCP call provisions it and waits for the verification email. No more flaky tests from race conditions.

const { otp } = await mcp.create_and_wait_for_otp({
  timeout: 30
})

Multi-agent orchestration

Nest MCP calls inside larger agent graphs (LangGraph, AutoGen). Each sub-agent gets its own isolated inbox for parallel operations.

// LangGraph node
export const verifyEmail = tool(
  mcp.extract_otp
)
MCP · Neural Flow
AI AgentClaude / GPT / CustomMCP Serverfce-mcp-servernpxFCE BackendRedis pub/subSMTP IngestAny email senderOTP ReturnedStructured JSON< 200ms
idle
[05 / 08]·Tools

Eleven tools.
Infinite workflows.

MCP tools expose email operations as first-class primitives. Each tool is designed for specific email automation tasks — from quick checks to complete signup flows.

get_latest_email

Fetch the latest message from an inbox. Returns sender, subject, body text, OTP, and verification link.

Growth+ credit

Args

inboxstring
extract_otp

Directly retrieves the latest 4–6 digit code or verification link from the most recent email.

Growth+ credit

Args

inboxstring
create_and_wait_for_otp🔥 GOLD

Generates a random inbox and holds the connection open until an OTP arrives — complete signup flow in a single tool call.

Growth+ credit

Args

domainstringoptional
timeoutnumber (10–60)optional
watch_email

Long-polling wait for new emails on an existing inbox. Use when you've already created an inbox and want to wait for the next incoming email.

Growth+10× credit

Args

inboxstring
timeoutnumber (10–60)optional
sincestringoptional
get_messages

Fetches multiple messages from an inbox with pagination support.

Growth+ credit

Args

inboxstring
limitnumber (1–100)optional
unread_onlybooleanoptional
delete_email

Deletes a specific email from an inbox.

Growth+ credit

Args

inboxstring
message_idstring
list_inboxes

Lists all inboxes owned by the API key's account.

Growth+ credit

Args

list_custom_domains

Lists all custom domains associated with the account.

Growth+ credit

Args

add_custom_domain

Adds a new custom domain to the account.

Growth+ credit

Args

domainstring
verify_custom_domain

Initiates DNS verification for a custom domain.

Growth+ credit

Args

domainstring
delete_custom_domain

Deletes a custom domain from the account.

Growth+ credit

Args

domainstring

Credit multipliers

get_latest_email
extract_otp
create_and_wait_for_otp
watch_email10×
* (other tools)
[06 / 08]·Plans
PlanMCP AccessOps / minConcurrent sessions
Free✗ Blocked
Developer✗ Blocked
Startup✗ Blocked
Growth✓ Included605
Enterprise✓ Included20010
[06 / 08]·Demo

See it in action

Watch create_and_wait_for_otp() run end-to-end. The demo simulates an AI agent calling the MCP tool, waiting for email delivery, extracting the OTP, and returning the result.

AI Agent Terminalready
Agent calls tool
Inbox provisioned
Holding connection
Email arrives
OTP extracted
Returned to agent

Press run demo to simulate the agent flow

[07 / 08]·Setup

Attach to any MCP client

Add the server to Claude Desktop, Cursor, or any MCP-compatible agent framework via npx. Takes less than 30 seconds to configure.

json
{
  "mcpServers": {
    "fce-mcp": {
      "command": "npx",
      "args": ["-y", "fce-mcp-server"],
      "env": {
        "FCE_API_KEY": "your_growth_or_enterprise_api_key"
      }
    }
  }
}

Claude Desktop

Paste the config into claude_desktop_config.json. Restart Claude.

Cursor & Windsurf

Add the npx command in the MCP Servers UI or mcp_config.json.

Kilo CLI

Add to your kilo.json under the mcp section.

Custom Agent

Use any SDK (Python mcp, JS @modelcontextprotocol/sdk) to connect.

[08 / 08]·Cloud MCP

Cloud-based AI agents? No problem.

For cloud-based AI platforms that cannot run local commands (Claude Web, Claude Desktop, Cursor), we provide hosted MCP endpoints. We support two transport protocols: Streamable HTTP (recommended) and SSE (legacy).

Base URL

https://mcp.freecustom.email
Streamable HTTPRecommended

New MCP standard, better for modern clients

SSELegacy

Legacy support for older clients

EndpointMethodTransport
/mcpPOSTStreamable HTTP
/mcpGETStreamable HTTP
/sseGETSSE
/messagesPOSTSSE
/authorizeGETOAuth
/tokenPOSTOAuth

Two Auth Methods

  • Direct API Key: Pass via Authorization header or access_token query param
  • OAuth 2.0: For clients like Claude Web — use your API key as client_id

Quick Start for Claude Web

  1. Open Claude Web (claude.ai) → Settings → Integrations → Add Custom Connector
  2. Name: FreeCustom.Email MCP
  3. URL: https://mcp.freecustom.email/sse
  4. Auth: Your FreeCustom.Email API key as OAuth Client ID