MCP SERVER FOR AI AGENTS

Perpetuals data
for AI agents.

Give an agent live perpetual futures data for Hyperliquid (Core and HIP-3), Aster and Lighter through one Model Context Protocol endpoint. One normalized schema across venues, and every answer states how fresh the data is.

FRESHNESS IN EVERY ANSWER

meta.freshness and meta.source_age_s, so stale data is never presented as live.

ONE SCHEMA ACROSS VENUES

Funding normalized to hourly and APR, next to the raw rate and its interval.

COMPACT TABLES

Market lists as {columns, rows}, sorted and filtered server-side.

ACTIONABLE ERRORS

A code and an instruction, for example not_found with a pointer to list_instruments.

See it in action

Two real questions to an agent with the PerpMetric MCP connected. Numbers are a snapshot from 21 November 2026, 06:48 UTC; live answers change every minute.

YOU
What is going on with BTC right now?
explain_market(symbol="BTC")
AGENT
BTC is bouncing: about +2.9% in the last hour on all three venues, still around −7% over 24 hours. Open interest is rising together with price on Hyperliquid and Lighter, which usually points to new long positions. Funding is positive everywhere, highest on Lighter (10.5% APR) and lowest on Aster (1.4%).
VENUEPRICE1H24HFUNDING APROPEN INTEREST
Hyperliquid57,473+2.93%−7.02%6.31%$2.07B
Lighter57,466+2.96%−7.21%10.51%$211M
Aster57,539+2.99%−7.78%1.39%$0.9M
With a beta key, the same call adds the signals and their history: the 15-minute jump is EXTREME for BTC against its own 7-day history (robust z ≈ 9.7, 9 active signals). After 76 earlier jumps like this, the median move over the next 24 hours was −0.1%, with 46% ending higher: no reliable direction.

Every answer also carries meta.freshness per venue (all three were fresh, 11-48 s old).

YOU
Where does funding differ most between venues? Only liquid markets on all three.
find_funding_spreads(min_venues=3, min_oi_usd=5000000)
ASSETSPREAD APRHIGHESTLOWEST
LIT41.4%Lighter 10.5%Hyperliquid −30.8%
NEAR39.0%Aster 11.0%Lighter −28.0%
BNB25.4%Aster 0.0%Lighter −25.4%
HYPE18.0%Hyperliquid 11.0%Lighter −7.0%
ETH12.6%Lighter 0.0%Hyperliquid −12.6%
AGENT
LIT has the widest gap: Lighter pays +10.5% APR while Hyperliquid and Aster charge around −30%. These are gross differentials only; fees, borrowing, slippage and funding timing are not included.
Try these prompts

Connect your agent

Any client that supports remote MCP servers over Streamable HTTP works. The free tools need no key.

Claude Code CLI

claude mcp add --transport http perpmetric https://mcp.perpmetric.com/mcp

Codex CLI · IDE · desktop app

codex mcp add perpmetric --url https://mcp.perpmetric.com/mcp

Or add it to ~/.codex/config.toml (shared by the CLI, the IDE extension and the ChatGPT desktop app):

[mcp_servers.perpmetric]
url = "https://mcp.perpmetric.com/mcp"

ChatGPT Web

  1. Open Plugins at chatgpt.com/plugins, select the plus button, then Add custom MCP server.
  2. Name it PerpMetric and enter the Server URL https://mcp.perpmetric.com/mcp (including /mcp).
  3. Under authentication choose No authentication, confirm the warning and select Create as a plugin.
  4. In a chat, type @ and pick PerpMetric.
Custom MCP servers in ChatGPT depend on your plan (OpenAI currently lists Business, Enterprise/Edu and, with read access, Pro). ChatGPT cannot send an API key header, so it reaches the free tools only.

Cursor and JSON clients Config file

{
  "mcpServers": {
    "perpmetric": {
      "url": "https://mcp.perpmetric.com/mcp"
    }
  }
}

Other chat apps with custom connectors (such as Claude): add a custom connector with the endpoint URL.

Tools

Start with explain_market for one asset or find_funding_spreads for cross-venue funding; call get_status first when timing matters.

TOOLWHAT IT ANSWERSACCESS
explain_marketOne-call briefing for an asset: price, 1h/24h change, funding, open interest and basis on every venue, the funding spread and a plain reading of price vs open interest. With a key: active signals and what historically followed them.FREE
find_funding_spreadsEvery asset on two or more venues, ranked by the gap in annualized funding, with open interest and volume per leg.FREE
get_statusData freshness and coverage per venue.FREE
get_marketsScreener per venue: returns, funding (raw, hourly, APR), open interest, volume and basis, sorted and filtered server-side.FREE
compare_venuesOne asset across Hyperliquid, Aster and Lighter, with the funding spread and price dispersion.FREE
get_breadthMarket participation and regime per venue.FREE
list_instrumentsValid symbols and ids per venue.FREE
get_signalsMarkets behaving unusually versus their own recent history, one entry per market with its strongest signals and a plain reading.BETA KEY
get_price_historyPrice series with a summary, downsampled for agents (Hyperliquid and Lighter, up to 7 days).BETA KEY
get_research_outcomesDescriptive forward outcomes of completed historical events.BETA KEY
get_market_researchResearch profile of one market.BETA KEY

Premium tools: beta access

Signals, price history and research outcomes are available in a free beta on request. With a key, send it as a header to the same endpoint.

Using your key

Authorization: Bearer pm_live_...

Claude Code

claude mcp add --transport http perpmetric https://mcp.perpmetric.com/mcp \
  --header "Authorization: Bearer pm_live_..."

Codex: keep the key in an environment variable (for example PERPMETRIC_API_KEY) and reference it in ~/.codex/config.toml:

[mcp_servers.perpmetric]
url = "https://mcp.perpmetric.com/mcp"
bearer_token_env_var = "PERPMETRIC_API_KEY"

Request access Free beta

E-mail mcp@perpmetric.com with a sentence about what your agent does.

Every request is reviewed by hand. Beta keys run until 31 January 2027.

Paid plans will follow; beta keys can be moved to a paid plan without changing the key.

Interpretation
Not advice. PerpMetric data and historical outcomes are descriptive market intelligence, not forecasts, trading signals or investment advice.