@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

• Node.js 20 or later
• A Luzia API key (get one here)

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.