Wincher MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.23.5Updated Nov 8, 2026

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

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & Commerce

Overview

Wincher MCP by usefulapi's hosted MCP server (wincher.usefulapi.io), published by usefulapi.io; no sign-in required; Streamable HTTP; 22 tools.

No AI overview yet: these facts come from the registry entry and the server itself.

Publisher
usefulapi.io
Endpoint
wincher.usefulapi.io
Last checked

Installation

In SourceWeft

  1. Open Wincher MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fwincher/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

Wincher MCP by usefulapi

Use Wincher from Claude, Cursor, or any MCP client — websites, keyword rankings and history, SERPs, competitors and groups, plus adding keywords and annotations. Hosted, no local install: connect with your own Wincher credentials.

Live endpoint: https://wincher.usefulapi.io/mcp · Homepage: https://usefulapi.io/wincher

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://wincher.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http wincher https://wincher.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "wincher": {      "url": "https://wincher.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Wincher credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/wincher/

Tools

ToolTypeWhat it does
wincher_get_accountreadGet account and plan limits
wincher_get_userreadGet current user
wincher_list_search_enginesreadList search engines
wincher_search_locationsreadSearch tracking locations
wincher_list_projectsreadList projects
wincher_list_websitesreadList tracked websites
wincher_get_websitereadGet website
wincher_list_keywordsreadList keywords
wincher_get_keywordreadGet keyword
wincher_get_keyword_serpsreadGet keyword SERPs
wincher_get_keyword_ranking_historyreadGet keyword ranking history
wincher_get_ranking_history_bulkreadGet ranking history for several keywords
wincher_list_groupsreadList keyword groups
wincher_get_groupreadGet keyword group
wincher_list_competitorsreadList competitors
wincher_list_competitor_ranking_summariesreadCompetitor ranking summaries
wincher_list_competitor_keyword_positionsreadCompetitor keyword positions
wincher_list_annotationsreadList annotations
wincher_list_segmentsreadList segments
wincher_add_keywordswriteAdd keywords to track
wincher_create_groupwriteCreate keyword group
wincher_create_annotationwriteCreate annotation
wincher_usage_statusmetaUsage status (free-tier meter)
wincher_request_featuremetaRequest a missing feature
wincher_upgrademetaUpgrade to Pro or Pro+
wincher_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per account)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with wincher_upgrade (it returns a Stripe Checkout link). Cancel any time with wincher_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running wincher_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT © usefulapi. Not affiliated with or endorsed by Wincher.

Source: servers/wincher/README.md at commit 4046075

Tools

22

wincher_get_account

Get account and plan limits

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.

Takes no parameters.

wincher_get_user

Get current user

The Wincher user the token belongs to: id, role, state, project access and profile (name, email, language). GET /user.

Takes no parameters.

wincher_list_search_engines

List search engines

The search engines Wincher can track (id, domain such as google.com, country, languages, default location). GET /search-engines.

Takes no parameters.

wincher_search_locations

Search tracking 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.

Parameterssearchrequiredcountryrequired

wincher_list_projects

List projects

List projects (folders that group websites): id, name, website_ids, user_ids, and optionally the ranking summary for a period. GET /projects.

Parametersendlimitstartoffsetorder_byinclude_ranking

wincher_list_websites

List tracked 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.

Parametersendlimitstartoffsetorder_byinclude_rankinginclude_serp_features

wincher_get_website

Get website

One tracked website with its settings, competitors, brand keywords, counts and (for the period) ranking summary. GET /websites/{website_id}.

Parametersendstartsegment_idwebsite_idrequiredinclude_rankinginclude_serp_features

wincher_list_keywords

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.

Parametersendlimitstartoffsetorder_bysegment_idwebsite_idrequiredinclude_ranking

wincher_get_keyword

Get keyword

One tracked keyword with its groups, volume, CPC, difficulty and (default) ranking for the period. GET /websites/{website_id}/keywords/{keyword_id}.

Parametersendstartkeyword_idrequiredwebsite_idrequiredinclude_ranking

wincher_get_keyword_serps

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.

Parameterskeyword_idrequiredwebsite_idrequired

wincher_get_keyword_ranking_history

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.

Parametersendstartmetricgroup_bykeyword_idrequiredwebsite_idrequired

wincher_get_ranking_history_bulk

Get ranking history for several keywords

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.

Parametersendrequiredstartrequiredwebsite_idrequiredkeyword_idsrequired

wincher_list_groups

List keyword 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.

Parametersendlimitstartoffsetorder_bysegment_idwebsite_idrequiredinclude_rankinginclude_serp_features

wincher_get_group

Get keyword group

One keyword group with its keyword ids and (optionally) ranking summary for the period. GET /websites/{website_id}/groups/{group_id}.

Parametersendstartgroup_idrequiredsegment_idwebsite_idrequiredinclude_rankinginclude_serp_features

wincher_list_competitors

List competitors

The competitor domains tracked for a website (id, domain, created_at). GET /websites/{website_id}/competitors.

Parameterslimitoffsetorder_bywebsite_idrequired

wincher_list_competitor_ranking_summaries

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.

Parametersendstartsegment_idwebsite_idrequiredinclude_serp_features

wincher_list_competitor_keyword_positions

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.

Parametersendstartsegment_idwebsite_idrequired

wincher_list_annotations

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.

Parametersendstartwebsite_idrequired

wincher_list_segments

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.

Parametersonly_named

wincher_add_keywords

Add keywords to track

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 keyword group NAMES to put every keyword in (may be empty; use names from wincher_list_groups, an unknown name may create a new group). POST /websites/{website_id}/keywords/bulk.

Parametersgroupskeywordsrequiredwebsite_idrequired

wincher_create_group

Create keyword 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.

Parametersnamerequiredwebsite_idrequiredkeyword_ids

wincher_create_annotation

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.

Parametersdaterequiredwebsite_idrequireddescriptionrequiredkeyword_ids

Version history

20
  1. v1.23.5LatestNov 8, 2026
  2. v1.23.4Nov 7, 2026
  3. v1.22.3Nov 5, 2026
  4. v1.22.2Nov 5, 2026
  5. v1.22.1Nov 4, 2026
  6. v1.22.0Nov 3, 2026
  7. v1.21.1Nov 3, 2026
  8. v1.20.0Nov 1, 2026
  9. v1.18.0Oct 31, 2026
  10. v1.17.0Oct 31, 2026
  11. v1.16.2Oct 30, 2026
  12. v1.16.0Oct 30, 2026
  13. v1.11.0Oct 26, 2026
  14. v1.8.3Oct 25, 2026
  15. v1.8.0Oct 25, 2026
  16. v1.7.0Oct 24, 2026
  17. v1.4.0Oct 23, 2026
  18. v1.3.4Oct 22, 2026
  19. v1.3.3Oct 21, 2026
  20. v1.0.0Oct 12, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations