MCP Server

Connect Your AI Platform

Step-by-step guides for connecting Laevitas derivatives data to your favorite AI platform. Requires an Enterprise API key from your Laevitas dashboard.

Claude.ai Connectors

OAuth 2.1

Connect directly from Claude.ai using the built-in MCP Connectors feature. OAuth handles authentication automatically.

1

Go to Settings → Connectors in Claude.ai
2

Click Add custom connector
3

Fill in the fields:

NameLaevitas

Remote MCP server URLhttps://apiv2.laevitas.ch/api/v1/mcp

OAuth Client IDleave empty

OAuth Client Secretleave empty
4

Click Add — a popup will open asking for your Laevitas API key
5

Enter your API key and click Authorize. The connector is now active.

OAuth Client ID/Secret are left blank because the server supports dynamic client registration (RFC 7591). Claude.ai registers itself automatically.

Claude Desktop

API Key

Add to your claude_desktop_config.json:

1

Open Claude Desktop → Settings → Developer → Edit Config

Add the following to your config file:

{
  "mcpServers": {
    "laevitas-derivatives": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://apiv2.laevitas.ch/api/v1/mcp",
        "--header",
        "apikey: YOUR_API_KEY"
      ]
    }
  }
}

3

Restart Claude Desktop. The Laevitas tools will appear in your tool list.

Claude CLI (Claude Code)

API Key

One command to connect:

Run in your terminal:

claude mcp add laevitas-derivatives \
  --transport http \
  https://apiv2.laevitas.ch/api/v1/mcp \
  --header "apikey: YOUR_API_KEY"

Ask naturally:

claude -p "What's the BTC perpetual funding rate?"

ChatGPT / OpenAI

GPT Actions

Connect as a custom GPT Action using the MCP endpoint.

1

Go to Explore GPTs → Create in ChatGPT
2

Under Configure → Actions → Create new action
3

Set Authentication to API Key, header name apikey
4
Import the OpenAPI schema from:
```
https://apiv2.laevitas.ch/swagger-json
```
5

Save and test. Your GPT can now call Laevitas endpoints directly.

OpenAI GPT Actions use the REST API directly (not MCP protocol). All futures and options endpoints are available via the Swagger schema.

n8n

n8n Automation

MCP Client Node

Use the n8n MCP Client node to connect to Laevitas.

1

Add an MCP Client node to your workflow
2

Set Transport to Streamable HTTP
3
Enter the server URL:
```
https://apiv2.laevitas.ch/api/v1/mcp
```
4

Add a custom header: apikey: YOUR_API_KEY
5

Connect to an AI Agent node. The agent can now call all 20 Laevitas tools.

Any MCP Client

Streamable HTTP transport endpoint. Works with any MCP-compatible client.

Endpoint

POST https://apiv2.laevitas.ch/api/v1/mcp
Content-Type: application/json
Accept: application/json, text/event-stream
apikey: YOUR_API_KEY

OAuth 2.1 (for platforms that require it)

# Discovery endpoints
GET https://apiv2.laevitas.ch/.well-known/oauth-protected-resource
GET https://apiv2.laevitas.ch/.well-known/oauth-authorization-server

# Dynamic client registration
POST https://apiv2.laevitas.ch/oauth/register

# Authorization (PKCE S256 required)
GET https://apiv2.laevitas.ch/oauth/authorize

# Token exchange
POST https://apiv2.laevitas.ch/oauth/token

MCP Inspector (debug tool)

npx @modelcontextprotocol/inspector

Enter the endpoint URL and connect. Browse tools, call them, and inspect responses.

Available Tools

20 tools the AI agent can call. Grouped by category.

Catalog & Discovery

Tool	Description
`get_futures_catalog`	List all available futures and perpetual instruments on an exchange
`get_options_catalog`	List all available options instruments on an exchange
`get_futures_metadata`	Data availability metadata for a futures instrument (date range, data points)
`get_options_metadata`	Data availability metadata for an options instrument

Futures & Perpetuals

Tool	Description
`get_futures_ohlcv`	OHLCV candle data (price, volume, trade counts, liquidations)
`get_futures_ticker_history`	Ticker snapshots (mark price, funding rate, OI, bid/ask)
`get_futures_trades`	Individual trade records with full details
`get_futures_open_interest`	Aggregated open interest OHLC over time
`get_futures_volume`	24-hour rolling volume (contracts + USD)
`get_futures_level1`	Best bid/ask, spread, and liquidity over time
`get_futures_reference_price`	Mark price and index price OHLC
`get_futures_snapshot`	Full market snapshot of ALL instruments at one point in time

Options

Tool	Description
`get_options_ohlcv`	OHLCV candle data for options (trade-based)
`get_options_ticker_history`	Ticker snapshots (IV, Greeks, OI, bid/ask)
`get_options_trades`	Individual option trade records with Greeks
`get_options_open_interest`	Aggregated open interest over time
`get_options_volatility`	IV (mark/bid/ask), Greeks, and vol spread over time
`get_options_volume`	24-hour rolling volume (contracts + USD)
`get_options_level1`	Best bid/ask, spread, and liquidity over time
`get_options_snapshot`	Full options chain snapshot (all strikes, maturities) at one time

Protocol Examples

1. Initialize

curl -X POST https://apiv2.laevitas.ch/api/v1/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "apikey: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": {
        "name": "my-app",
        "version": "1.0.0"
      }
    }
  }'

2. List Tools

curl -X POST https://apiv2.laevitas.ch/api/v1/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "apikey: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/list"
  }'

3. Call a Tool

curl -X POST https://apiv2.laevitas.ch/api/v1/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "apikey: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "get_futures_ohlcv",
      "arguments": {
        "instrument_name": "BTC-PERPETUAL",
        "exchange": "deribit",
        "resolution": "1h",
        "limit": 10
      }
    }
  }'

Header (preferred)	`apikey: your-key-here`
Header (alternative)	`x-api-key: your-key-here`
Query parameter	`?apiKey=your-key-here`

PKCE	`S256` (required)
Grant type	`authorization_code`
Token lifetime	`1 hour` (auto-refreshes)

Connect Your AI Platform

Claude.ai Connectors

Claude Desktop

Claude CLI (Claude Code)

ChatGPT / OpenAI

n8n Automation

Any MCP Client

Authentication

API Key

OAuth 2.1

Available Tools

Catalog & Discovery

Futures & Perpetuals

Options

Protocol Examples

1. Initialize

2. List Tools

3. Call a Tool

Example Prompts