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.