Detailed setup instructions for every supported MCP client.
Server URL
All clients use the same URL:
https://askgina.ai/ai/predictions/mcp
Setup by Client
Claude Code
Codex
Cursor
Windsurf
OpenCode
Generic JSON
Quick Install
Run in your terminal (not inside Claude Code):claude mcp add predictions \
--transport http \
https://askgina.ai/ai/predictions/mcp
/mcp to see the server status and trigger the OAuth sign-in flow.Manual Config
Add to ~/.claude/settings.json (or your project’s .claude/settings.json):{
"mcpServers": {
"predictions": {
"transport": "http",
"url": "https://askgina.ai/ai/predictions/mcp"
}
}
}
Quick Install
bunx add-mcp "https://askgina.ai/ai/predictions/mcp" \
--agent codex \
--name predictions \
--transport http \
-y
Manual Config
Add to .codex/config.toml:[mcp_servers.predictions]
type = "http"
url = "https://askgina.ai/ai/predictions/mcp"
Option A: Settings UI
- Open Cursor Settings (⌘ + ,)
- Navigate to MCP
- Click Add new MCP server
- Enter:
- Name:
predictions
- Type:
http
- URL:
https://askgina.ai/ai/predictions/mcp
- Click Save
Option B: Config File
Add to .cursor/mcp.json in your project (or ~/.cursor/mcp.json globally):{
"mcpServers": {
"predictions": {
"type": "http",
"url": "https://askgina.ai/ai/predictions/mcp"
}
}
}
- Open Windsurf Settings
- Navigate to MCP
- Click Add Server
- Enter:
- Name:
predictions
- URL:
https://askgina.ai/ai/predictions/mcp
- Save and restart
Quick Install
opencode mcp add predictions \
--transport http \
https://askgina.ai/ai/predictions/mcp
For any MCP client that supports JSON config:{
"mcpServers": {
"predictions": {
"transport": "http",
"url": "https://askgina.ai/ai/predictions/mcp"
}
}
}
Sign In (OAuth)
After adding the server, you need to authenticate:
Restart your client
Restart your MCP client so it picks up the new server configuration.
Trigger auth
Your client will automatically trigger the OAuth flow when it tries to connect. If it doesn’t:
- Cursor: Go to Settings → MCP and check the server status
- Claude Code: Run
/mcp inside Claude Code and select the predictions server
- Codex: Run
codex mcp login predictions
Browser sign-in
A browser window opens. Sign in to Gina and approve access.
Verify
Back in your client, bash should now appear as an available tool. Try asking your AI: “What MCP tools do you have?”
Manual Sign-In
If sign-in doesn’t trigger automatically:
Claude Code
Codex
OpenCode
Inside Claude Code, run /mcp, select predictions, and complete sign-in in your browser.
codex mcp login predictions
opencode mcp auth predictions
Verify It Works
After signing in, run:
You should see ok. Then try a market search:
{ "command": "host-tools searchPredictionMarkets '{\"query\":\"NBA\"}'" }
If you see JSON market data, you’re all set!
Connection Issues?
See Troubleshooting for common fixes. 
