{
  "markdown": "# @luziadev/mcp-server\n\n[![npm version](https://img.shields.io/npm/v/@luziadev/mcp-server.svg)](https://www.npmjs.com/package/@luziadev/mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nModel Context Protocol (MCP) server for cryptocurrency pricing data. Gives AI assistants like Claude real-time access to ticker prices, exchange information, and OHLCV history from the [Luzia API](https://luzia.dev).\n\n## Features\n\n- Real-time ticker prices from multiple exchanges (Binance, Coinbase, Kraken, OKX, Bybit)\n- Historical OHLCV candlestick data for technical analysis\n- Market information and trading pairs\n- Exchange status and availability\n\n## Requirements\n\n- A Luzia API key ([get one here](https://luzia.dev/keys))\n\n## Remote connection (recommended)\n\nThe fastest way to use Luzia with your AI assistant is to connect to our hosted MCP server at `https://mcp.luzia.dev/mcp`. No install required. Just paste the URL and your API key.\n\n### Claude.ai web / Anthropic console\n\nSettings → Integrations → **Add custom MCP**:\n- **URL:** `https://mcp.luzia.dev/mcp`\n- **Authentication:** Bearer token — paste your API key (`lz_...`)\n\n### Claude Desktop (via `mcp-remote`)\n\nClaude Desktop's native remote MCP support is still rolling out, so the easiest path today is the `mcp-remote` shim, which bridges a remote HTTP MCP to Claude Desktop's stdio interface.\n\nEdit your config:\n\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"luzia\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"mcp-remote\",\n        \"https://mcp.luzia.dev/mcp\",\n        \"--header\",\n        \"Authorization:Bearer lz_your_api_key\"\n      ]\n    }\n  }\n}\n```\n\nRestart Claude Desktop (Cmd+Q on macOS) and start asking questions.\n\n### VS Code, Cursor, Cline, Continue.dev\n\nPaste the URL and Authorization header into the MCP settings for your tool:\n\n- **URL:** `https://mcp.luzia.dev/mcp`\n- **Header:** `Authorization: Bearer lz_your_api_key`\n\n### MCP Inspector\n\n```bash\nnpx @modelcontextprotocol/inspector\n```\n\nThen point the inspector at `https://mcp.luzia.dev/mcp` and add the `Authorization: Bearer lz_...` header.\n\n## Local install (advanced)\n\nPrefer running the server locally? `@luziadev/mcp-server` still ships on npm and runs over stdio.\n\n```bash\n# Run directly with npx (no install needed)\nLUZIA_API_KEY=lz_your_api_key npx -y @luziadev/mcp-server --stdio\n```\n\n### Claude Desktop config (local stdio)\n\n```json\n{\n  \"mcpServers\": {\n    \"luzia\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@luziadev/mcp-server\", \"--stdio\"],\n      \"env\": {\n        \"LUZIA_API_KEY\": \"lz_your_api_key\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code config (local stdio)\n\nAdd to `.claude/settings.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"luzia\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@luziadev/mcp-server\", \"--stdio\"],\n      \"env\": {\n        \"LUZIA_API_KEY\": \"lz_your_api_key\"\n      }\n    }\n  }\n}\n```\n\n## Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `get_ticker` | Get current price for a specific trading pair |\n| `get_tickers` | Get prices for multiple pairs or all pairs on an exchange |\n| `get_history` | Get historical OHLCV candlestick data for a trading pair |\n| `get_exchanges` | List supported exchanges (CEX and DEX) and their status |\n| `get_markets` | List trading pairs on an exchange, including DEX pool metadata |\n| `get_tokens` | List canonical assets and on-chain tokens, with search and chain filters |\n| `get_token` | Look up a single token by composite id (`crypto:SYMBOL` or `{chain}:SYMBOL`) |\n| `get_fiat_currencies` | List ISO 4217 fiat currencies referenced by markets |\n\n## Available Prompts\n\nPrompts are pre-built analysis templates that fetch data and generate structured insights. They are available in clients that support MCP prompts (e.g., Claude Desktop via the `/` menu).\n\n> **Note:** Claude Code does not support MCP prompts directly — use natural language instead (e.g., \"Analyze BTC/USDT price movement on Binance\") and it will call the underlying tools automatically.\n\n| Prompt | Description |\n|--------|-------------|\n| `analyze_price_movement` | Analyze price movements and trends for a trading pair |\n| `analyze_ohlcv` | Analyze OHLCV candlestick data with technical analysis |\n| `compare_exchanges` | Compare prices across exchanges for arbitrage opportunities |\n\n### Prompt Examples\n\n#### `analyze_price_movement`\n\nFetches current ticker data and analyzes bid-ask spread, 24h stats, and volume.\n\n**Arguments:**\n- `exchange` (required): e.g., `\"binance\"`, `\"coinbase\"`\n- `symbol` (required): e.g., `\"BTC/USDT\"`, `\"ETH/USD\"`\n\n**Claude Desktop:** Type `/` → select `analyze_price_movement` → fill in `exchange: binance`, `symbol: BTC/USDT`\n\n**Natural language (any client):** \"Analyze the current BTC/USDT price movement on Binance\"\n\n#### `analyze_ohlcv`\n\nFetches historical candlestick data and requests technical analysis including trends, support/resistance, volume patterns, and candlestick patterns.\n\n**Arguments:**\n- `exchange` (required): e.g., `\"binance\"`\n- `symbol` (required): e.g., `\"BTC/USDT\"`\n- `interval` (optional): `\"1m\"`, `\"5m\"`, `\"15m\"`, `\"1h\"`, `\"1d\"` (default: `\"1h\"`)\n- `period` (optional): e.g., `\"24h\"`, `\"7d\"`, `\"30d\"` (default: `\"24h\"`)\n\n**Claude Desktop:** Type `/` → select `analyze_ohlcv` → fill in `exchange: binance`, `symbol: BTC/USDT`, `interval: 1h`\n\n**Natural language (any client):** \"Analyze BTC/USDT OHLCV candles on Binance with 1h interval for the last 7 days\"\n\n#### `compare_exchanges`\n\nFetches ticker data from multiple exchanges and compares prices, spreads, and liquidity for arbitrage analysis.\n\n**Arguments:**\n- `symbol` (required): e.g., `\"BTC/USDT\"`\n- `exchanges` (optional): comma-separated list, e.g., `\"binance,coinbase,kraken\"` (default: `\"binance,coinbase,kraken\"`)\n\n**Claude Desktop:** Type `/` → select `compare_exchanges` → fill in `symbol: BTC/USDT`\n\n**Natural language (any client):** \"Compare BTC/USDT prices across all exchanges\"\n\n## Rate Limits\n\nInherits from your Luzia subscription tier:\n- **Free:** 25 requests/minute, 1,000/day\n- **Pro:** 1,000 requests/minute, 20,000/day\n\n## Troubleshooting\n\n### \"Unauthorized\" errors\n\n- **Remote:** verify your `Authorization: Bearer lz_...` header is set and the key starts with `lz_`.\n- **Stdio:** verify `LUZIA_API_KEY` is set in your MCP client config and that the key has not been revoked.\n\n### Remote session errors\n\n- If your client reports \"Unknown session id\", the server was restarted or your session expired (30min idle). Reconnect and the client will re-initialize automatically.\n\n### Claude Desktop can't find the server (stdio)\n\n- Verify `claude_desktop_config.json` is valid JSON.\n- Ensure Node.js 20+ is installed (`node --version`).\n- Restart Claude Desktop completely (Cmd+Q on macOS).\n\n## License\n\nMIT - see [LICENSE](./LICENSE) for details.\n",
  "bytes": 6987,
  "sha": "b95a6992dc86095a3e005bdc70831f27b0f9c680b32a9d7cbf9e72b998079d46",
  "repo_slug": "luziadev/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_luziadev_luzia_df194b88/readme"
}