Quick Start

Get connected and run your first perps market query.

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 perps \
  --transport http \
  https://askgina.ai/ai/perps/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/perps/mcp" \
  --agent codex \
  --name perps \
  --transport http \
  -y

Open Cursor Settings -> MCP -> Add new MCP server, then paste:

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

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

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

Open Windsurf Settings -> MCP -> Add Server, then set:

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

Restart your client

After adding the server, restart your MCP client or reload the window.

Your client will trigger the OAuth flow. Sign in to Gina and approve access.

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 perps server?“

3. Run First Checks

Call bash with:

{ "command": "echo ok" }

You should see ok in the output. Then inspect the sandbox and host tools:

{ "command": "capabilities --json" }

{ "command": "host-tools --brief" }

4. Get a Perps Price

Run a live Hyperliquid price lookup:

{ "command": "host-tools getHyperliquidPrice '{\"asset\":\"BTC\"}'" }

You should see JSON output with current BTC perpetual futures price data.

Next Steps

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

​1. Add the Server

​2. Connect & Sign In

​3. Run First Checks

​4. Get a Perps Price

​Next Steps

1. Add the Server

2. Connect & Sign In

3. Run First Checks

4. Get a Perps Price

Next Steps