KerbTape
  1. Docs
  2. Help

Data API, MCP and AI agents

KerbTape's public data for apps and AI assistants: the JSON API, the OpenAPI spec and the read-only MCP server, with setup steps.

On this page

KerbTape's board data is public and free: last official closes, Hyperliquid prices, the gap between them, reopen times, the Monday scorecard and IPO boards. Apps can read it as JSON, and AI assistants can read it through a read-only MCP server. Both carry the same numbers as the pages, with their source and time.

Setting up an assistant? Use KerbTape from your AI assistant has the steps for Claude, ChatGPT, Cursor, VS Code and Claude Code, with copy buttons, one-click install links and live example answers.

MCP server for AI assistants#

The MCP server lives at https://kerbtape.com/mcp (Streamable HTTP, no key, no sign-in). It only reads public data: it has no tool that places or changes an order, touches a wallet or an account, or posts anything. Each answer says where its numbers come from, when they were taken, whether a close is an estimate, and that it is data, not advice. Pre-IPO markets come back as data only, flagged, without a trade link.

ToolArgumentsWhat it returns
search_marketsquery, limit?Find Hyperliquid markets (HIP-3 stocks, indices, commodities, pre-IPO, and crypto) by name, ticker or alias. Returns coin ids (for example xyz:NVDA) to pass to the other tools.
get_marketcoinOne Hyperliquid market now: price, last official close, gap vs that close, when real pricing resumes, funding, open interest, price band. Pre-IPO markets come back flagged, without a close.
get_last_closecoinThe last official close KerbTape uses for a market: price, time, venue and how it was captured (oracle at the close minute, or estimated from Hyperliquid trades).
get_weekend_gapsgroup?, limit?Markets by their gap vs the home exchange's last close, largest first, each with its session state (closed / cash / extended) and when real pricing resumes; while an exchange is shut (nights, weekends, holidays) this is the weekend or overnight gap. Optional group: us_stocks, etfs, indices, commodities, korea, japan, china_hk, india, fx, other.
get_reopen_timesnoneWhen each market group's real pricing resumes (overnight session, futures, cash open), in UTC and New York time, and each home exchange's session state.
get_scorecardnoneThe Monday scorecard: how often Hyperliquid's final weekend price was closer to the reopen than Friday's close, with sample sizes and confidence bounds. History, not a forecast.
get_ipoticker?An IPO board (default ANT, Anthropic): offer range with its filing and source, pricing and first trade dates with their status, and Hyperliquid's pre-IPO market as data.
get_preipo_marketsnoneEvery pre-IPO perp listed on Hyperliquid's HIP-3 deployers, with mark, implied valuation where a share count is on record, and listing status. Data only.
get_feesnoneKerbTape's builder fee schedule (basis points by tier and market class, the approved maximum), added on top of Hyperliquid's own fees. The data board is free.

Arguments marked ? are optional. Market ids look like xyz:NVDA (HIP-3 markets, deployer first) or BTC (Hyperliquid's crypto perps); search_markets turns "Nvidia", "S&P 500" or "gold" into one.

Claude#

  1. In Claude (web, desktop or mobile), open Customize, then Connectors, press "+" and choose "Add custom connector". On Team and Enterprise plans an owner adds it under Organization settings first.
  2. Name it KerbTape, paste https://kerbtape.com/mcp as the URL and choose "No sign in".
  3. In a chat, press "+", open Connectors, switch it on and ask, for example, "What is Nvidia's gap vs Friday's close on Hyperliquid right now?"

Free plans can add one custom connector. Claude Code: claude mcp add --transport http kerbtape https://kerbtape.com/mcp

ChatGPT#

  1. In ChatGPT on the web, open Plugins, press "+" and choose "Add custom MCP server".
  2. Name it KerbTape, paste https://kerbtape.com/mcp as the server URL and pick "No authentication".
  3. Confirm the warning and choose "Create as a plugin". In a chat, type @ and pick it.

Custom MCP servers depend on the ChatGPT plan and workspace (OpenAI lists Business, Enterprise and Edu, and Pro for read-only servers).

Cursor, VS Code and other MCP clients#

Cursor (~/.cursor/mcp.json):

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

VS Code (.vscode/mcp.json):

{"servers": {"kerbtape": {"type": "http", "url": "https://kerbtape.com/mcp"}}}

Both have one-click install links on the AI assistants page. To look at it by hand, run npx @modelcontextprotocol/inspector, choose the Streamable HTTP transport and connect to https://kerbtape.com/mcp: the tool list and every tool can be tried from there.

Protocol details#

  • Protocol versions: 2026-07-28 (stateless, per-request metadata, server/discover) and the initialize-based 2025-11-25, 2025-06-18 and 2025-03-26. Every reply is a single JSON object; there is no session and no event stream, so a GET on /mcp answers 405.
  • Limit: 60 requests a minute per IP address (HTTP 429 with Retry-After above it). The data behind each tool refreshes every few seconds; there is nothing to gain from polling faster.
  • Discovery: the server card is at https://kerbtape.com/mcp/server-card and the AI catalog at https://kerbtape.com/.well-known/ai-catalog.json.

JSON API#

The stable public endpoints are described in an OpenAPI 3.1 file at /openapi.json, so any tool that reads OpenAPI (a custom GPT action, a code generator, an API client) can use them. The most used:

EndpointWhat it returns
/api/board.json?links=0The weekend board: featured markets with last close, price now and gap, plus each exchange's session.
/api/reopen.jsonEvery closed market with its last close, price now, gap and when real pricing resumes.
/api/v2/markets.json?dex=allEvery HIP-3 market with its last close, session and prices; /api/v2/markets/xyz:NVDA.json for one.
/api/tape/scorecard.jsonThe Monday scorecard, with sample sizes and confidence bounds; /scorecard.csv has every graded row.
/api/ipo/ANT.jsonAn IPO board: offer range, pricing and first-trade dates with their sources.
/api/v2/preipo.jsonEvery pre-IPO perp, as data.
/api/fees.jsonKerbTape's builder fee schedule.

No key is needed; please keep to about one request a second (answers are cached for a minute). Larger history (every snapshot, every close) is in the historical datasets with a free key: see /pro, where every public endpoint is listed.

Text files for AI assistants#

  • /llms.txt: a short map of KerbTape and its main pages.
  • /llms-full.txt: every docs page as plain markdown, generated from these pages.

What the data is, and isn't#

  • Data only, not investment advice. A gap measures where Hyperliquid's price is against the last close; the scorecard is history, not a forecast.
  • A last close is Hyperliquid's own price at the official close: the oracle at the close minute when captured, otherwise its last trade before the close, marked as an estimate (Weekend and overnight gaps).
  • Market names are Hyperliquid's own (for example XYZ100), as the deployer lists them.

Updated . These pages describe what the product does. They are not investment advice and say nothing about where any price goes next.