Luzia MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add -e "LUZIA_API_KEY=${LUZIA_API_KEY}" luzia-crypto -- npx -y @luziadev/mcp-server --stdio
Required:LUZIA_API_KEY
README.md

Model Context Protocol (MCP) server for cryptocurrency pricing data.

@luziadev/mcp-server

Model Context Protocol (MCP) server for cryptocurrency pricing data. Allows AI assistants like Claude to access real-time ticker prices, exchange information, and market data from the Luzia API.

Features

  • Real-time ticker prices from multiple exchanges (Binance, Coinbase, Kraken, OKX, Bybit)
  • Historical OHLCV candlestick data for technical analysis
  • Market information and trading pairs
  • Exchange status and availability

Requirements

Installation

# Run directly with npx (no install needed)
LUZIA_API_KEY=lz_your_api_key npx @luziadev/mcp-server --stdio

# Or install globally
npm install -g @luziadev/mcp-server
LUZIA_API_KEY=lz_your_api_key luzia-mcp --stdio

Updating

# If installed globally
npm install -g @luziadev/mcp-server@latest

# If using npx, it always fetches the latest version
npx @luziadev/mcp-server@latest --stdio

Claude Desktop Setup

  1. Open Claude Desktop config:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. Add the Luzia server (replace with your API key):

    {
      "mcpServers": {
        "luzia": {
          "command": "npx",
          "args": ["-y", "@luziadev/mcp-server", "--stdio"],
          "env": {
            "LUZIA_API_KEY": "lz_your_api_key"
          }
        }
      }
    }
    
  3. Restart Claude Desktop (Cmd+Q on macOS, then reopen)

  4. Start asking questions:

    • "What's the current price of Bitcoin on Binance?"
    • "Compare ETH prices across all exchanges"
    • "Show me the top trading pairs on Coinbase"

Claude Code Setup

Add to .claude/settings.json:

{
  "mcpServers": {
    "luzia": {
      "command": "npx",
      "args": ["-y", "@luziadev/mcp-server", "--stdio"],
      "env": {
        "LUZIA_API_KEY": "lz_your_api_key"
      }
    }
  }
}

Available Tools

Tool Description
get_ticker Get current price for a specific trading pair
get_tickers Get prices for multiple pairs or all pairs on an exchange
get_history Get historical OHLCV candlestick data for a trading pair
get_exchanges List supported exchanges and their status
get_markets List available trading pairs on an exchange

Available Prompts

Prompt Description
analyze_price_movement Analyze price movements and trends for a trading pair
analyze_ohlcv Analyze OHLCV candlestick data with technical analysis
compare_exchanges Compare prices across exchanges for arbitrage opportunities

Rate Limits

Inherits from your Luzia subscription tier:

  • Free: 100 requests/minute, 5,000/day
  • Pro: 1,000 requests/minute, 20,000/day

Troubleshooting

Claude Desktop can't find the server

  1. Verify claude_desktop_config.json is valid JSON
  2. Ensure Node.js 20+ is installed (run node --version)
  3. Restart Claude Desktop completely (Cmd+Q on macOS)

"Unauthorized" errors

  1. Verify your API key is correct
  2. Check that the API key has not expired

License

MIT - see LICENSE for details.

Tools (5)

get_tickerGet current price for a specific trading pair
get_tickersGet prices for multiple pairs or all pairs on an exchange
get_historyGet historical OHLCV candlestick data for a trading pair
get_exchangesList supported exchanges and their status
get_marketsList available trading pairs on an exchange

Environment Variables

LUZIA_API_KEYrequiredAPI key obtained from luzia.dev

Configuration

claude_desktop_config.json
{"mcpServers": {"luzia": {"command": "npx", "args": ["-y", "@luziadev/mcp-server", "--stdio"], "env": {"LUZIA_API_KEY": "lz_your_api_key"}}}}

Try it

What's the current price of Bitcoin on Binance?
Compare ETH prices across all exchanges
Show me the top trading pairs on Coinbase
Analyze the price movement for BTC/USDT over the last 24 hours

Frequently Asked Questions

What are the key features of Luzia MCP Server?

Real-time ticker prices from multiple exchanges including Binance, Coinbase, and Kraken. Historical OHLCV candlestick data for technical analysis. Market information and trading pair discovery. Exchange status and availability monitoring.

What can I use Luzia MCP Server for?

Fetching real-time crypto prices for financial analysis. Comparing exchange rates to identify arbitrage opportunities. Retrieving historical market data for technical analysis. Monitoring exchange availability and supported trading pairs.

How do I install Luzia MCP Server?

Install Luzia MCP Server by running: npx @luziadev/mcp-server --stdio

What MCP clients work with Luzia MCP Server?

Luzia 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 Luzia 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