> ## Documentation Index
> Fetch the complete documentation index at: https://docs.askgina.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ

> Find answers on what Predictions MCP is, which MCP clients work with it, why a sign-in window opens and whether you need a token.

> [accordion] What is Predictions MCP?
>
> Predictions MCP is an MCP server by Gina that lets you search, analyze, and trade on prediction markets (Polymarket) directly from any MCP-compatible client like Cursor, Claude Code, Codex, or Windsurf.

> [accordion] Which MCP clients are supported?
>
> Any client that supports MCP over streamable HTTP: - **Claude Code** — via `claude mcp add` -
> **Codex** — via native `codex mcp add` and OAuth - **Cursor** — via Settings → MCP or
> `.cursor/mcp.json` - **Windsurf** — via Settings → MCP - **OpenCode** — via `opencode mcp add` -
> Any client supporting the generic JSON MCP config format

> [accordion] Why does a browser window open?
>
> That's the OAuth sign-in flow. You need to sign in to Gina and approve access for your MCP client.
> This only happens once per session. After signing in, return to your client and retry
> `tools/list`.

> [accordion] Do I need to copy-paste a token?
>
> No. Authentication happens automatically through OAuth in your browser. Your MCP client handles
> the token exchange.

> [accordion] What can I do with it?
>
> * Search prediction markets (sports, politics, crypto, entertainment) - Get trending/popular
>   markets - View market details, odds, and volume - Execute trades on Polymarket - Track your open
>   positions and P\&L

> [accordion] Is it safe?
>
> Yes. The `bash` tool runs in a sandboxed workspace: - Read-only commands (search, list, trending)
> have no side effects - Trading actions require explicit confirmation for large orders - You can
> start with read-only operations and only opt into trading when ready

> [accordion] Is it free?
>
> Every user gets a quota of free AI credits to start experimenting. Once you get to advanced usage,
> you can use the crypto in your Gina wallet to top up credits.

> [accordion] Where do I report issues?
>
> Start with [Troubleshooting](https://docs.askgina.ai/predictions-mcp/troubleshooting.md). If you're still stuck, reach out on [Twitter/X](https://x.com/askginadotai).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.