Tickory MCP Server

Tickory MCP Server

Scanner de criptomoedas em tempo real com alertas, execução de varreduras ad hoc e roteamento de relay TradingView, entregue diretamente ao seu agente de IA.

O Tickory monitora os mercados de Futuros Binance usando regras CEL programáveis e roteamento de relay TradingView. Este servidor MCP permite que qualquer framework de agentes crie varreduras, execute varreduras salvas ou ad hoc, configure fontes e rotas de relay, inspecione rastreamentos de relay, leia eventos de alerta e entenda por que os alertas foram acionados — tudo através do Model Context Protocol.

Demonstração rápida

You: "Create a scan that fires when RSI drops below 30 on any coin with volume over $100k"

Agent (via tickory_create_scan): Done — scan "Oversold Bounce" created.

You: "Run it now"

Agent (via tickory_run_scan): 3 matches found: ETHUSDT, SOLUSDT, DOGEUSDT.

You: "Why did ETH match?"

Agent (via tickory_explain_alert_event): RSI-14 was 24.7, below your threshold of 30.
  Volume gate passed: $487k USDT > $100k minimum. CEL expression evaluated true.

Exemplo de fluxo de relay

You: "Set up a TradingView relay to my Telegram"

Agent (via tickory_create_relay_source): Created source "Momentum Strategy".
  Webhook URL: https://api.tickory.app/api/webhooks/tradingview/src_123
  Payload template includes your source secret and TradingView placeholders.

Agent (via tickory_add_relay_route): Telegram relay route created.

You: "Why didn't my last webhook alert send?"

Agent (via tickory_list_relay_events): 1 recent event found for source src_123.
Agent (via tickory_get_relay_trace): Route route_123 failed downstream with timeout.
Agent (via tickory_replay_relay_event): Failed route queued for replay.

Instalação

npm / npx

npx @tickory/mcp

O pacote npm baixa o binário correspondente do GitHub Release para macOS e Linux durante a instalação, então o npx @tickory/mcp funciona sem uma etapa separada de compilação.

Instalação via Go

go install github.com/tickory/tickory-mcp@latest

Binários pré-compilados

Baixe do GitHub Releases para Linux e macOS (amd64/arm64).

Compilar a partir do código-fonte

git clone https://github.com/tickory/tickory-mcp.git
cd tickory-mcp
go build -o tickory-mcp .

Configuração

1. Obtenha uma conta Tickory em tickory.app
2. Crie uma chave de API com escopo no seu painel em Configurações > Chaves de API
3. Configure o servidor MCP:

export TICKORY_API_BASE_URL=https://api.tickory.app
export TICKORY_API_KEY=tk_xxxxxxxx_yyyyyyyyyyyyyyyyyyyyyyyy

Fluxos de trabalho de relay exigem chaves de API com manage_routing e read_events. A execução de varreduras salvas e ad hoc exige manage_scans.

Claude Desktop

Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "tickory": {
      "command": "npx",
      "args": ["@tickory/mcp"],
      "env": {
        "TICKORY_API_BASE_URL": "https://api.tickory.app",
        "TICKORY_API_KEY": "tk_xxxxxxxx_yyyyyyyyyyyyyyyyyyyyyyyy"
      }
    }
  }
}

Claude Code

Adicione ao seu .mcp.json:

{
  "mcpServers": {
    "tickory": {
      "command": "npx",
      "args": ["@tickory/mcp"],
      "env": {
        "TICKORY_API_BASE_URL": "https://api.tickory.app",
        "TICKORY_API_KEY": "tk_xxxxxxxx_yyyyyyyyyyyyyyyyyyyyyyyy"
      }
    }
  }
}

Cursor / Windsurf / outros clientes MCP

Aponte para npx @tickory/mcp ou para o binário autônomo tickory-mcp com as variáveis de ambiente acima. O servidor usa stdio (JSON-RPC 2.0 delimitado por nova linha).

Ferramentas

Ferramenta	Descrição
tickory_list_scans	Lista varreduras visíveis ao proprietário da chave de API
tickory_get_scan	Busca uma varredura por ID
tickory_create_scan	Cria uma nova varredura com expressão CEL e limites rígidos
tickory_update_scan	Substitui uma definição de varredura existente
tickory_run_scan	Aciona uma execução de varredura imediatamente
tickory_run_ad_hoc_scan	Executa uma expressão avulsa imediatamente sem criar uma varredura salva
tickory_describe_indicators	Descreve variáveis CEL disponíveis, proteções recomendadas e exemplos de expressões
tickory_list_alert_events	Lista eventos de alerta com paginação por cursor
tickory_get_alert_event	Busca um evento de alerta por UUID
tickory_explain_alert_event	Explica por que um alerta foi acionado ou suprimido
tickory_create_relay_source	Cria uma fonte de relay TradingView e retorna o payload de configuração TradingView pronto para colar
tickory_list_relay_sources	Lista fontes de relay TradingView e resumos de rotas diretas
tickory_add_relay_route	Adiciona uma rota de relay direta para telegram, webhook, discord ou email
tickory_list_relay_events	Lista eventos de relay recebidos recentes para uma fonte TradingView
tickory_get_relay_trace	Busca o rastreamento completo do ciclo de vida de um evento de fonte de relay
tickory_replay_relay_event	Reproduz uma rota de relay com falha quando o backend permite

Todas as ferramentas retornam schema_version: "v1" para estabilidade de contrato.

tickory_run_scan executa uma varredura salva existente por scan_id. tickory_run_ad_hoc_scan executa uma expressão avulsa e não cria nem atualiza uma varredura salva, portanto o payload de execução retornado pode ter um scan_id vazio.

Configuração

Variável	Obrigatória	Padrão	Descrição
TICKORY_API_BASE_URL	Sim	—	URL base da API Tickory
TICKORY_API_KEY	Sim	—	Chave de API com escopo (tk_...)
TICKORY_TIMEOUT_SECONDS	Não	15	Timeout HTTP para requisições de API

Flags de CLI (--api-base-url, --api-key, --timeout) substituem as variáveis de ambiente.

Tratamento de erros

Erros HTTP upstream são mapeados para códigos de erro MCP determinísticos:

Status HTTP	Código MCP	Repetível
400	invalid_request	Não
401	unauthorized	Não
403	forbidden	Não
404	not_found	Não
409	conflict	Não
429	rate_limited	Sim
5xx	upstream_error	Sim

Permissões de chave de API com escopo

Escopo	O que permite
read_events	Ler eventos de alerta, rastreamentos de relay, execuções de varredura, atividade
manage_scans	Criar/ler/atualizar/excluir varreduras, executar varreduras
manage_routing	Criar/gerenciar fontes e rotas de relay

Crie chaves com os escopos mínimos necessários. Consulte a documentação do desenvolvedor para detalhes.

Versões de protocolo

Este servidor negocia versões de protocolo MCP: 2024-11-05, 2025-03-26, 2025-06-18, 2025-11-05 e 2025-11-25.

Licença

MIT