Detailed setup instructions for supported MCP clients.
Server URL
All clients use the same URL:
Perps MCP is default enabled for authenticated Gina users. No separate perps MCP feature flag is required.
Setup by Client
Claude Code
Codex
Cursor
Windsurf
OpenCode
Generic JSON
Quick Install
Run in your terminal:Then restart Claude Code. Inside Claude Code, run /mcp to see server status and trigger OAuth sign-in.Manual Config
Add to ~/.claude/settings.json or your project’s .claude/settings.json:Quick Install
Manual Config
Add to .codex/config.toml:Option A: Settings UI
- Open Cursor Settings
- Navigate to MCP
- Click Add new MCP server
- Enter:
- Name:
perps
- Type:
http
- URL:
https://askgina.ai/ai/perps/mcp
- Save and reload Cursor.
Option B: Config File
Add to .cursor/mcp.json:
- Open Windsurf Settings
- Navigate to MCP
- Click Add Server
- Enter:
- Name:
perps
- URL:
https://askgina.ai/ai/perps/mcp
- Save and restart.
For any MCP client that supports JSON config: Sign In
Restart your client
Restart your MCP client so it picks up the new server configuration.
Trigger auth
Your client will usually trigger OAuth automatically. If it does not:
- Cursor: Go to Settings -> MCP and check server status
- Claude Code: Run
/mcp inside Claude Code and select perps
- Codex: Run
codex mcp login perps
Browser sign-in
Sign in to Gina in the browser window that opens and approve access.
Verify
Back in your client, bash should now appear as an available tool.
Verify It Works
After signing in, run:
Then try a market data call:
If you see JSON price data, you’re connected.
