Gloom MCP
Servidor MCP alojado de Gloom, el terminal de código abierto estilo Bloomberg. Cotizaciones, estados financieros, opciones, presentaciones ante la SEC, macro y noticias para Claude, ChatGPT, Cursor y Codex.
Servidor MCP alojado
npx add-mcp 'https://api.gloom.sh/mcp'Se instala en Claude Code, Codex, Cursor y más
Documentación
Qué es
Gloom Cloud aloja un servidor de Model Context Protocol en https://api.gloom.sh/mcp. Expone las herramientas de investigación que usa el propio asistente de Gloom: cotizaciones, historial, finanzas, tenedores, investigación de analistas, opciones, presentaciones ante la SEC e información privilegiada, macro, operaciones del Congreso, interés corto, flujo de opciones, el cable de noticias, el diagnóstico de acciones y datos de contratación. Con el acceso adecuado también llega a tus notas, tus equipos y las listas de seguimiento y carteras de los equipos.
Nada se ejecuta en tu máquina. Es parte de Gloom Pro.
Úsalo cuando un agente necesite los datos de Gloom. Usa la API remota para controlar un escritorio o TUI en ejecución, y la CLI para informes puntuales desde una terminal.
Conectar
Inicia sesión desde el cliente. Los clientes OAuth (Claude Code, claude.ai, Cursor, la mayoría de los clientes MCP recientes) solo necesitan el endpoint. La primera llamada abre una pestaña del navegador donde inicias sesión y eliges a qué puede acceder el cliente.
claude mcp add --transport http gloom https://api.gloom.sh/mcp
Usa una clave. Para scripts, trabajos cron y clientes que no pueden abrir un navegador, crea una clave en Configuración de Cloud, Agentes y envíala como token de portador (x-api-key también funciona). Las claves se muestran una sola vez; crea una por agente, hasta 10.
claude mcp add --transport http gloom https://api.gloom.sh/mcp \
--header "Authorization: Bearer gloom_mcp_..."
export GLOOM_MCP_KEY=gloom_mcp_...
codex mcp add gloom --url https://api.gloom.sh/mcp --bearer-token-env-var GLOOM_MCP_KEY
{
"mcpServers": {
"gloom": {
"url": "https://api.gloom.sh/mcp",
"headers": { "Authorization": "Bearer gloom_mcp_..." }
}
}
}
El transporte es Streamable HTTP, sin estado: una respuesta JSON por POST, GET y DELETE responden a 405. El servidor de autorización es https://api.gloom.sh/auth con descubrimiento estándar, registro dinámico de clientes y PKCE; los clientes que solicitan offline_access obtienen un token de actualización. Los tokens de acceso duran dos horas.
Acceso
| Acceso | Alcanza |
|---|---|
| Datos de mercado | Herramientas de mercado, empresa, presentaciones, macro y noticias |
| Lectura | Además teams.list, notes.list, notes.get, collections.list, collections.get |
| Lectura y escritura | Además notes.save, collections.add_symbol, collections.remove_symbol |
Las claves llevan su acceso y un pin de equipo opcional; una clave fijada ve un solo equipo y puede omitir teamId. Los clientes con sesión iniciada obtienen los mismos niveles a través de los alcances mcp:read y mcp:write, que puedes desmarcar en la pantalla de consentimiento. tools/list solo devuelve lo que el llamador puede invocar. Las notas personales son siempre del propietario de la cuenta.
Herramientas
Cada herramienta es de solo lectura salvo que se indique como escritura, valida sus argumentos y limita su resultado a 256 KB. limit limita las filas de origen antes del tope.
| Herramienta | Argumentos |
|---|---|
market.search | query, limit |
market.quotes | symbols, exchange?, limit |
market.history | symbol, exchange?, interval, startDate?, endDate?, limit |
market.screener | category, limit |
market.options_chain | symbol, exchange?, expiration?, limit |
market.short_interest | symbol, years, limit |
market.options_flow | limit, symbol?, days?, minPremium? (cualquier filtro busca impresiones registradas en lugar de la cinta en vivo) |
company.profile, company.financials, company.holders, company.analyst_research, company.corporate_actions | symbol, exchange?, limit |
company.statements | symbol, exchange?, period, limit |
sec.filings | ticker, offset, limit |
sec.insider_transactions | ticker, limit |
macro.calendar, macro.yield_curve | limit |
macro.series | seriesId, startDate?, endDate?, limit |
congress.house_trades | year?, member?, ticker?, side?, owner?, assetType?, minAmount?, limit |
congress.senate_trades | year?, member?, ticker?, side?, owner?, assetType?, minAmount?, limit |
news.stories | query?, feed, tickers, topics, limit |
equity.diagnostic | symbol, exchange?, mode, limit |
company.hiring | ticker, roles |
market.hiring_movers | limit |
teams.list | limit |
notes.list | scope (user o team), teamId?, kind? (ticker o quick), limit |
notes.get | id |
notes.save (escritura) | scope, teamId?, kind, key, title?, content, expectedRevision? |
collections.list | teamId?, limit |
collections.get | teamId?, collectionId, limit |
collections.add_symbol (escritura) | teamId?, collectionId, symbol, exchange?, quantity?, note? |
collections.remove_symbol (escritura) | teamId?, collectionId, symbol, exchange? |
tools/list incluye el esquema JSON completo con enums y valores predeterminados. Comienza con market.search cuando un ticker sea ambiguo.
Las notas están asociadas a una clave: una nota de ticker por símbolo, una nota rápida por cualquier nombre corto. notes.save reemplaza toda la nota, así que lee primero y pasa expectedRevision; una edición más reciente devuelve revision_conflict en lugar de sobrescribir. Las escrituras llegan inmediatamente a la terminal de cada miembro del equipo. quantity se aplica solo a carteras.
Interactive Brokers
Conecta Interactive Brokers en Gloom y cada cliente con acceso de lectura también obtiene las herramientas propias de IBKR como ibkr.*: posiciones, saldos, rendimiento, operaciones, órdenes, búsqueda de contratos, precios, alertas y listas de seguimiento. IBKR mantiene una conexión por usuario, así que Gloom la mantiene y tu agente llega a IBKR a través de Gloom en lugar de conectarse por su cuenta.
El acceso de lectura ve las herramientas de lectura de IBKR. El acceso de lectura y escritura también ve sus herramientas de escritura, incluida ibkr.create_order_instruction, cuando IBKR se conectó con instrucciones de trading habilitadas. Una instrucción de orden no es una orden: IBKR devuelve un enlace donde la revisas y la envías tú mismo.
Resultados
Cada llamada devuelve texto más structuredContent con los mismos campos:
| Campo | Significado |
|---|---|
status | ok, partial (un límite o el tope eliminó filas), o error |
shape | rows, bundle, series o snapshot, nombrando la clave de colección en data |
rowCount, truncated, asOf | Tamaño, si se descartaron filas, marca de tiempo más reciente de la fuente |
data | rows, sections[].rows, series[].points o items |
Una fuente fallida devuelve status: "error" con data.error = { code, source, reason }, marcado como error de herramienta.
Planes y límites
Crear claves requiere Pro. Cualquier clave o token válido puede initialize y tools/list; las llamadas a herramientas necesitan Pro y obtienen cotizaciones en tiempo real y el cable de noticias en vivo. Las claves permiten 120 solicitudes por minuto y 5,000 por día; las cuentas con sesión iniciada comparten el límite por minuto. Cada POST cuenta. Superar el límite significa 429 con Retry-After. Si Pro caduca, las claves y conexiones permanecen, pero las llamadas a herramientas se rechazan hasta que se restablezca.
Seguridad
Las claves se almacenan con hash y se muestran una sola vez; el acceso y el pin de equipo se fijan en la creación. Revocar una clave se aplica en la siguiente solicitud. Desconectar un cliente revoca su token de actualización de inmediato; un token que ya posee caduca en dos horas. Los tokens están vinculados al servidor MCP como audiencia. Una clave de datos de mercado no puede ver notas, equipos, diseños o carteras; el acceso de escritura cambia notas y elementos de colección y nada más.
Los resultados del Congreso incluyen agregados de ticker y miembro sobre la ventana de presentaciones filtrada, retornos de precios de acciones desde la transacción y el cierre de la presentación, tasa de aciertos de compra y contexto de partido/ comité actual coincidente. Los precios faltantes permanecen nulos; estos retornos retrospectivos no son retornos de ejecución o cartera. Consulta Divulgaciones del Congreso para la base y la fuente pública de miembros.
Las herramientas del servidor sec.thirteenf_holders y sec.thirteenf_crowding exponen posiciones públicas de 13F de fin de trimestre, pesos de fondos reportados, nuevas posiciones, salidas y aglomeración en una muestra clasificada. Ambas devuelven metadatos de cobertura y advertencias de fuente; la herramienta de tenedores acepta un desplazamiento para paginar fondos.
sec.thirteenf_crowding acepta rank: "new" | "exits" | "increases" | "decreases", aplicado antes del truncamiento de filas, por lo que las búsquedas de salidas o cambios de peso cubren la muestra completa de fondos clasificados.