How it Works Pricing API MCP Warming FAQ Blog Log in Sign Up
Open Source MCP Server

Let AI Agents Manage
Your Email Infrastructure

Connect Claude, Cursor, or any MCP-compatible AI to Winnr. Provision domains, create mailboxes, manage warming, and send emails — all through natural language.

Open Source
Token Auth
37 Tools
Claude, Cursor, & More

Everything your AI agent needs

37 tools covering the full email infrastructure lifecycle. Search to send, all through natural language.

Domain Management

Search available domains, purchase via Dynadot, connect external domains, verify DNS records, and configure redirects. Set up entire domain portfolios programmatically.

Mailbox Provisioning

Create email accounts in bulk or one-by-one. Generate professional name/username combos. Full IMAP/SMTP credentials provisioned automatically.

Inbox Operations

Read, send, and manage emails across all your accounts. Build automated reply workflows or monitor inbox activity in real time.

Warming Control

Enable, pause, and resume email warming. Monitor health scores and inbox rates. Configure volume and ramp-up speed per mailbox.

Job Monitoring

Track async operations like bulk user creation, domain setup, and DNS verification. Get real-time status updates on long-running tasks.

Data Export

Export account data in formats compatible with every major sales tool — Smartlead, Instantly, Snov, Lemlist, and 10+ more.

Connect in 60 seconds

Add Winnr to your AI assistant with a single config file.

Claude Desktop
Cursor
Windsurf
{
  "mcpServers": {
    "winnr": {
      "command": "uvx",
      "args": ["winnr-mcp"],
      "env": {
        "WINNR_API_TOKEN": "wnr_your_token_here"
      }
    }
  }
}
{
  "mcpServers": {
    "winnr": {
      "command": "uvx",
      "args": ["winnr-mcp"],
      "env": {
        "WINNR_API_TOKEN": "wnr_your_token_here"
      }
    }
  }
}
{
  "mcpServers": {
    "winnr": {
      "command": "uvx",
      "args": ["winnr-mcp"],
      "env": {
        "WINNR_API_TOKEN": "wnr_your_token_here"
      }
    }
  }
}
What it looks like in practice:

You: Set up 5 new domains for cold outreach and create 3 mailboxes on each.

Claude: I'll search for available domains, purchase them, and create mailboxes. Let me start...

winnr_search_domains_bulk Found 5 available .xyz domains
winnr_purchase_domains Purchased 5 domains via Stripe
winnr_bulk_create_email_users Created 15 mailboxes
winnr_enable_warming Warming enabled on all 15

Done! 5 domains connected, 15 mailboxes created and warming.

37 tools, 7 categories

Every tool your AI agent needs to manage email infrastructure end-to-end.

ToolDescriptionPermission
Account
winnr_get_accountGet account details, plan, limitsread
winnr_get_usageCurrent usage vs. plan limitsread
Domains
winnr_list_domainsList all domains (paginated)read
winnr_get_domainGet domain detailsread
winnr_search_domainsCheck domain availabilityread
winnr_search_domains_bulkBulk availability check (up to 100)read
winnr_suggest_domainsGet domain suggestions for a keywordread
winnr_purchase_domainsPurchase + setup (charges Stripe card)write
winnr_setup_domainQueue domain setup (no purchase)write
winnr_connect_domainsConnect external domainswrite
winnr_delete_domainDelete a domainwrite
winnr_get_dns_statusCheck DNS propagationread
winnr_get_dns_recordsGet expected DNS recordsread
winnr_verify_dnsVerify DNS via live lookupwrite
winnr_check_nameserversVerify nameserver pointingwrite
Email Users
winnr_list_email_usersList mailboxes (filterable by domain)read
winnr_get_email_userGet mailbox detailsread
winnr_create_email_userCreate a mailboxwrite
winnr_update_email_userUpdate name/passwordwrite
winnr_delete_email_userDelete a mailboxwrite
winnr_bulk_create_email_usersCreate up to 100 mailboxes at oncewrite
Inbox
winnr_list_inboxList messages (date/mailbox filterable)read
winnr_get_message_bodyGet full email bodyread
winnr_send_emailSend an email from a mailboxwrite
winnr_refresh_inboxTrigger inbox syncwrite
winnr_delete_messageDelete a messagewrite
Warming
winnr_list_warmingList warming-enabled mailboxesread
winnr_get_warming_overviewAggregate warming statsread
winnr_get_warming_metricsDaily metrics for a mailboxread
winnr_enable_warmingEnable warming ($0.60/mailbox/mo)write
winnr_disable_warmingDisable warmingwrite
winnr_pause_warmingPause warmingwrite
winnr_resume_warmingResume warmingwrite
winnr_update_warming_settingsUpdate volume/ramp-up/reply ratewrite
Jobs
winnr_list_jobsList recent async jobsread
winnr_get_jobGet job status/progressread
Export
winnr_export_email_usersExport to CSV (15+ formats)read

Enterprise-grade security

The same security model as the REST API. Full control over what your AI agents can do.

Token-Based Auth

Every MCP request uses your Winnr API token. Tokens are scoped to your account, support IP whitelists, and can be revoked instantly from the dashboard.

Permission Gating

Create read-only tokens and write tools disappear completely. Your AI agent only sees tools it has permission to use. No accidental writes.

Rate Limiting

Same rate limits as the REST API (300-500 req/min by plan). The server tracks limits and warns your AI when requests are running low.

Frequently asked questions

What is an MCP server?

An MCP (Model Context Protocol) server is a standardized way for AI assistants like Claude and Cursor to interact with external tools. Think of it like a USB port for AI — plug in a service, and your AI assistant can use it directly. Winnr's MCP server exposes your email infrastructure as tools that AI agents can use through natural language.

Which AI tools support MCP?

Claude Desktop, Cursor, Windsurf, Cline, Claude Code, and any tool that implements the MCP standard. The ecosystem is growing rapidly — most major AI coding tools now support MCP.

Is the MCP server free?

The MCP server itself is open source and free (MIT license). You just need a Winnr account (free tier available) and an API token. Standard API rate limits apply based on your Winnr plan.

Is it safe to give AI agents access to my email infrastructure?

Yes. The MCP server uses the same API token authentication as the REST API. You can create read-only tokens (write tools won't even appear), set IP whitelists, set expiration dates, and revoke tokens at any time. All actions are rate-limited and logged.

Do I need the MCP server, or can I just use the REST API?

Both work. The MCP server is ideal if you're using AI assistants (Claude, Cursor) and want them to manage your infrastructure through natural language. The REST API is better for traditional programmatic integrations, scripts, and webhooks.

How do I get an API token?

Sign up at app.winnr.app, go to Settings, and create an API token. Tokens start with wnr_ and work with both the REST API and MCP server.

Can I use this to build an AI SDR?

Absolutely. The MCP server gives AI agents everything they need: domain search and purchase, mailbox creation, email warming, inbox access, and sending. Combine with your own lead gen and sequencing logic to build a fully autonomous AI sales development workflow.

Give your AI agents email superpowers

Set up in 60 seconds. Open source. Free to start.

Get Started Free View on GitHub

Read the full guide · API docs