Skip to main content

​
Smoke Test

​
Prerequisites

Your MCP client is installed and running
You’ve added https://askgina.ai/ai/perps/mcp as a server
You can open a browser for OAuth sign-in

​
Run These Commands

1

Echo test

Expected: ok
2

List available commands

Expected: help text describing host-tools usage
3

Find a host tool

Expected: JSON output including getHyperliquidPrice tool details
4

Fetch a price

Expected: JSON output with live BTC perps price data

​
Common Issues

​
1. Check the Server URL

Make sure your MCP client is using this exact URL:

​
2. Sign-In Not Working

1

Trigger auth

Your client should trigger OAuth automatically. If not:
  • Claude Code: run /mcp and pick perps
  • Codex: run codex mcp login perps
  • Cursor: go to Settings -> MCP and check status
2

Complete sign-in

Sign in to Gina in the browser window that opens.
3

Retry tools/list

Return to your MCP client. bash should appear as an available tool.

​
3. Signed In But No Tools

If you signed in but no bash tool appears, remove the perps server from your client, re-add it with the URL above, restart the client, and authenticate again.

​
4. Host Tool Input Fails

Check the schema before retrying:
Most failures are malformed JSON, an asset symbol mismatch, or missing HIP-3 providerContext for provider-scoped tools.

​
5. Trading or Funding Is Not What You Intended

Stop and inspect state before continuing:
Perps MCP is default enabled for authenticated users, but financial actions still use the underlying tool confirmations and risk checks.

​
Still Stuck?

Check the FAQ or reach out on Twitter/X.