# Winnr [Health: Active]

**Category:** 💬 Communication  
**Repository:** https://github.com/winnr-app/winnr-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/winnr

## Description
Cold email infrastructure: buy domains, create SMTP mailboxes, set DNS, run warming, read mail.

## Tools
Capabilities this server exposes over MCP:

- **winnr_get_account** — Account, plan, limits, and the calling token's scope
- **winnr_get_usage** — Domains / email users / pre-warmed addresses vs limits
- **winnr_list_jobs** — Recent async jobs (status / type filters)
- **winnr_get_job** — One job's status, progress, result, error
- **winnr_wait_for_job** — Block until a job finishes, streaming progress notifications
- **winnr_list_export_formats** — Supported CSV formats
- **winnr_export_email_users** — CSV of credentials (15-minute link), 22 sequencer formats
- **winnr_list_domains** — List domains (paginated, optional status filter: complete, pending, …)
- **winnr_get_domain** — One domain with DNS status and live health
- **winnr_search_domains** — Availability + price for one name
- **winnr_search_domains_bulk** — Availability + price for up to 100 names
- **winnr_get_dns_status** — Provisioning/propagation state (MX, SPF, DKIM, DMARC)
- **winnr_get_dns_records** — Records to add for manual-DNS domains
- **winnr_check_dns_provider** — Where a domain's DNS is hosted today (≤20 per call)
- **winnr_purchase_domains** — Buy + set up domains (quote → confirm, **charges card**)
- **winnr_setup_domain** — Re-run DNS/mail provisioning, add mailboxes/redirect
- **winnr_connect_domains** — Bring your own domains (nameserver, manual DNS, or Cloudflare token)
- **winnr_check_nameservers** — Verify NS change; auto-queues provisioning
- **winnr_verify_dns** — Live-verify manual-DNS records
- **winnr_tag_domains** — Add/remove/set tags on up to 50 domains
- **winnr_delete_domain** — Delete a domain and its mailboxes (**destructive**)
- **winnr_list_email_users** — List mailboxes, filterable by domain
- **winnr_get_email_user** — One mailbox with IMAP/SMTP details
- **winnr_create_email_user** — Create one mailbox (async job)
- **winnr_bulk_create_email_users** — Create up to 100 mailboxes on one domain
- **winnr_update_email_user** — Rename or set password
- **winnr_delete_email_user** — Delete a mailbox (**destructive**)
- **winnr_list_inbox** — Messages across all mailboxes; warm-up hidden by default
- **winnr_get_message_body** — Full body by `uid` + `mailbox` (truncated at 10k chars)
- **winnr_send_email** — Send from a mailbox, with threading headers
- **winnr_refresh_inbox** — Trigger a sync
- **winnr_delete_message** — Delete one message (**destructive**)
- **winnr_list_warming** — Every warming mailbox with health/inbox rate
- **winnr_get_warming_overview** — Aggregate stats + estimated monthly cost
- **winnr_get_warming_metrics** — Daily series for one mailbox
- **winnr_enable_warming** — Enable, `emails_per_day` 1–20, `rampup_speed` (quote → confirm, **$0.60/mailbox/mo**)
- **winnr_disable_warming** — Disable and stop billing
- **winnr_pause_warming** — Temporary stop / restart
- **winnr_update_warming_settings** — emails_per_day`, `rampup_enabled`, `rampup_speed
- **winnr_browse_prewarmed** — Available aged, warmed domains
- **winnr_get_prewarmed_domain** — Per-address health for one listing
- **winnr_check_prewarmed_blocklist** — Live blocklist check (9 lists)
- **winnr_list_my_prewarmed** — Purchased pre-warmed domains
- **winnr_purchase_prewarmed** — Buy one domain, $3/address/mo (quote → confirm, **charges card**)
- **winnr_purchase_prewarmed_batch** — Buy up to 25 domains as one charge (quote → confirm, **charges card**)
- **winnr_cancel_prewarmed** — Cancel and return the domain (**destructive**)
- **winnr_list_webhooks** — Endpoints with status and health
- **winnr_get_webhook_deliveries** — Recent delivery attempts
- **winnr_create_webhook** — Create (response includes signing secret)
- **winnr_update_webhook** — Change URL/events/description/status
- **winnr_test_webhook** — Send a `test.ping
- **winnr_rotate_webhook_secret** — Rotate secret (old valid 24 h)
- **winnr_get_webhook_secret** — Read the signing secret (sensitive; hidden from read-only tokens)
- **winnr_delete_webhook** — Delete (**destructive**)

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "winnr": {
    "command": "uvx",
    "args": ["winnr-mcp"],
    "env": {
      "WINNR_API_TOKEN": ""
    }
  }
}
```

