Metadata-Version: 2.4
Name: seedforge-verify-mcp
Version: 0.1.0
Summary: MCP server for the SeedForge Verify email verification API. Pay-per-use, no subscription.
Author-email: SeedForge <founders@seedforge.com>
License: MIT
Project-URL: Homepage, https://verify.seedforge.dev
Project-URL: Documentation, https://verify.seedforge.dev
Project-URL: Repository, https://github.com/seedforge/verify-mcp
Project-URL: Issues, https://github.com/seedforge/verify-mcp/issues
Keywords: mcp,model-context-protocol,email-verification,llm,agents,anthropic,claude
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: Name Service (DNS)
Classifier: Topic :: Communications :: Email
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp>=0.9.0
Requires-Dist: httpx>=0.25.0

# 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

```bash
pip install seedforge-verify-mcp
```

Or via npm:

```bash
npm install -g @seedforge-dev/verify-mcp
```

## Get an API key

Sign up at [verify.seedforge.dev](https://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):

```json
{
  "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`:

```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
