Wincher MCP server: setup, pricing & agent-readiness

How to connect Wincher MCP to Claude Desktop

Add this block to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Cursor and Codex use a similar schema.

{
  "mcpServers": {
    "wincher": {
      "command": "npx",
      "args": ["-y", "<server-package-name>"],
      "env": {
        "WINCHER_API_KEY": "your-api-key-here"
      }
    }
  }
}
// Server source: https://github.com/chris-tutt/wincher-mcp-server
// Check the server's README for the exact "command" and required env vars.

Some MCP servers require an API key. Check the source page for setup: github.com/chris-tutt/wincher-mcp-server.

Does Wincher MCP cost extra?

Community (free)

The Wincher MCP server is community-built — free to run, but you still pay for your Wincher subscription.

Community MCPs are normally self-hosted from a GitHub repo. There's no extra license fee.
Your Wincher account still needs whatever plan is required to access the data the MCP server queries.
Trade-off: zero MCP cost, but no guarantee it'll keep working when Wincher changes their UI or API.

MCP cost

Free (self-hosted)

Subscription required

Yes (your tool plan)

Maintained by

Community

Wincher also publishes a REST API

Wincher publishes an API, but per-tier gating wasn't extracted automatically.

API docs

wincher.com/docs/api

Auth method

unknown

SDK languages

—

OpenAPI spec

—

Webhooks

—

Structured outputs

—

See Wincher API page

What you can do with Wincher from an AI agent

Three shapes of agent workflow. Pick the row that matches how you actually use Claude / Cursor / Codex day to day.

INDIE / SOLO

Skip the dashboard, ask Claude

"What keywords moved this week?" answered in seconds
Quick one-off questions without leaving the editor
Pipe Wincher data into your personal notes / docs without writing a script

Effort: 30 seconds — paste the config, restart Claude

AGENCY

Run client analysis at agent speed

Hand the MCP server to your team — every consultant can ask Claude about any client's Wincher account
Multi-account workflows without context-switching the Wincher UI
Reports you'd normally spend hours on, done before standup

Effort: An afternoon — set up auth per client

IN-HOUSE TEAM

Production agent workflows

Embed in your internal Codex / Cursor agents that triage Wincher data daily
Combine with other MCP servers in a multi-step agent chain
Constrain agents to read-only roles to keep production Wincher safe

Effort: Days — security review + role config

Limits and gotchas

Community MCP — not maintained by Wincher. Check the README and last-update date before depending on it.
Fallback: the REST API works for any flow the MCP server doesn't cover.
Auth flow: MCP servers usually inherit the underlying API auth method (unknown). Expect to configure that on first install.
Rate limits: MCP calls count against your underlying Wincher API quota. Burst usage from a curious agent can drain a daily allowance fast.

4/10

Agent-readiness verdict

Partial agent-fit: community MCP and documented public API exist, but no official MCP or OpenAPI spec. The lack of structured outputs and webhooks limits practical automation workflows for most agent stacks.

MCP server availablePublic API with docs

Scored 2026-05-21 by Joonas (TMB).

Wincher MCP & API FAQ

Is the Wincher MCP server official?+

No — it's a community build, not maintained by Wincher. Expect occasional drift and check the README before depending on it for production agents.

Can I use the Wincher MCP with Cursor or Codex?+

Yes — MCP is a protocol, not Claude-specific. Any MCP-capable client (Cursor, Codex, Windsurf, Zed) can use the same server config with minor path adjustments.

Does Wincher have a public API?+

Yes — public REST API at wincher.com/docs/api, auth via unknown.

Sources

Wincher official site: https://www.wincher.com
MCP server page: https://github.com/chris-tutt/wincher-mcp-server
API docs: https://www.wincher.com/docs/api

Data verified by Joonas on the dates shown. MCP server status auto-rechecked weekly.

Wincher MCP Server

What is the Wincher MCP server?

What you actually do with the Wincher MCP