MCP server for the SeedForge Verify email verification API. Pay-per-use, no subscription.
Project description
seedforge-verify-mcp
MCP server for the SeedForge Verify email verification API. Lets LLM agents (Claude Desktop, Cursor, Continue, any MCP-compatible client) verify emails, batch verify CSV lists, and check account balance directly.
- Pay per use. No subscription. 100 free verifications per month.
- First MCP-native email verifier. Built for AI agents from day one.
- Cache hits are free. Re-verifying the same email within 14 days costs $0.
Install
pip install seedforge-verify-mcp
Or via npm:
npm install -g @seedforge-dev/verify-mcp
Get an API key
Sign up at verify.seedforge.dev and grab your key from the dashboard. No card required for the free tier.
Configure your MCP client
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"verify": {
"command": "seedforge-verify-mcp",
"env": {
"VERIFY_API_KEY": "vk_your_key_here"
}
}
}
}
Restart Claude Desktop. The five tools (verify_email, batch_verify, get_job_status, get_balance, get_verification_explanation) will appear under the hammer icon.
Cursor
Edit ~/.cursor/mcp.json:
{
"mcpServers": {
"verify": {
"command": "seedforge-verify-mcp",
"env": {
"VERIFY_API_KEY": "vk_your_key_here"
}
}
}
}
Any other MCP client
Run seedforge-verify-mcp over stdio with VERIFY_API_KEY in the environment. The server uses the standard MCP stdio transport.
Tools
| Tool | What it does | Cost |
|---|---|---|
verify_email |
Verify one email, return tier + score + signals | $0.005 (cache hit: $0) |
batch_verify |
Async batch verification, returns job_id | Charged per email as completed |
get_job_status |
Poll a batch job, get progress + download URL | Free |
get_balance |
Check credit balance | Free |
get_verification_explanation |
Human-readable rationale for a verdict | $0.005 (cache hit: $0) |
Pricing
| Top-up | Verifications | Per-email price |
|---|---|---|
| Free tier | 100 / month | $0.000 |
| $10 | 2,000 | $0.005 |
| $50 | 12,500 | $0.004 |
| $100 | 33,333 | $0.003 |
No subscription. No minimum monthly spend. Credits never expire.
Environment variables
VERIFY_API_KEY(required): yourvk_...keyVERIFY_BASE_URL(optional): override the API endpoint. Defaults tohttps://api.seedforge.dev. Usehttp://127.0.0.1:8766for local dev against a self-hosted instance.
Example agent prompts
"Verify that david@seedforge.com is deliverable, and explain why if not SAFE."
The agent will call verify_email, see the tier, and if RISKY or SKIP, follow up with get_verification_explanation to give you a readable rationale.
"I'm about to send cold email to these 100 prospects. Filter out anyone who would bounce."
The agent calls batch_verify, polls get_job_status until complete, then filters the list by tier=SAFE.
License
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file seedforge_verify_mcp-0.1.0.tar.gz.
File metadata
- Download URL: seedforge_verify_mcp-0.1.0.tar.gz
- Upload date:
- Size: 6.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
725adfe580605309a2207cc2fa8c19f902a85a83684c3d9f4e3d4ae862eae4b4
|
|
| MD5 |
f8dbb11d880b950f24cb59c6cd65a608
|
|
| BLAKE2b-256 |
70f83e5a08c7cbbb47404f81d5f3803d8a891cb5d408ffec0357f00922f2c9e7
|
File details
Details for the file seedforge_verify_mcp-0.1.0-py3-none-any.whl.
File metadata
- Download URL: seedforge_verify_mcp-0.1.0-py3-none-any.whl
- Upload date:
- Size: 7.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
754ccce392a44cbeb52990f35a986054adb25f2dc869256e25c86a38de1f1aef
|
|
| MD5 |
b04e271667350ea7f43c58cd67d3a1c4
|
|
| BLAKE2b-256 |
b0b503d0017f4faf0733a9a8369be24b460ff3e2d5c26efa999e957c220ea4a7
|