What is Perps MCP?
What is Perps MCP?
Perps MCP is an MCP server by Gina for Hyperliquid perpetual futures. It lets MCP clients use a sandboxed
bash tool to inspect market data, manage positions, place orders, work with HIP-3 DEXes, and analyze fetched data.Which MCP clients are supported?
Which MCP clients are supported?
Any client that supports MCP over streamable HTTP:
- Claude Code via
claude mcp add - Codex via
bunx add-mcpor.codex/config.toml - Cursor via Settings -> MCP or
.cursor/mcp.json - Windsurf via Settings -> MCP
- OpenCode via
opencode mcp add - Any client supporting generic JSON MCP config
Do I need a perps MCP feature flag?
Do I need a perps MCP feature flag?
No. Perps MCP is default enabled for authenticated Gina users. You still need to sign in through MCP OAuth or provide a valid Gina MCP token.
Why does a browser window open?
Why does a browser window open?
That’s the OAuth sign-in flow. Sign in to Gina and approve access for your MCP client, then return to your client and retry
tools/list.What can I do with it?
What can I do with it?
- Fetch Hyperliquid prices, markets, candles, trades, and order books
- View account state, positions, open orders, and portfolio details
- Place, modify, and cancel perps orders
- Adjust leverage and isolated margin
- Discover HIP-3 DEXes and work with provider-scoped markets
- Move funds into or out of supported Hyperliquid/HIP-3 flows
Is it safe?
Is it safe?
The MCP tool runs inside a sandboxed workspace, but perps trading is financially risky. Start with read-only commands, check schemas before execution, and review order size, side, leverage, asset, and provider context before trading.
Where do I report issues?
Where do I report issues?
Start with Troubleshooting. If you’re still stuck, reach out on Twitter/X.