# Skylit MCP server

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

> **Beta.** The Skylit API and MCP server are in Beta with limited access. [Request access](https://www.skylit.ai/?waitlist=developer) and we'll let you know when yours opens.

> **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** over both Skylit products:

- **Flowseeker** (`flow_*`, plus screeners and stats) — scored options trades,
  sweeps, tide, momentum, moneyness, ratios, sector and market-wide flow.
- **Heatseeker** (`heat_*`) — live and historical per-strike gamma/vanna
  heatmaps.

One API key works across both. 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): All 42 tools, 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.