Codex · command line · read-only
Connect WinningHunterto Codex.
Point OpenAI’s coding agent at live product, ad, and shop data without leaving the terminal.
Endpoint
One URL. Codex signs in from the CLI.
Add the remote MCP server, then log in. Codex, the desktop app, and the IDE extension share ~/.codex/config.toml.
https://app.winninghunter.com/mcpInstall
Register the server, then log in.
OAuth is the short path. If you would rather use an API key, set WH_API_KEY and use the config on the right.
1Install the Codex CLI and sign in to your OpenAI account.
2Run: codex mcp add winninghunter --url https://app.winninghunter.com/mcp
3Run: codex mcp login winninghunter and approve access to WinningHunter.
4In a Codex session, run /mcp and ask it 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