MCP Server

AI toolkit

The CryptoStruct MCP server lets AI agents — Claude, Cursor, or any Model Context Protocol client — search our historical market-data catalog, read live market statistics, and buy tick-data files directly from a conversation. No API key needed for the free tier; optionally sign in via OAuth to reach your orders, pay with Premium credits, and unlock Premium depth. Card payment happens in the browser via Stripe checkout.

Endpoint: https://cryptostruct.com/mcp (Streamable HTTP, stateless; keyless free tier — sign-in via OAuth is optional)

Connect · Claude Code

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

Connect · claude.ai / Claude Desktop

Settings → Connectors → Add custom connector → https://cryptostruct.com/mcp

Connect · Cursor (~/.cursor/mcp.json)

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

Connect · Raw JSON-RPC (curl)

curl https://cryptostruct.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Streamable HTTP, stateless — POST JSON-RPC messages; both Accept types are required.

Reference

Tools

Catalog & discovery

Find instruments and understand what the archive holds — free, no auth.

search_instruments — Search ~416K instruments across 33 venues by ticker, base asset or id, with class/venue filters.
list_venues — All covered venues with the archive headline numbers.
get_instrument — Master data + coverage summary for one instrument id.
get_coverage — Day-level coverage: first/last day, gaps, total size — check before you buy.
get_data_dictionary — File format, message types, integrity guarantees, pricing and links.
list_sample_files — Free full-day sample files with direct download URLs.
get_price_quote — EUR quote for a basket of instrument-days, with per-item availability.

Market statistics

The same 1-minute/daily aggregates the analyze pages chart: OHLC, VWAP, trades, turnover, spreads, top-of-book depth.

get_market_snapshot — Live snapshot: last price, 24h change, 60-min turnover/trades, spread (bps), top-1/top-20 depth.
get_daily_stats — Daily OHLC/VWAP/turnover series over 30/90/180 days with a window summary. Premium: 365d and max (full history).
get_hourly_stats — Hourly OHLC/VWAP/turnover/spread/depth series over 7/30/90 days. Premium: 180d.
get_slippage — Market-impact ladder: reachable notional within X bps of mid, time-averaged over 1h. Premium: 24h and 7d.
get_minutes_range — [Premium] Historical per-minute series (1h/3h/6h windows, any UTC hour within ~30-day retention) incl. data-quality fields — event studies.
get_top_instruments — Top instruments by live 24h turnover across all venues.
get_movers — 24h gainers and losers per class with a minimum-turnover floor.

Your account (sign-in required)

Connect with OAuth sign-in and the agent can work with your CryptoStruct account directly.

list_my_orders — Your order history: status, totals, credits applied, invoice PDFs, tokenized order links.
get_my_files — Every file you own as a flat list with delivery state and direct download URLs (owner links never expire).
get_my_subscription — Premium status, credit balance and the latest credit-ledger entries.

Buying data

The agent assembles the purchase; you pay in the browser. Raw tick files are 1 EUR per instrument-day.

create_checkout — Start a purchase (max 100 files per checkout) — returns a Stripe checkout URL to open in the browser.
get_checkout_status — Poll the checkout; once paid it returns the order id and download token.
get_order_files — List a paid order's files with delivery state and direct download URLs.
request_file_restore — Wake an archived (cold-storage) file — restores take up to ~12 hours.

Buying data from an agent

search_instruments — find the instrument and note its instrument_id
get_coverage — confirm the days you need exist
get_price_quote — total price in EUR
create_checkout — returns a Stripe checkout URL; open it in the browser and pay
get_checkout_status — poll until "paid"; returns order_id + download_token
get_order_files — per-file download URLs (ready / restoring / archived)

Premium & sign-in

The free tier mirrors what the website shows — same windows, same limits, keyless. Signing in connects the agent to your CryptoStruct account; CryptoStruct Premium (20 EUR/month, the same subscription that powers the deep analyze views) unlocks the deep windows on top. Raw tick files stay 1 EUR per instrument-day for everyone.

What sign-in adds (free account)

Account tools: list_my_orders, get_my_files (never-expiring download links), get_my_subscription.
Checkout knows you: email optional, already-owned files are dropped, Premium credits apply automatically (1 credit = 1 EUR = 1 file-day).
Your own call budget, keyed to your account instead of your IP.

Free vs Premium at a glance

Capability	Free	Premium (20 EUR/mo)
Call budget	120 units/min	600/min (5x)
get_daily_stats	30 / 90 / 180d	+ 365d, max
get_hourly_stats	7 / 30 / 90d	+ 180d
get_slippage	1h	+ 24h, 7d
get_minutes_range	— (locked)	full ~30-day retention
get_market_snapshot	core metrics	+ data-quality block
search_instruments	≤ 25 / call	up to 100 / call

Connect · claude.ai / Claude Desktop (sign-in)

Settings → Connectors → Add custom connector → https://cryptostruct.com/mcp/auth

The /mcp/auth endpoint asks for sign-in on connect (OAuth in the browser). Same tools as /mcp.

Connect · Claude Code (sign-in)

claude mcp add --transport http cryptostruct https://cryptostruct.com/mcp
claude mcp login cryptostruct

Connect · Cursor (~/.cursor/mcp.json, sign-in)

{ "mcpServers": { "cryptostruct": { "url": "https://cryptostruct.com/mcp/auth" } } }

Sign-in uses OAuth against our Clerk account system — the agent never sees your password, and you can revoke access anytime from your account. Keyless use keeps working unchanged; tools and parameters beyond your tier answer AUTH_REQUIRED / PREMIUM_REQUIRED with an upgrade link.

Fair use & rate limits

Anonymous access shares a per-IP budget (weighted per tool call); signed-in callers get their own per-account budget, and Premium raises it 5x. On a RATE_LIMITED error, back off for the indicated seconds. Need sustained programmatic scale beyond that — batch queries, bulk exports? Talk to us: the pricing page lists the ways in.

Units & conventions

Market values (turnover, depth) are USD; sale prices are EUR. All file sizes are compressed (zstd) bytes. Minute-level statistics are retained for roughly 30 days; daily aggregates reach back further. Instrument ids are stable for the lifetime of an instrument and identical across MCP, shop and analyze pages.

Guest vs signed-in orders

Anonymous MCP purchases use the guest flow: the download link and token from get_checkout_status stay valid for 30 days. Signed-in (OAuth) purchases are linked to your account permanently, drop already-owned files automatically, and apply available Premium credits before Stripe — a fully covered order completes without any browser step.

Prefer files over tools? The Agent Skill teaches your assistant to parse the raw tick files locally, and llms.txt maps everything machine-readable. Free sample days live on /download.