perquants-mcp 0.1.1

MCP connector for perquants — pay-per-call Hyperliquid derivatives data (funding, basis, HIP-3 health) over x402.

perquants-mcp

MCP connector for perquants — specialized Hyperliquid derivatives data for AI agents, pay-per-call over x402 (USDC on Base). No account, no API key — your agent pays a few cents per call from its own wallet.

Tools:

Tool	Returns	Price
get_hip3_decision(dex, asset)	Pre-trade risk gate — verdict (tradeable/caution/avoid), cost to execute, score + sub-components, funding, basis, OI-vs-cap, risk flags	~$0.05
get_hip3_preview(dex, asset)	Verdict band + one-line reason (a cheap first check)	free
get_hip3_health(dex, asset)	HIP-3 market health: oracle deviation, liquidity, OI vs cap, flags, 0–100 score	~$0.02
get_funding(coin)	Funding rate: latest, annualized, 24h/7d means, sign streaks	~$0.01
get_basis(coin)	Spot-perp premium (basis) in bps + means, streaks, churn	~$0.01

get_hip3_decision is the primary tool — call it before trading or sizing a HIP-3 builder market (tokenized stocks, commodities, forex, pre-IPO). It's the one decision-ready call no free API packages. Methodology is public: https://api.perquants.com/api/v1/methodology.

Install

uvx perquants-mcp          # run with no install
# or
pip install perquants-mcp

Configure your wallet

Paid calls are settled on Base mainnet in USDC, so the connector needs a wallet private key with a little USDC (and a few cents of ETH for nothing — x402 settlement is gasless for the buyer). Use a dedicated, low-balance wallet, never your main one.

export PERQUANTS_BUYER_KEY=0x<private key of a Base wallet funded with USDC>

Without PERQUANTS_BUYER_KEY, the tools return a clear "payment required" error.

Use in Claude Desktop / Cursor

Add to your MCP config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "perquants": {
      "command": "uvx",
      "args": ["perquants-mcp"],
      "env": { "PERQUANTS_BUYER_KEY": "0x<your Base wallet private key>" }
    }
  }
}

Then ask your agent things like "what's the funding on HYPE?" or "is the xyz:NVDA HIP-3 market healthy?" and it calls the tools (paying per call).

Use from Python

from perquants_mcp import PerquantsClient

client = PerquantsClient(buyer_key="0x...")   # omit to only read free/402 responses
print(client.get_json("/api/v1/hip3/xyz/NVDA"))

How it works

The connector is a thin client: it GETs the hosted perquants API, and on a 402 Payment Required it signs an x402 USDC payment with your wallet and retries. It holds no funds and runs locally — your key never leaves your machine.

• Service & live docs: https://api.perquants.com
• Discoverable in the x402 Bazaar (search "Hyperliquid funding").

Returns data/metrics, not financial advice.

License

MIT — see LICENSE.