Luzia Crypto API

Fornece dados de preços de criptomoedas em tempo real e informações de mercado das principais exchanges, como Binance, Coinbase e Kraken, por meio da Luzia API. Permite que assistentes de IA obtenham preços de tickers, comparem taxas de câmbio e analisem tendências de mercado por meio de ferramentas e prompts especializados.

GitHubExperimente este MCPPatrocinado

Documentação

@luziadev/mcp-server

Servidor Model Context Protocol (MCP) para dados de preços de criptomoedas. Dá a assistentes de IA como Claude acesso em tempo real a preços de tickers, informações de exchanges e histórico OHLCV da Luzia API.

Recursos

Preços de tickers em tempo real de múltiplas exchanges (Binance, Coinbase, Kraken, OKX, Bybit)
Dados históricos de candlestick OHLCV para análise técnica
Informações de mercado e pares de negociação
Status e disponibilidade das exchanges

Requisitos

Uma chave da API Luzia (obtenha uma aqui)

Conexão remota (recomendado)

A maneira mais rápida de usar a Luzia com seu assistente de IA é conectar-se ao nosso servidor MCP hospedado em https://mcp.luzia.dev/mcp. Não é necessário instalar. Basta colar a URL e sua chave de API.

Claude.ai web / Anthropic console

Configurações → Integrações → Adicionar MCP personalizado:

URL: https://mcp.luzia.dev/mcp
Autenticação: Token Bearer — cole sua chave de API (lz_...)

Claude Desktop (através de `mcp-remote`)

O suporte nativo a MCP remoto do Claude Desktop ainda está sendo lançado, então o caminho mais fácil hoje é o shim mcp-remote, que faz a ponte entre um MCP HTTP remoto e a interface stdio do Claude Desktop.

Edite sua configuração:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "luzia": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.luzia.dev/mcp",
        "--header",
        "Authorization:Bearer lz_your_api_key"
      ]
    }
  }
}

Reinicie o Claude Desktop (Cmd+Q no macOS) e comece a fazer perguntas.

VS Code, Cursor, Cline, Continue.dev

Cole a URL e o cabeçalho de Autorização nas configurações de MCP da sua ferramenta:

URL: https://mcp.luzia.dev/mcp
Header: Authorization: Bearer lz_your_api_key

MCP Inspector

npx @modelcontextprotocol/inspector

Em seguida, aponte o inspetor para https://mcp.luzia.dev/mcp e adicione o cabeçalho Authorization: Bearer lz_....

Instalação local (avançado)

Prefere executar o servidor localmente? O @luziadev/mcp-server ainda é distribuído no npm e roda via stdio.

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

Configuração do Claude Desktop (stdio local)

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

Configuração do Claude Code (stdio local)

Adicione a .claude/settings.json:

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

Ferramentas Disponíveis

Ferramenta	Descrição
`get_ticker`	Obter o preço atual de um par de negociação específico
`get_tickers`	Obter preços de vários pares ou de todos os pares de uma exchange
`get_history`	Obter dados históricos de candlestick OHLCV para um par de negociação
`get_exchanges`	Listar exchanges suportadas (CEX e DEX) e seu status
`get_markets`	Listar pares de negociação em uma exchange, incluindo metadados de pool DEX
`get_tokens`	Listar ativos canônicos e tokens on-chain, com filtros de busca e cadeia
`get_token`	Consultar um único token por id composto (`crypto:SYMBOL` ou `{chain}:SYMBOL`)
`get_fiat_currencies`	Listar moedas fiduciárias ISO 4217 referenciadas pelos mercados

Prompts Disponíveis

Prompts são modelos de análise pré-construídos que buscam dados e geram insights estruturados. Eles estão disponíveis em clientes que suportam prompts MCP (por exemplo, Claude Desktop através do menu /).

Nota: O Claude Code não suporta prompts MCP diretamente — use linguagem natural em vez disso (por exemplo, "Analise o movimento de preço do BTC/USDT na Binance") e ele chamará as ferramentas subjacentes automaticamente.

