liquidiction/liquidiction-mcp

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

6 stars 3 forks 品質 76 トレンド 22MIT

MCP server for Hyperliquid HIP-4 prediction markets - query live odds, orderbooks, candles, trades, and positions from any AI agent

概要

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. This 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. After installing dependencies, configure your client with absolute paths: This uses the installed runtime and works even when the client's working directory is elsewhere. On Windows, use paths such as C:/Users/you/liquidiction-mcp/mcp-server.ts and the corresponding node_modules/tsx/dist/cli.mjs path. Restart the client after changing its configuration. For clients that launch from the repository directory, npx tsx mcp-server.ts also works. Outcome API requests use #N.

README

以下は原文 README の抜粋です。原文を見る。

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 start

This 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"
      }
    }
  }
}

This uses the installed runtime and works even when the client’s working directory is elsewhere. On Windows, use paths such as C:/Users/you/liquidiction-mcp/mcp-server.ts and the corresponding node_modules/tsx/dist/cli.mjs path. Restart the client after changing its configuration.

For Claude Code:

claude mcp add liquidiction -- node /absolute/path/liquidiction-mcp/node_modules/tsx/dist/cli.mjs /absolute/path/liquidiction-mcp/mcp-server.ts

For clients that launch from the repository directory, npx tsx mcp-server.ts also works.

Tools

Tool	Input	Result
`list_markets`	None	Active outcomes, selections, venues and prices
`get_market_detail`	`outcome_id`	Metadata, venue, selections and side prices
`get_market_summary`	None	Market overview and available settlement metadata
`get_orderbook`	`outcome_id`, optional `side`	Top bids, asks and spread
`get_prices`	None	Current outcome mid-prices
`get_candles`	`coin`, optional `interval`, optional `hours`	OHLCV history
`get_recent_trades`	`coin`	Recent public trades for the selected outcome side
`get_user_fills`	`address`, optional `limit`	Recent public HIP-4 fills for a wallet
`get_open_orders`	`address`	Public resting HIP-4 orders
`get_user_positions`	`address`	Positions, venues, selections, held shares and mark values

Outcome API requests use #N. Explicit coin inputs also accept +N, legacy @N and bare numeric aliases and normalize them to #N. Wallet balances returned as +N retain their raw coin and also expose the canonical #N identifier. Ordinary spot @N rows are not classified as outcome holdings or fills.

Cross-deployer positions

Ask your agent:

GitHub で README 全文を見る

インストール

This server does not publish a one-line install command.

Open the repository installation guide MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "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"
      }
    }
  }
}