Connect WinningHunter to AI tools

WinningHunter has one MCP endpoint:

https://app.winninghunter.com/mcp

If you run your own install, use your own domain with /mcp at the end.

This page is intentionally simple: where to click, what to paste, and how to verify it works.

Before you start#

You need:

1. MCP URL (https://app.winninghunter.com/mcp)
2. One auth method:
   • OAuth (recommended for connector UIs like Claude custom connector)
   • API key header (X-API-Key: wh_...) for header-capable clients (Cursor, n8n, Desktop JSON)

OAuth discovery metadata is available at:

• https://app.winninghunter.com/.well-known/oauth-authorization-server/mcp
• https://app.winninghunter.com/.well-known/oauth-authorization-server

Claude (custom connector)#

1. Open: https://claude.ai/settings/connectors?modal=add-custom-connector
2. Click Add custom connector.
3. Enter any name (for example WinningHunter).
4. Paste MCP URL: https://app.winninghunter.com/mcp
5. Click Connect.
6. Claude will start OAuth login and ask you to sign in to WinningHunter.
7. Approve access, then return to Claude.

For local/Desktop JSON setup, use:

{
  "mcpServers": {
    "winninghunter": {
      "url": "https://app.winninghunter.com/mcp",
      "headers": {
        "X-API-Key": "wh_paste_your_api_key_here"
      }
    }
  }
}

Done check: open a new chat and ask Claude to list available tools. You should see WinningHunter tools.

Cursor (3 steps)#

1. Open Cursor settings for MCP (or create .cursor/mcp.json in your project).
2. Paste the same JSON as above.
3. Save, then reload MCP (or restart Cursor).

{
  "mcpServers": {
    "winninghunter": {
      "url": "https://app.winninghunter.com/mcp",
      "headers": {
        "X-API-Key": "wh_paste_your_api_key_here"
      }
    }
  }
}

Done check: ask Cursor to call or list WinningHunter MCP tools.

Cursor can continue using API-key headers. OAuth is optional there.

ChatGPT (OpenAI)#

If your workspace has Apps + MCP enabled, do this:

1. Open ChatGPT Settings.
2. Go to Apps -> Advanced settings.
3. Turn on Developer mode.
4. Click Create an app.
5. Set any app name (for example WinningHunter).
6. Set MCP server URL to https://app.winninghunter.com/mcp.
7. Click Create (or Connect, depending on UI).

If ChatGPT supports OAuth for your connector flow, use OAuth. If your screen supports custom headers instead, you can still use Chave X-API.

OpenAI MCP docs: MCP for ChatGPT Apps

Gemini (Google)#

If your Gemini account supports MCP connectors:

1. Add an MCP server.
2. Use URL https://app.winninghunter.com/mcp.
3. Prefer OAuth when Gemini requests it. If header auth is available in your client, Chave X-API is also supported.

Gemini MCP docs: MCP servers with Gemini CLI

n8n#

Use the MCP Client node (or MCP Client Tool node):

1. Add MCP node in your workflow.
2. Set server URL to https://app.winninghunter.com/mcp.
3. Add header auth: Chave X-API = your wh_... key.

n8n docs: MCP Client

What you get#

You can query:

• TikTok Shop products, shops, creators, videos, categories, trending
• Meta ad library search
• Brand tracker list
• Shopify store search
• Exploding Topics search + detail
• Credit balance checks

All MCP tools are read-only.

If you need to save favorites, presets, transcripts, or other writes, use the REST API (/api/v1/tiktok-shop/*).

Credits and limits (simple version)#

• ferramentas/chamada success = 1 API credit
• ferramentas/lista and connection checks do não charge
• Missing/invalid auth gives 401
• No API access on account gives 403

Full details: Credits & billing, Rate limits, Troubleshooting

Next page#

Need exact tool names and arguments? Open:

MCP tools reference