Tickory MCP Server

Servidor MCP de Tickory

Alertas de criptomonedas en tiempo real, ejecución de escaneos ad hoc y enrutamiento de relays de TradingView, entregados directamente a tu agente de IA.

Tickory monitorea los mercados de futuros de Binance utilizando reglas CEL programables y enrutamiento de relays de TradingView. Este servidor MCP permite que cualquier framework de agentes cree escaneos, ejecute escaneos guardados o ad hoc, configure fuentes y rutas de relay, inspeccione trazas de relay, lea eventos de alerta y comprenda por qué se activaron las alertas, todo a través del Protocolo de Contexto de Modelo.

Demostración 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.

Ejemplo de flujo 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.

Instalación

npm / npx

npx @tickory/mcp

El paquete npm descarga el binario correspondiente de GitHub Release para macOS y Linux durante la instalación, por lo que npx @tickory/mcp funciona sin un paso de compilación adicional.

Instalación con Go

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

Binarios precompilados

Descárgalos desde GitHub Releases para Linux y macOS (amd64/arm64).

Compilar desde el código fuente

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

Configuración

1. Obtén una cuenta de Tickory en tickory.app
2. Crea una clave API con alcance en tu panel de control en Configuración > Claves API
3. Configura el servidor MCP:

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

Los flujos de trabajo de relay requieren claves API con manage_routing y read_events. La ejecución de escaneos guardados y ad hoc requiere manage_scans.

Claude Desktop

Agrégalo a tu 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

Agrégalo a tu .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 / otros clientes MCP

Apúntalo a npx @tickory/mcp o al binario independiente tickory-mcp con las variables de entorno anteriores. El servidor usa stdio (JSON-RPC 2.0 delimitado por nuevas líneas).

Herramientas

Herramienta	Descripción
tickory_list_scans	Lista los escaneos visibles para el propietario de la clave API
tickory_get_scan	Obtiene un escaneo por ID
tickory_create_scan	Crea un nuevo escaneo con expresión CEL y límites estrictos
tickory_update_scan	Reemplaza una definición de escaneo existente
tickory_run_scan	Ejecuta un escaneo inmediatamente
tickory_run_ad_hoc_scan	Ejecuta una expresión única inmediatamente sin crear un escaneo guardado
tickory_describe_indicators	Describe las variables CEL disponibles, protecciones recomendadas y expresiones de ejemplo
tickory_list_alert_events	Lista eventos de alerta con paginación por cursor
tickory_get_alert_event	Obtiene un evento de alerta por UUID
tickory_explain_alert_event	Explica por qué se activó o se suprimió una alerta
tickory_create_relay_source	Crea una fuente de relay de TradingView y devuelve el payload de configuración de TradingView listo para pegar
tickory_list_relay_sources	Lista fuentes de relay de TradingView y resúmenes de rutas directas
tickory_add_relay_route	Agrega una ruta de relay directa a telegram, webhook, discord o email
tickory_list_relay_events	Lista eventos de relay entrantes recientes para una fuente de TradingView
tickory_get_relay_trace	Obtiene la traza completa del ciclo de vida de un evento de fuente de relay
tickory_replay_relay_event	Reintenta una ruta de relay fallida cuando el backend lo permite

Todas las herramientas devuelven schema_version: "v1" para estabilidad del contrato.

tickory_run_scan ejecuta un escaneo guardado existente por scan_id. tickory_run_ad_hoc_scan ejecuta una expresión única y no crea ni actualiza un escaneo guardado, por lo que el payload de ejecución devuelto puede tener un scan_id vacío.

Configuración

Variable	Requerida	Predeterminado	Descripción
TICKORY_API_BASE_URL	Sí	—	URL base de la API de Tickory
TICKORY_API_KEY	Sí	—	Clave API con alcance (tk_...)
TICKORY_TIMEOUT_SECONDS	No	15	Tiempo de espera HTTP para solicitudes de API

Las banderas de CLI (--api-base-url, --api-key, --timeout) anulan las variables de entorno.

Manejo de errores

Los errores HTTP ascendentes se asignan a códigos de error MCP deterministas:

Estado HTTP	Código MCP	Reintentable
400	invalid_request	No
401	unauthorized	No
403	forbidden	No
404	not_found	No
409	conflict	No
429	rate_limited	Sí
5xx	upstream_error	Sí

Permisos de clave API con alcance

Alcance	Qué permite
read_events	Leer eventos de alerta, trazas de relay, ejecuciones de escaneo, actividad
manage_scans	Crear/leer/actualizar/eliminar escaneos, ejecutar escaneos
manage_routing	Crear/gestionar fuentes y rutas de relay

Crea claves con los alcances mínimos necesarios. Consulta la documentación para desarrolladores para más detalles.

Versiones del protocolo

Este servidor negocia versiones del protocolo MCP: 2024-11-05, 2025-03-26, 2025-06-18, 2025-11-05 y 2025-11-25.

Licencia

MIT