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.

Authentication

The MCP server supports three authentication methods. Use whichever your platform requires.

API Key

CLI, Desktop, Custom

Pass your key directly via HTTP header. Best for programmatic access.

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

OAuth 2.1

Claude.ai, Web Platforms

Automatic OAuth flow for platforms that require it. You enter your API key once during authorization.

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

x402 Payment

No API Key Needed

Pay per tool call with USDC. No signup required. Connect and list tools for free, pay only when calling tools.

initialize	Free
tools/list	Free
tools/call	`1 credit` per call

Learn more about x402 →

x402 Payment Flow for MCP

No API key? No problem. AI agents can pay per tool call using USDC on Base or Solana.

Connect for free — initialize and tools/list work without any auth

Call a tool — first tools/call without payment returns 402 with payment instructions

Pay with USDC — sign a payment and retry. Get data + a credit token + 99 prepaid credits

Use credits — send X-Credit-Token header for instant tool calls (~1ms, no gas)

Credits work across both REST endpoints and MCP tool calls. A credit token earned via REST can be used for MCP and vice versa.

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_ohlcvt`	OHLCVT candle data (price, volume, trades, 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_ohlcvt`	OHLCVT 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_ohlcvt",
      "arguments": {
        "instrument_name": "BTC-PERPETUAL",
        "exchange": "deribit",
        "resolution": "1h",
        "limit": 10
      }
    }
  }'

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

x402 Payment

x402 Payment Flow for MCP

Available Tools

Catalog & Discovery

Futures & Perpetuals

Options

Protocol Examples

1. Initialize

2. List Tools

3. Call a Tool

Example Prompts