Wincher MCP server: community, agent-fit 5/10

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

—

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.
Rate limits: MCP calls count against your underlying Wincher API quota. Burst usage from a curious agent can drain a daily allowance fast.

5/10

Agent-readiness verdict

Minimal agent-fit without official support. Wincher has a community MCP server and public API with docs, but lacks OpenAPI specs, SDKs, and native LLM integrations that would make it reliable in agent workflows. The community MCP is helpful but doesn't replace official tooling for production agent stacks.

MCP server availablePublic API with docs

Scored 2026-06-07 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.

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.

Joonas RotkoAuthor & Founder of That Marketing Buddy

10+ years in digital marketing. I review marketing software for AI-stack fit: real pricing, MCP and API support, and how cleanly each tool drops into an AI agent workflow, cross-checked against verified data and real user feedback.

About me How I review

Wincher MCP Server

What is the Wincher MCP server?

What you can build with the Wincher MCP