# primitive.dev

primitive.dev connects AI assistants to email infrastructure for sending, parsing inbound mail, and tracking webhooks over HTTP.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 8352 installs
- Author: primitivedotdev
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/primitivedotdev/primitive
- Updated: 2026-06-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/primitivedev

## What it does

This MCP server hooks into the Primitive HTTP interface at `https://primitive.run.tools`. It lets models inspect DNS records, verify custom domain ownership (including MX, SPF, DKIM, and DMARC settings), and read incoming mail. Models can parse message threads, retrieve compressed attachments, and poll for replies directly within conversations. A dedicated `sendEmailDemo` tool tests payload schemas without routing actual traffic.

It also covers webhook registration, delivery replays, and sender allowlists. Outbound messages will fail if the sender domain is unverified; running `getOutboundStatus` first confirms which addresses can actually send. Domain-specific inbound filter rules require a Pro plan subscription.

## Requirements
- Remote server: `https://primitive.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http primitive https://primitive.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add primitivedev --url https://primitive.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "primitivedev": {
            "url": "https://primitive.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "primitivedev": {
            "type": "http",
            "url": "https://primitive.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http primitivedev https://primitive.run.tools
```

## When to use it
- Receive and parse inbound messages within agent workflows
- Verify DNS records for custom email routing
- Send threaded emails and await incoming replies
- Download message attachments packed as base64 archives

## Example prompts
- Check inbox status and list verified domains
- Retrieve the full conversation thread for the latest incoming email
- Send a simulated message using sendEmailDemo

## Similar
- [Forward Email](https://affpapa.org/en/nevibecode/mcp/forward-email.md) — MCP server · ★ 2 repo stars
- [email-deliverability-engineer](https://affpapa.org/en/nevibecode/agents/email-deliverability-engineer.md) — subagent · ★ 26718 repo stars
- [e2a — email for AI agents](https://affpapa.org/en/nevibecode/mcp/e2a-email-for-ai-agents.md) — MCP server · ★ 200 repo stars
- [mailx-tools](https://affpapa.org/en/nevibecode/mcp/mailx-tools.md) — MCP server · 1340 installs
- [Fluxmail](https://affpapa.org/en/nevibecode/mcp/fluxmail.md) — MCP server · ★ 9 repo stars
- [email-smtp-send](https://affpapa.org/en/nevibecode/skills/email-smtp-send.md) — skill · 6800 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