**Requires environment variables:** `WINNR_API_TOKEN` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What Winnr MCP server does

The Winnr MCP server exposes Winnr’s cold-email infrastructure API through MCP. It covers domain discovery and provisioning, DNS configuration, SMTP mailbox management, inbox inspection, message retrieval, and sending email from a mailbox. Account and usage tools show plan limits and current capacity, while export tools produce mailbox credentials in supported CSV formats.

The available domain operations include searching for one or many domains, listing and inspecting owned domains, checking DNS providers, viewing required records, verifying DNS, tagging domains, connecting externally owned domains, and deleting domains. Mailbox operations include listing, creating, updating, and deleting email users. The server also includes inbox tools for listing messages and retrieving message bodies.

## How it works

Winnr MCP server can run as a hosted remote endpoint at `https://mcp.winnr.app/mcp` or locally through `uvx winnr-mcp` over stdio. The hosted mode uses Winnr sign-in with OAuth 2.1 and PKCE. Local mode uses an API token beginning with `wnr_`.

Permission scopes separate observation from changes. The `read` scope permits inspection, `write` adds creation, updates, sending, and deletion, and `purchase` permits operations that spend money. A token’s scope determines which tools are exposed to the client. The server also marks tools with MCP annotations describing read-only, destructive, and idempotent behavior.

Many provisioning and mailbox actions are asynchronous. After starting an operation, an agent can inspect the job, list recent jobs, or wait for completion while receiving progress notifications. Purchase operations use a quote-and-confirm flow: the first call returns current pricing and a time-limited confirmation token, and the charge occurs only after confirmation.

## Setup and configuration

For hosted use, add the remote endpoint as a custom MCP connector and complete Winnr sign-in. For local use, install `uv` and configure the client to run `uvx winnr-mcp` with `WINNR_API_TOKEN` in its environment. The server validates the token against the account endpoint during startup.

Optional settings include `WINNR_API_URL` for an alternate API host, `WINNR_TIMEOUT` for request timeouts, `WINNR_READ_ONLY` to register only read tools, and `WINNR_NO_PURCHASES` to hide tools that charge the card. Command-line options can override these environment settings.

## Tools and capabilities

Winnr MCP server provides tools for:

- Account details, usage limits, asynchronous jobs, and CSV export formats.
- Domain search, bulk availability checks, purchasing, setup, connection, DNS verification, tagging, and deletion.
- Mailbox creation, bulk creation, updates, credential export, inspection, and deletion.
- Inbox listing, message-body retrieval, and sending with threading headers.
- DNS status for MX, SPF, DKIM, and DMARC, plus records for manual configuration.

It also provides read-only resources for account, usage, domains, DNS, warming, and jobs, along with parameterized playbooks for setup, health checks, reply triage, connecting an owned domain, and scaling infrastructure.

## Limitations and notes

Local execution is intended for desktop MCP clients; hosted execution also supports web and mobile clients identified by the README. The export link for mailbox credentials lasts 15 minutes, and retrieved message bodies are truncated at 10,000 characters. Bulk domain-provider checks support up to 20 domains per call, bulk domain searches support up to 100 names, and bulk mailbox creation supports up to 100 mailboxes on one domain.

Buying domains and enabling paid features can charge the account card, so purchase calls require a separate confirmation step. Deleting a domain removes its mailboxes, and deleting a mailbox is destructive. A read-only token automatically hides tools that create, send, buy, or delete resources.

_Full upstream README: https://allmcps.com/mcp/winnr/readme_