Liquidiction MCP Server
Read-only HIP-4 prediction-market tools for MCP-compatible agents. The server connects directly to Hyperliquid's public API. No API keys, wallet connection or signing permissions are required.
Install
Requires Node.js 20 or newer and npm.
git clone https://github.com/Liquidiction/liquidiction-mcp.git
cd liquidiction-mcp
npm ci
npm startThis is a stdio MCP server, so npm start waits for an MCP client rather than opening a website. Mainnet is the default. Set HL_API_URL=https://api.hyperliquid-testnet.xyz only when you want testnet data.
Existing installations: run git pull --ff-only, npm ci, then restart your MCP client.
Connect a client
After installing dependencies, configure your client with absolute paths:
{
"mcpServers": {
"liquidiction": {
"command": "node",
"args": [
"/absolute/path/liquidiction-mcp/node_modules/tsx/dist/cli.mjs",
"/absolute/path/liquidiction-mcp/mcp-server.ts"
],
"env": {
"HL_API_URL": "https://api.hyperliquid.xyz"
}
}
}
}




