Derive MCP Server

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.
1

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal
git clone https://github.com/aadarshvelu/derive-mcp.git
cd derive-mcp
npm install
2

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal
claude mcp add derive-mcp -- node "<FULL_PATH_TO_DERIVE_MCP>/dist/index.js"

Replace <FULL_PATH_TO_DERIVE_MCP>/dist/index.js with the actual folder you prepared in step 1.

README.md

Provides market data from Derive.xyz, including currencies and instruments.

Derive MCP Server

An MCP (Model Context Protocol) server that provides market data from Derive.xyz (formerly Lyra Finance). All endpoints are public — no authentication required.

Tools

Tool Description
get_all_currencies List all available currencies
get_currency Details for a specific currency
get_all_instruments List instruments (options, perps, ERC20)
get_instrument Details for a specific instrument
get_ticker Current price, volume, bid/ask for an instrument
get_tickers Tickers for all instruments of a given type
get_spot_feed_history Historical spot prices
get_spot_feed_history_candles OHLC candlestick data
get_funding_rate_history Perpetual funding rate history
get_interest_rate_history Borrowing interest rate history
get_option_settlement_history Option settlement history
get_latest_signed_feeds Current oracle price feeds
get_liquidation_history Liquidation events
get_margin Margin requirement simulation
get_statistics Platform volume and open interest stats

Setup

git clone https://github.com/aadarshvelu/derive-mcp.git
cd derive-mcp
npm install

Usage

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "derive": {
      "command": "node",
      "args": ["/path/to/derive-mcp/server.mjs"]
    }
  }
}

Restart Claude Desktop. The 15 market data tools will be available.

Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "derive": {
      "command": "node",
      "args": ["/path/to/derive-mcp/server.mjs"]
    }
  }
}

Or run directly:

claude mcp add derive node /path/to/derive-mcp/server.mjs

MCP Inspector (debugging)

npx @modelcontextprotocol/inspector node server.mjs

Tests

node test-mcp.mjs

Runs 16 tests against the live Derive API (15 tool calls + tool listing).

API Reference

All tools call the Derive public REST API at https://api.lyra.finance. No API keys or authentication needed.

Tools (15)

get_all_currenciesList all available currencies
get_currencyDetails for a specific currency
get_all_instrumentsList instruments (options, perps, ERC20)
get_instrumentDetails for a specific instrument
get_tickerCurrent price, volume, bid/ask for an instrument
get_tickersTickers for all instruments of a given type
get_spot_feed_historyHistorical spot prices
get_spot_feed_history_candlesOHLC candlestick data
get_funding_rate_historyPerpetual funding rate history
get_interest_rate_historyBorrowing interest rate history
get_option_settlement_historyOption settlement history
get_latest_signed_feedsCurrent oracle price feeds
get_liquidation_historyLiquidation events
get_marginMargin requirement simulation
get_statisticsPlatform volume and open interest stats

Configuration

claude_desktop_config.json
{"mcpServers": {"derive": {"command": "node", "args": ["/path/to/derive-mcp/server.mjs"]}}}

Try it

What is the current ticker price for the main BTC perpetual instrument?
Show me the OHLC candlestick data for the last 24 hours for ETH options.
What are the latest funding rates for perpetual instruments on Derive?
Can you provide the platform statistics for volume and open interest?
List all available currencies supported on the Derive platform.

Frequently Asked Questions

What are the key features of Derive MCP Server?

Access to real-time market data from Derive.xyz. Query historical spot prices and candlestick data. Retrieve perpetual funding rates and interest rate history. Simulate margin requirements for trades. Public API access with no authentication required.

What can I use Derive MCP Server for?

Analyzing historical price trends for crypto options and perpetuals. Monitoring real-time market liquidity and oracle price feeds. Integrating financial market data into AI-driven trading research. Tracking platform-wide volume and open interest statistics.

How do I install Derive MCP Server?

Install Derive MCP Server by running: git clone https://github.com/aadarshvelu/derive-mcp.git && cd derive-mcp && npm install

What MCP clients work with Derive MCP Server?

Derive MCP Server works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Derive MCP Server docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare