Servidor MCP de TickerDB

Name: TickerAPI
Author: tickerdb

Servidor MCP (Model Context Protocol) para TickerDB: inteligencia de mercado precalculada para agentes de IA.

Conecta TickerDB a cualquier cliente compatible con MCP: Claude Desktop, Claude Code, Cursor, Windsurf, OpenClaw, LangChain, LlamaIndex, AutoGen, CrewAI y más.

Herramientas disponibles

Herramienta	Descripción
`get_summary`	Resumen técnico y fundamental para un solo ticker (admite filtrado por rango de fechas y eventos)
`get_watchlist`	Datos en tiempo real para los tickers de tu lista de seguimiento guardada
`get_watchlist_changes`	Diferencias a nivel de campo desde la última ejecución de la canalización
`add_to_watchlist`	Añadir tickers a tu lista de seguimiento
`remove_from_watchlist`	Eliminar tickers de tu lista de seguimiento
`get_account`	Detalles de la cuenta, nivel del plan y uso
`create_webhook`	Registrar un webhook para cambios en la lista de seguimiento
`list_webhooks`	Listar webhooks registrados
`delete_webhook`	Eliminar un webhook

Usa get_summary con los parámetros start/end para sincronizaciones masivas de tickers en un rango de fechas, o con los parámetros field/band para consultar ocurrencias de eventos.

Metadatos de estabilidad de banda

Las herramientas de resumen, lista de seguimiento y cambios en la lista de seguimiento devuelven metadatos de estabilidad de banda. Cada campo de banda (dirección de tendencia, zona de impulso, etc.) incluye un objeto hermano _meta que describe qué tan estable es ese estado. La etiqueta de estabilidad es una de las siguientes: fresh, holding, established o volatile. Los metadatos completos también incluyen periods_in_current_state, flips_recent y flips_lookback. Este contexto ayuda a los agentes a distinguir entre un estado recién ingresado y uno que ha persistido durante muchos períodos, mejorando la calidad de las señales comerciales y las alertas.

Configuración

Opción 1: Claude.ai (OAuth)

El servidor remoto en mcp.tickerdb.com admite OAuth 2.1 para conectores de Claude.ai. No se requiere gestión de claves API: inicia sesión con tu cuenta de TickerDB y Claude.ai se encarga del resto.

Opción 2: Servidor remoto (Token Bearer)

Conecta cualquier cliente MCP a https://mcp.tickerdb.com/mcp con tu clave API como un token Bearer.

Opción 3: Paquete npm (Claude Desktop, Cursor, etc.)

Añádelo a tu configuración de Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "tickerdb": {
      "command": "npx",
      "args": ["tickerdb-mcp-server"],
      "env": {
        "TICKERDB_KEY": "tapi_your_api_key_here"
      }
    }
  }
}

Obtén una clave API en tickerdb.com/dashboard.

Estructura

Este es un espacio de trabajo de tres paquetes:

shared/ — Definiciones de herramientas compartidas, cliente API y fábrica de servidores (interno, no publicado)
remote/ — Cloudflare Worker desplegado en mcp.tickerdb.com (transporte HTTP transmitible + OAuth 2.1)
local/ — Paquete npm publicado tickerdb-mcp-server (transporte stdio)

Tanto el servidor remoto como el paquete npm utilizan las mismas definiciones de herramientas de shared/. El servidor MCP es un proxy ligero: todo el control de acceso basado en niveles, la limitación de velocidad y el filtrado de campos son manejados por la API HTTP de TickerDB.

Autenticación

El servidor remoto admite dos métodos de autenticación:

Token Bearer — pasa tu clave API tapi_* directamente como Authorization: Bearer tapi_...
OAuth 2.1 — utilizado por los conectores de Claude.ai. El servidor implementa registro dinámico de clientes, PKCE, intercambio de tokens y revocación. El endpoint /authorize redirige al sitio principal de TickerDB para obtener el consentimiento.

Desarrollo

# Install dependencies
npm install

# Build the remote worker
npm run build

# Dev server for remote worker
npx wrangler dev

# Build the npm package
cd local && npm install && npm run build

Despliegue

Servidor remoto:

npx wrangler deploy

Paquete npm:

cd local
npm version patch
npm run build
npm publish

TickerAPI