README.md
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 currenciesget_currencyDetails for a specific currencyget_all_instrumentsList instruments (options, perps, ERC20)get_instrumentDetails for a specific instrumentget_tickerCurrent price, volume, bid/ask for an instrumentget_tickersTickers for all instruments of a given typeget_spot_feed_historyHistorical spot pricesget_spot_feed_history_candlesOHLC candlestick dataget_funding_rate_historyPerpetual funding rate historyget_interest_rate_historyBorrowing interest rate historyget_option_settlement_historyOption settlement historyget_latest_signed_feedsCurrent oracle price feedsget_liquidation_historyLiquidation eventsget_marginMargin requirement simulationget_statisticsPlatform volume and open interest statsTry 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.