Docs Get API key

Codex 4 steps Read-only

Connect WinningHunterto Codex.

Ask Codex about products, ads, and shops from the terminal.

Endpoint

Two commands, then you are in.

The CLI, the desktop app, and the IDE extension share ~/.codex/config.toml. Sign in with the commands. The config is only for an API key.

https://app.winninghunter.com/mcp

Install

Add the server, then log in.

Skip the config unless you want an API key instead of signing in.

1

Install the Codex CLI and sign in to OpenAI.

2

Run codex mcp add winninghunter --url https://app.winninghunter.com/mcp

3

Run codex mcp login winninghunter and approve access.

4

In a session, run /mcp and ask Codex to list WinningHunter tools.

[mcp_servers.winninghunter] url = "https://app.winninghunter.com/mcp" [mcp_servers.winninghunter.env_http_headers] X-API-Key = "WH_API_KEY"

Scopes

What you authorize.

Read-only across the board. You can revoke access from your account at any time.

winninghunter:identity.read

Account details and workspace context.

winninghunter:research.read

Read-only access to ad, brand, TikTok Shop, and trend signals.

winninghunter:usage.read

Credits and usage visibility.

winninghunter:mcp.read

Tool discovery and tool invocation metadata.

Read-only · OAuth, or an X-API-Key header