FRESHNESS IN EVERY ANSWER
meta.freshness and meta.source_age_s, so stale data is never presented as live.
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.
meta.freshness and meta.source_age_s, so stale data is never presented as live.
Funding normalized to hourly and APR, next to the raw rate and its interval.
Market lists as {columns, rows}, sorted and filtered server-side.
A code and an instruction, for example not_found with a pointer to list_instruments.
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.
| VENUE | PRICE | 1H | 24H | FUNDING APR | OPEN INTEREST |
|---|---|---|---|---|---|
| Hyperliquid | 57,473 | +2.93% | −7.02% | 6.31% | $2.07B |
| Lighter | 57,466 | +2.96% | −7.21% | 10.51% | $211M |
| Aster | 57,539 | +2.99% | −7.78% | 1.39% | $0.9M |
Every answer also carries meta.freshness per venue (all three were fresh, 11-48 s old).
| ASSET | SPREAD APR | HIGHEST | LOWEST |
|---|---|---|---|
| LIT | 41.4% | Lighter 10.5% | Hyperliquid −30.8% |
| NEAR | 39.0% | Aster 11.0% | Lighter −28.0% |
| BNB | 25.4% | Aster 0.0% | Lighter −25.4% |
| HYPE | 18.0% | Hyperliquid 11.0% | Lighter −7.0% |
| ETH | 12.6% | Lighter 0.0% | Hyperliquid −12.6% |
Any client that supports remote MCP servers over Streamable HTTP works. The free tools need no key.
claude mcp add --transport http perpmetric https://mcp.perpmetric.com/mcp
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.com/plugins, select the plus button, then Add custom MCP server.https://mcp.perpmetric.com/mcp (including /mcp).@ and pick PerpMetric.{
"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.
Start with explain_market for one asset or find_funding_spreads for cross-venue funding; call get_status first when timing matters.
| TOOL | WHAT IT ANSWERS | ACCESS |
|---|---|---|
explain_market | One-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_spreads | Every asset on two or more venues, ranked by the gap in annualized funding, with open interest and volume per leg. | FREE |
get_status | Data freshness and coverage per venue. | FREE |
get_markets | Screener per venue: returns, funding (raw, hourly, APR), open interest, volume and basis, sorted and filtered server-side. | FREE |
compare_venues | One asset across Hyperliquid, Aster and Lighter, with the funding spread and price dispersion. | FREE |
get_breadth | Market participation and regime per venue. | FREE |
list_instruments | Valid symbols and ids per venue. | FREE |
get_signals | Markets behaving unusually versus their own recent history, one entry per market with its strongest signals and a plain reading. | BETA KEY |
get_price_history | Price series with a summary, downsampled for agents (Hyperliquid and Lighter, up to 7 days). | BETA KEY |
get_research_outcomes | Descriptive forward outcomes of completed historical events. | BETA KEY |
get_market_research | Research profile of one market. | BETA KEY |
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.
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"
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.