Client Setup

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

Quick Install

Run in your terminal (not inside Claude Code):

claude mcp add predictions \
  --transport http \
  https://askgina.ai/ai/predictions/mcp

Then restart Claude Code. Inside Claude Code, run /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"
    }
  }
}

Then restart Claude Code.

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"
    }
  }
}

Then restart Cursor or reload the window.

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"
    }
  }
}

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?”

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:

{ "command": "echo ok" }

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.

Getting Started

What You Can Do

Help

Client Setup

Server URL

Setup by Client

Quick Install

Manual Config

Quick Install

Manual Config

Option A: Settings UI

Option B: Config File

Quick Install

Verify It Works

Connection Issues?

​Server URL

​Setup by Client

​Quick Install

​Manual Config

​Quick Install

​Manual Config

​Option A: Settings UI

​Option B: Config File

​Quick Install

​Sign In (OAuth)

​Manual Sign-In

​Verify It Works

​Connection Issues?

Server URL

Setup by Client

Quick Install

Manual Config

Quick Install

Manual Config

Option A: Settings UI

Option B: Config File

Quick Install

Sign In (OAuth)

Manual Sign-In

Verify It Works

Connection Issues?