Prompt	Descrição
`analyze_price_movement`	Analisar movimentos de preço e tendências para um par de negociação
`analyze_ohlcv`	Analisar dados de candlestick OHLCV com análise técnica
`compare_exchanges`	Comparar preços entre exchanges para oportunidades de arbitragem

Exemplos de Prompts

`analyze_price_movement`

Busca dados atuais de ticker e analisa o spread de compra e venda, estatísticas de 24h e volume.

Argumentos:

exchange (obrigatório): por exemplo, "binance", "coinbase"
symbol (obrigatório): por exemplo, "BTC/USDT", "ETH/USD"

Claude Desktop: Digite / → selecione analyze_price_movement → preencha exchange: binance, symbol: BTC/USDT

Linguagem natural (qualquer cliente): "Analise o movimento atual do preço do BTC/USDT na Binance"

`analyze_ohlcv`

Busca dados históricos de candlestick e solicita análise técnica incluindo tendências, suporte/resistência, padrões de volume e padrões de candlestick.

Argumentos:

exchange (obrigatório): por exemplo, "binance"
symbol (obrigatório): por exemplo, "BTC/USDT"
interval (opcional): "1m", "5m", "15m", "1h", "1d" (padrão: "1h")
period (opcional): por exemplo, "24h", "7d", "30d" (padrão: "24h")

Claude Desktop: Digite / → selecione analyze_ohlcv → preencha exchange: binance, symbol: BTC/USDT, interval: 1h

Linguagem natural (qualquer cliente): "Analise candles OHLCV de BTC/USDT na Binance com intervalo de 1h para os últimos 7 dias"

`compare_exchanges`

Busca dados de ticker de múltiplas exchanges e compara preços, spreads e liquidez para análise de arbitragem.

Argumentos:

symbol (obrigatório): por exemplo, "BTC/USDT"
exchanges (opcional): lista separada por vírgulas, por exemplo, "binance,coinbase,kraken" (padrão: "binance,coinbase,kraken")

Claude Desktop: Digite / → selecione compare_exchanges → preencha symbol: BTC/USDT

Linguagem natural (qualquer cliente): "Compare preços de BTC/USDT em todas as exchanges"

Limites de Taxa

Herda do seu nível de assinatura da Luzia:

Grátis: 25 requisições/minuto, 1.000/dia
Pro: 1.000 requisições/minuto, 20.000/dia

Solução de Problemas

Erros de "Não autorizado"

Remoto: verifique se o cabeçalho Authorization: Bearer lz_... está definido e se a chave começa com lz_.
Stdio: verifique se LUZIA_API_KEY está definido na configuração do seu cliente MCP e se a chave não foi revogada.

Erros de sessão remota

Se o seu cliente relatar "Unknown session id", o servidor foi reiniciado ou sua sessão expirou (30min de inatividade). Reconecte e o cliente será reinicializado automaticamente.

Claude Desktop não consegue encontrar o servidor (stdio)

Verifique se claude_desktop_config.json é um JSON válido.
Garanta que o Node.js 20+ esteja instalado (node --version).
Reinicie o Claude Desktop completamente (Cmd+Q no macOS).

Licença

MIT - veja LICENSE para detalhes.

Luzia Crypto API

Documentação

@luziadev/mcp-server

Recursos

Requisitos

Conexão remota (recomendado)

Claude.ai web / Anthropic console

Claude Desktop (através de mcp-remote)

VS Code, Cursor, Cline, Continue.dev

MCP Inspector

Instalação local (avançado)

Configuração do Claude Desktop (stdio local)

Configuração do Claude Code (stdio local)

Ferramentas Disponíveis

Prompts Disponíveis

Exemplos de Prompts

analyze_price_movement

analyze_ohlcv

compare_exchanges

Limites de Taxa

Solução de Problemas

Erros de "Não autorizado"

Erros de sessão remota

Claude Desktop não consegue encontrar o servidor (stdio)

Licença

Claude Desktop (através de `mcp-remote`)

`analyze_price_movement`

`analyze_ohlcv`

`compare_exchanges`