Quick Start

Get connected and run your first prediction market query in under 2 minutes.

1. Add the Server

Pick your client and run the install command:

Claude Code
Codex
Cursor
Windsurf

Run in your terminal (not inside Claude Code):

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

Then restart Claude Code. Run /mcp inside Claude Code to check the server status and trigger sign-in.

bunx add-mcp "https://askgina.ai/ai/predictions/mcp" \
  --agent codex \
  --name predictions \
  --transport http \
  -y

Open Cursor Settings → MCP → Add new MCP server, then paste:

Name: predictions
Type: http
URL: https://askgina.ai/ai/predictions/mcp

Or add it to your .cursor/mcp.json:

{
  "mcpServers": {
    "predictions": {
      "type": "http",
      "url": "https://askgina.ai/ai/predictions/mcp"
    }
  }
}

Open Windsurf Settings → MCP → Add Server, then set:

Name: predictions
URL: https://askgina.ai/ai/predictions/mcp

Restart your client

After adding the server, restart your MCP client (or reload the window in Cursor).

Your client will trigger the OAuth flow — a browser window opens. Sign in to Gina and approve access.

In Claude Code, run /mcp to see server status and trigger auth. In Cursor, go to Settings → MCP to check the connection.

Verify

Once authenticated, bash will appear alongside your client’s built-in tools. Try asking your AI assistant: “What tools do you have from the predictions server?“

3. Run Your First Command

Call bash with:

{ "command": "echo ok" }

You should see ok in the output. You’re connected! 🎉

4. Search a Market

Now try a real prediction market search:

{ "command": "host-tools searchPredictionMarkets '{\"query\":\"NBA\"}'" }

You should see JSON output with live market data.

Troubleshooting

No browser window opens

Some clients show a sign-in link instead of opening a browser automatically. Look in your client UI for an auth link, or see Client Setup for manual sign-in commands.

Signed in but no tools appear

Remove the server from your client, re-add it, and run tools/list again.

Command fails

Start with a simple command (echo ok) first. If that works, try:

{ "command": "commands --help host-tools" }

Next Steps

What You Can Do — full features with example prompts
Client Setup — detailed config for every client
Troubleshooting — smoke test and common fixes

Getting Started

What You Can Do

Help

Quick Start

1. Add the Server

3. Run Your First Command

4. Search a Market

Troubleshooting

Next Steps

Getting Started

What You Can Do

Help

​1. Add the Server

​2. Connect & Sign In

​3. Run Your First Command

​4. Search a Market

​Troubleshooting

​Next Steps

1. Add the Server

2. Connect & Sign In

3. Run Your First Command

4. Search a Market

Troubleshooting

Next Steps