Skip to main content

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): your vk_... key
  • VERIFY_BASE_URL (optional): override the API endpoint. Defaults to https://api.seedforge.dev. Use http://127.0.0.1:8766 for 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

seedforge_verify_mcp-0.1.0.tar.gz (6.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

seedforge_verify_mcp-0.1.0-py3-none-any.whl (7.2 kB view details)

Uploaded Python 3

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

Hashes for seedforge_verify_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 725adfe580605309a2207cc2fa8c19f902a85a83684c3d9f4e3d4ae862eae4b4
MD5 f8dbb11d880b950f24cb59c6cd65a608
BLAKE2b-256 70f83e5a08c7cbbb47404f81d5f3803d8a891cb5d408ffec0357f00922f2c9e7

See more details on using hashes here.

File details

Details for the file seedforge_verify_mcp-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for seedforge_verify_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 754ccce392a44cbeb52990f35a986054adb25f2dc869256e25c86a38de1f1aef
MD5 b04e271667350ea7f43c58cd67d3a1c4
BLAKE2b-256 b0b503d0017f4faf0733a9a8369be24b460ff3e2d5c26efa999e957c220ea4a7

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page