# Winnr

Hooks Winnr's cold-email stack into your agent: buy domains, spin up mailboxes, set DNS, run warming and read replies from plain prompts.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: winnr-app
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/winnr-app/winnr-mcp
- Updated: 2026-10-19
- HTML: https://affpapa.org/en/nevibecode/mcp/winnr

## What it does

Winnr is an MCP server for the Winnr cold-email infrastructure API. Your assistant handles domains and SMTP mailboxes, writes DNS records, kicks off warming, triages the inbox and browses the pre-warmed marketplace. It ships 55 tools, 26 of them read-only, along with 8 resources and 5 prompt playbooks.

Two ways in. The hosted endpoint `https://mcp.winnr.app/mcp` signs you in through Winnr with OAuth 2.1 and PKCE, and needs no local install. The local route runs `uvx winnr-mcp` over stdio, which means `uv` on the machine and an API token in the config file. Tokens begin with `wnr_`. A read-only token hides every tool that creates, sends or deletes; `WINNR_NO_PURCHASES` keeps write access while dropping the four tools that bill the card.

Money never moves in one call. Domain purchases, pre-warmed purchases and enabling warming first return a live quote with exact prices and a `confirmation_token` good for 10 minutes, and the order only goes through after you say yes. The quote is recalculated at that point. On startup the server hits `GET /v1/account`; a bad token kills it right there, which beats a process that stays up and fails every call.

## Requirements
- Remote server: `https://mcp.winnr.app/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http winnr https://mcp.winnr.app/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add winnr --url https://mcp.winnr.app/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "winnr": {
            "url": "https://mcp.winnr.app/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "winnr": {
            "type": "http",
            "url": "https://mcp.winnr.app/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http winnr https://mcp.winnr.app/mcp
```

## When to use it
- buy a sending domain without leaving the chat
- create SMTP mailboxes and publish DNS records
- start warming and track its progress
- sort incoming replies into buckets
- check how much account capacity is left

## Example prompts
- What's in my Winnr account and how much capacity do I have left?
- Buy a domain for this project and show me the quote first
- Create mailboxes on the new domain and turn on warming

## Similar
- [Forward Email](https://affpapa.org/en/nevibecode/mcp/forward-email.md) — MCP server · ★ 2
- [email-deliverability-engineer](https://affpapa.org/en/nevibecode/agents/email-deliverability-engineer.md) — subagent · ★ 26093
- [deal-sourcing](https://affpapa.org/en/nevibecode/skills/deal-sourcing.md) — skill · 986 installs
- [predictable-revenue](https://affpapa.org/en/nevibecode/skills/predictable-revenue.md) — skill · 5300 installs
- [ai-cold-outreach](https://affpapa.org/en/nevibecode/skills/ai-cold-outreach.md) — skill · ★ 84
- [sales-outbound-sequence](https://affpapa.org/en/nevibecode/skills/sales-outbound-sequence.md) — skill · 25900 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