# Skylit MCP server

> Connect an AI agent to Skylit's options-flow, dealer-positioning and volatility data over the Model Context Protocol.

> **Beta.** The API and MCP server are open to members with API access. Check yours on the [Developer page](https://app.skylit.ai/developer).

> **Info:** This page covers the **Skylit MCP server**: live market data, API key required. To let
> your AI tool read these docs instead (free, no key), use the [Docs MCP](https://www.skylit.ai/docs/mcp/docs-mcp).

The **Skylit MCP server** lets an AI agent — Claude, Cursor, or any
[Model Context Protocol](https://modelcontextprotocol.io) client — query Skylit's
market data directly, in natural language. Ask *"were there unusual bullish
sweeps on TSLA on Friday?"* and the agent calls the right tool, reads the result,
and answers.

It is a **single unified gateway** with 63 tools across three Skylit products:

- **Flowseeker** (`flow_*`, plus screeners and stats) — scored options trades,
  sweeps, tide, momentum, moneyness, ratios, sector and market-wide flow, dark pool.
- **Heatseeker** (`heat_*`) — live and historical per-strike gamma/vanna
  heatmaps, key levels, daily stats.
- **Tempest** (`tempest_*`) — implied volatility, term structure,
  expected-move cones, sigma, surface and skew, tilt, events, the S&P volatility
  complex, a universe screener, daily history and realized vs implied (`derived`).

**Atlas** (OHLCV price bars) isn't on the MCP server yet; use the
[Atlas REST API](https://www.skylit.ai/docs/api-reference/history/ohlcv-price-bars-for-a-symbol-and-resolution) on
`https://atlas-api.skylit.ai`.

One API key works across all of them. See the [full tool catalog](https://www.skylit.ai/docs/mcp/tools).

## Endpoint

```
https://mcp.skylit.ai/mcp
```

The transport is **streamable HTTP** (JSON-RPC over `POST`, responses as
Server-Sent Events). Most MCP clients only need the URL plus your key — see the
[quickstart](https://www.skylit.ai/docs/mcp/quickstart).

> **Note:** Every tool call costs the **same credits** as the equivalent REST endpoint. The
> per-tool cost is listed in the [tool catalog](https://www.skylit.ai/docs/mcp/tools), and each
> result's `meta` carries your remaining credit balance.

## Authentication

Supply your Skylit API key on the MCP connection as a bearer token. The same key
spans every product:

```bash
Authorization: Bearer <your-api-key>
```

> **Warning:** Treat API keys like passwords. Never commit them to source control or paste them
> into a shared agent prompt. Use environment variables and rotate a key if it leaks.

## Guardrails

To keep agent sessions predictable, the gateway enforces a **per-session call
budget** and an **in-flight concurrency limit**. If a session exceeds them, the
tool returns an error explaining the limit rather than running unbounded — credits
are only ever debited for calls that actually reach the data API.

- [Quickstart](https://www.skylit.ai/docs/mcp/quickstart): Connect Claude Desktop or Cursor in a couple of minutes.
- [Tool catalog](https://www.skylit.ai/docs/mcp/tools): Every tool, grouped, with credit costs.
- [Example prompts](https://www.skylit.ai/docs/mcp/examples): What to ask, and which tools answer it.
- [REST API Reference](https://www.skylit.ai/docs/api-reference/introduction): Prefer plain HTTP? Use the same data over REST.