# Wincher MCP by usefulapi

> Wincher MCP by usefulapi is an MCP server. Read Wincher keyword rankings, SERPs, competitors and history; add keywords, groups and notes. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/wincher/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/wincher
- **MCP Registry name:** io.usefulapi/wincher
- **Listing updated:** 2026-11-13

## About

Read Wincher keyword rankings, SERPs, competitors and history; add keywords, groups and notes.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http wincher https://wincher.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://wincher.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "wincher": {
      "url": "https://wincher.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "wincher": {
      "type": "http",
      "url": "https://wincher.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "wincher": {
      "serverUrl": "https://wincher.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "wincher": {
      "type": "http",
      "url": "https://wincher.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `wincher_get_account`: The Wincher account behind the token: id, timezone and the plan limits with current usage (websites, users, keywords, keyword lookups, map-tracking credits, history days). Check keyword usage here before adding keywords. GET /account.
- `wincher_get_user`: The Wincher user the token belongs to: id, role, state, project access and profile (name, email, language). GET /user.
- `wincher_list_search_engines`: The search engines Wincher can track (id, domain such as google.com, country, languages, default location). GET /search-engines.
- `wincher_search_locations`: Search the locations Wincher can track rankings for (code, name, country), most popular first, at most 100. Both are required by the API: an ISO country code and a free-text search (at least 3 characters). GET /locations.
- `wincher_list_projects`: List projects (folders that group websites): id, name, website_ids, user_ids, and optionally the ranking summary for a period. GET /projects.
- `wincher_list_websites`: List the websites tracked in Wincher: id, domain, display name, search engine, location, language, mobile flag, keyword/group/competitor counts, competitors and brand keywords. Optionally with the ranking summary for a period. GET /websites.
- `wincher_get_website`: One tracked website with its settings, competitors, brand keywords, counts and (for the period) ranking summary. GET /websites/{website_id}.
- `wincher_list_keywords`: List the keywords tracked for a website with groups, volume, CPC, difficulty, competition, search intents and, with include_ranking, the latest position, traffic, ranking pages, SERP features and best position in the period. Positions are tracked down to the top 30. GET /websites/{website_id}/keywords.
- `wincher_get_keyword`: One tracked keyword with its groups, volume, CPC, difficulty and (default) ranking for the period. GET /websites/{website_id}/keywords/{keyword_id}.
- `wincher_get_keyword_serps`: The most recent search result pages Wincher stored for a keyword (up to 30): date, search volume, SERP features and the ranking results (position, URL, domain, traffic). GET /websites/{website_id}/keywords/{keyword_id}/serps.
- `wincher_get_keyword_ranking_history`: Historical position (or estimated traffic) for ONE keyword as time series, optionally split per ranking page or per competitor. GET /websites/{website_id}/keyword/{keyword_id}/ranking-history.
- `wincher_get_ranking_history_bulk`: Historical positions for up to 50 keywords at once (one time series per keyword). This is a read: it uses POST only because the keyword id list goes in the body. POST /websites/{website_id}/ranking-history.
- `wincher_list_groups`: List the keyword groups of a website: id, name, keyword_ids, average difficulty, search-intent counts and optionally ranking summaries. GET /websites/{website_id}/groups.
- `wincher_get_group`: One keyword group with its keyword ids and (optionally) ranking summary for the period. GET /websites/{website_id}/groups/{group_id}.
- `wincher_list_competitors`: The competitor domains tracked for a website (id, domain, created_at). GET /websites/{website_id}/competitors.
- `wincher_list_competitor_ranking_summaries`: Ranking summaries (average position, share of voice, traffic, position distribution, volume) for the website's competitors over a period, for comparison with your own. GET /websites/{website_id}/competitors/ranking-summaries.
- `wincher_list_competitor_keyword_positions`: For each tracked keyword, the position of your site and of each competitor in the period. GET /websites/{website_id}/competitors/keyword-positions.
- `wincher_list_annotations`: The annotations (notes on the ranking graphs: automatic, alert and user-written) for a website, optionally within a period. GET /websites/{website_id}/annotations.
- `wincher_list_segments`: The saved segments (keyword filters) usable as segment_id in other tools. By default also temporary ones; only_named limits to saved ones. GET /segments.
- `wincher_add_keywords`: WRITE: start tracking up to 50 new keywords on ONE website. EACH keyword uses one keyword slot of the plan's keyword quota (see wincher_get_account), and it is tracked and updated from then on; this tool cannot remove keywords again. Each keyword may name a preferred_url (the landing page expected to rank). Invalid or already-tracked keywords are ignored by Wincher (not created). 'groups' are keyw
- `wincher_create_group`: WRITE: create a keyword group on a website, optionally containing existing keywords (ids from wincher_list_keywords). Uses no keyword quota. POST /websites/{website_id}/groups.
- `wincher_create_annotation`: WRITE: add a user annotation (a note shown on the ranking graphs, e.g. 'Launched new landing page') for a date, optionally tied to specific keywords; without keyword_ids it is a global note for the website. Visible to everyone with access to the website. Uses no keyword quota. POST /websites/{website_id}/annotations.

## FAQ

### How do I add Wincher MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http wincher https://wincher.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/wincher-mcp-by-usefulapi
