How it Works Pricing API Tools 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

55 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 30 seconds

Hosted: paste one URL and sign in with Winnr. No install, no API key. Works with Claude on web and mobile, ChatGPT, Cursor, Windsurf and VS Code.

Claude & ChatGPT
Claude Desktop
Cursor
Windsurf
Claude Code
# Settings → Connectors → Add custom connector, then paste:
https://mcp.winnr.app/mcp

# Click Connect, sign in with Winnr, choose what it may do.
# Nothing to install. No API key. Works on claude.ai, the Claude
# mobile app, Claude Desktop and ChatGPT developer-mode connectors.
# Add MCP server
claude mcp add --scope user --transport http winnr https://mcp.winnr.app/mcp

# Optional: Install guided workflow skills
curl -sL https://raw.githubusercontent.com/winnr-app/winnr-claude-skills/main/install.sh | bash

# Then use: /winnr setup, /winnr health, /winnr export, etc.
{
  "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.

55 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_check_dns_providerDetect where a domain's DNS is hosted (before connecting)read
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_tag_domainsAdd, remove or set tags on up to 50 domainswrite
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_wait_for_jobWait for a job, streaming progressread
winnr_get_jobGet job status/progressread
Export
winnr_list_export_formatsList supported CSV formatsread
winnr_export_email_usersExport credentials to CSV (22 sequencer formats)write
Pre-warmed marketplace
winnr_browse_prewarmedBrowse aged, already-warmed domains for saleread
winnr_get_prewarmed_domainPer-address health for one listingread
winnr_check_prewarmed_blocklistLive blocklist check (9 lists)read
winnr_list_my_prewarmedPurchased pre-warmed domainsread
winnr_purchase_prewarmedBuy one domain, $3/address/mo (charges card)write
winnr_purchase_prewarmed_batchBuy up to 25 domains as one chargewrite
winnr_cancel_prewarmedCancel and return a domainwrite
Webhooks
winnr_list_webhooksList webhook endpointsread
winnr_get_webhook_deliveriesRecent delivery attemptsread
winnr_create_webhookCreate an endpoint (returns signing secret)write
winnr_update_webhookChange URL, events, statuswrite
winnr_test_webhookSend a test.pingwrite
winnr_get_webhook_secretRead the signing secretwrite
winnr_rotate_webhook_secretRotate the secret (old valid 24h)write
winnr_delete_webhookDelete an endpointwrite

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 on the web, mobile and desktop, ChatGPT, Cursor, Windsurf, VS Code with Copilot, Claude Code, Cline, and any tool that implements the MCP standard. Because Winnr hosts the server at https://mcp.winnr.app/mcp, clients that only support remote connectors — claude.ai and ChatGPT — work with nothing to install.

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?

You only need a token for the local install or the REST API. The hosted connector signs you in with your Winnr login instead. For a token, sign up at app.winnr.app and create one on the API page. Tokens start with wnr_.

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.

Want guided workflows?

Winnr Claude Code Skills add cold email expertise on top of the MCP server. Multi-step setup wizards, health scoring, diagnostic decision trees, and more.

Give your AI agents email superpowers

Set up in 30 seconds. No install. Free to start.

Get Started Free View on GitHub

Read the full guide · API docs