Integration
SimpleCold MCP server for AI assistants
Give Claude, Cursor, ChatGPT or any MCP client the tools to verify email addresses. One URL and your API key, nothing to install or host.
What it does
Six tools your assistant can call
The same checks and results as the API, as MCP tools.
verify_email
Verify one address and get the result, the reason and a typo suggestion.
verify_emails
Verify up to 50 addresses in one call, for a pasted list or a table in the chat.
start_list_verification
Start a bulk job from a CSV URL or an array of addresses.
get_list_status
Check a bulk job's progress, so the assistant knows when to come back.
get_list_results
A summary per result, plus the rows a page at a time.
get_credit_balance
Your available credits, before you start a big list.
Setup
Set it up in 3 steps
No code. Copy the URL and paste your key.
- 01
Create an API key
In the dashboard, open API keys and create one. Start with a test key (sc_test_): it runs in the sandbox and uses no credits.
- 02
Add the server
Point your client at https://simplecold.com/api/v1/mcp and send the key as Authorization: Bearer <key>. The examples below cover the common clients.
- 03
Ask in plain words
"Verify these 20 leads and tell me which ones to drop." The assistant picks the tool and explains each result.
Connect your client
Setup at a glance
Streamable HTTP with a Bearer API key. The docs have the full, copy-paste versions.
| Client | How to add SimpleCold |
|---|---|
| Claude Code | claude mcp add --transport http simplecold https://simplecold.com/api/v1/mcp --header "Authorization: Bearer <key>" |
| Cursor | mcp.json → "simplecold": { "url": "https://simplecold.com/api/v1/mcp", "headers": { "Authorization": "Bearer <key>" } } |
| Claude Desktop | Add the server through the mcp-remote bridge in claude_desktop_config.json, which sends your key as the Authorization header. The docs show the config entry. |
| ChatGPT and the OpenAI API | Use the MCP tool of OpenAI's Responses API with your key in its headers. ChatGPT's custom connectors need OAuth sign-in, which SimpleCold doesn't offer yet. |
| Other MCP clients | Any client that speaks Streamable HTTP and can send an Authorization header. |
Use another tool?
The REST API works now: single, batch and bulk endpoints with an API key. Or upload a CSV from any tool.
FAQ
MCP questions
Short answers.
Still have a question? Talk to us.
Check your list before you send it
Start with 200 free credits. Pay per credit after that.