Servidor MCP

Consulta inteligencia de mercados globales en acciones, materias primas, índices, cripto e IA a través de Nebula.

Primeros pasos

Inicio rápidoConecta un cliente HTTP con Streamable HTTP al servidor MCP de Nebula. AutenticaciónConecta tu cuenta de Nebula con OAuth, o usa una API key directamente. Claude CodeAñade Nebula a Claude Code con un solo comando de configuración. Herramientas generadasExplora las herramientas generadas a partir del contrato público de la API.

Inicio rápido

Conecta cualquier cliente MCP con Streamable HTTP a:

https://nebula-api.hiddensystems.ai/mcp

Las herramientas, descripciones, valores predeterminados, restricciones de selectores y esquemas se generan a partir del contrato público de OpenAPI. Usa list_assets para encontrar cualquier acción, materia prima, índice o activo cripto, y luego pasa su asset_id y asset_class a las herramientas posteriores.

Autenticación

Endpointhttps://nebula-api.hiddensystems.ai/mcp
PluginsCódigo de autorización de OAuth 2.1 con PKCE
Clientes directosX-API-Key: YOUR_API_KEY o una API key como Authorization: Bearer
TransporteHTTP con streaming

Los clientes OAuth descubren la autorización desde el endpoint automáticamente. Las llamadas usan el plan, los créditos y los límites de velocidad de la cuenta de Nebula conectada.

Pagos x402

También puedes pagar lecturas de API elegibles con USDC en Base a través de la API HTTP x402 independiente, sin necesidad de una cuenta de Nebula ni de una clave de API. Tu cartera autoriza cada pago. Las conexiones de MCP y CLI siguen usando la autenticación de cuenta y los créditos; no realizan pagos automáticos con cartera. Consulta la guía de pagos x402.

Conecta Claude Code

claude mcp add nebula \
  --transport http \
  https://nebula-api.hiddensystems.ai/mcp

Abre /mcp después de añadir el servidor y completa el flujo de inicio de sesión de Nebula.

Otros clientes MCP

Los clientes compatibles con OAuth pueden usar la URL de Streamable HTTP sin una API key almacenada. Los clientes heredados pueden proporcionar un encabezado de API key.

URL: https://nebula-api.hiddensystems.ai/mcp
Optional legacy header: X-API-Key: YOUR_API_KEY

Descripción general de los endpoints

Cada llamada a una herramienta MCP usa el mismo precio por operación y el mismo saldo de cuenta compartido que la API REST, MCP, el CLI y Nebula Agent.

  • Las operaciones de costo fijo gastan la cantidad de créditos indicada por solicitud.
  • Los parámetros no modifican el coste de una operación, salvo cuando su fila indica un precio para uno de ellos: una previsión de mindshare o de sentimiento reejecutada con refresh=true cuesta 10 créditos en lugar de 5. El sentimiento siempre cuesta 1 crédito, con o sin filtros de clúster.
  • Una fila también puede indicar un precio menor para una respuesta de menor alcance: un pronóstico que el activo no puede tener (not_forecastable) es gratuito, hasta 30 de esas respuestas por cuenta por hora; superado ese límite, el endpoint responde 429 hasta que se reinicie la hora. Una solicitud que termina en error no cuesta nada.
  • Las solicitudes del Agent usan precios variables según el volumen de tokens, el costo del modelo y las llamadas a herramientas. La respuesta completada informa los créditos utilizados.
  • Todas las operaciones están disponibles en todos los planes. Los planes se diferencian por la ventana de historial (Free: 90 días; Pro: el máximo de cada endpoint, un año para la mayoría de las series temporales), el límite de velocidad (Free: 60 solicitudes por minuto; Pro: 300) y los créditos mensuales incluidos; comprar créditos amplía el uso, pero no cambia el historial ni los límites de velocidad.

Descubrimiento

HerramientaCréditosDescripción
screener 2 Screener
get_top_momentum 2 Mayor impulso
get_top_trending 2 Mayor tendencia

Búsqueda

HerramientaCréditosDescripción
list_assets 1 Texto a ID de activo
search 1 Buscar
list_subjects 1 Texto a ID de sujeto

Social & Sentimiento

HerramientaCréditosDescripción
get_emotions 1 Distribución de emociones
get_mindshare 2 Mindshare
get_related_subjects 2 Temas relacionados
get_sentiment 1 Sentimiento
get_sentiment_timeframes 1 Sentimiento por intervalo temporal
get_social_momentum 2 Impulso social

Pronósticos

HerramientaCréditosDescripción
list_forecast_assets 1 Activos predecibles
get_mindshare_forecast 5 (10 con refresh=true; gratis si not_forecastable, 30 por hora) Previsión de mindshare
get_sentiment_forecast 5 (10 con refresh=true; gratis si not_forecastable, 30 por hora) Previsión de sentimiento

Sentimiento de mercado

HerramientaCréditosDescripción
get_calls 2 Llamadas long/short
get_call_returns 2 Distribución de resultados de las llamadas
get_conviction_index 2 Índice de convicción
get_fear_greed_index 1 Índice de miedo y codicia
get_price_levels 2 Niveles de precio mencionados en redes sociales
get_social_volume_index 2 Volumen social frente a volumen de trading
get_social_volume_profile 2 Perfil de volumen social

Datos de mercado

HerramientaCréditosDescripción
get_price_history 1 Historial de precios

Inteligencia

HerramientaCréditosDescripción
list_calendar_events 5 Eventos del calendario
list_insights 5 Inteligencia
get_insight_attention 5 Atención de los insights

Clústeres

HerramientaCréditosDescripción
list_clusters 2 Clústeres de autores
compare_clusters 2 Comparación de clústeres
get_divisive_assets 2 Activos divisivos
compare_hype_cycles 2 Llegadas del ciclo de hype
compare_cluster_traits 2 Comparación de rasgos de clústeres
get_cluster_hype_cycles 2 Ciclos de hype de clústeres
get_cluster_overlap 2 Solapamiento de clústeres
get_cluster_profile 2 Perfil de clúster
get_cluster_rotation 2 Rotación de clústeres
get_cluster_stances 2 Posturas de clústeres

Cuenta

HerramientaCréditosDescripción
get_account 0 Cuenta

Herramientas generadas

Toda operación de datos de OpenAPI habilitada para MCP se convierte en una herramienta. La operación de finalización de chat de Nebula Agent se excluye deliberadamente porque el modelo anfitrión aporta el razonamiento.

compare_cluster_traitsComparación de rasgos de clústeres
compare_clustersComparación de clústeres
compare_hype_cyclesLlegadas del ciclo de hype
get_accountCuenta
get_call_returnsDistribución de resultados de las llamadas
get_callsLlamadas long/short
get_cluster_hype_cyclesCiclos de hype de clústeres
get_cluster_overlapSolapamiento de clústeres
get_cluster_profilePerfil de clúster
get_cluster_rotationRotación de clústeres
get_cluster_stancesPosturas de clústeres
get_conviction_indexÍndice de convicción
get_divisive_assetsActivos divisivos
get_emotionsDistribución de emociones
get_fear_greed_indexÍndice de miedo y codicia
get_insight_attentionAtención de los insights
get_mindshareMindshare
get_mindshare_forecastPrevisión de mindshare
get_price_historyHistorial de precios
get_price_levelsNiveles de precio mencionados en redes sociales
get_related_subjectsTemas relacionados
get_sentimentSentimiento
get_sentiment_forecastPrevisión de sentimiento
get_sentiment_timeframesSentimiento por intervalo temporal
get_social_momentumImpulso social
get_social_volume_indexVolumen social frente a volumen de trading
get_social_volume_profilePerfil de volumen social
get_top_momentumMayor impulso
get_top_trendingMayor tendencia
list_assetsTexto a ID de activo
list_calendar_eventsEventos del calendario
list_clustersClústeres de autores
list_forecast_assetsActivos predecibles
list_insightsInteligencia
list_subjectsTexto a ID de sujeto
screenerScreener
searchBuscar

Solución de problemas

  • 401: falta el inicio de sesión o ha caducado, o la API key no es válida o ha sido revocada.
  • 402: los créditos de la cuenta se han agotado para este ciclo.
  • 403: la solicitud supera la ventana de historial del plan.
  • 429: la clave alcanzó su límite de peticiones por minuto; espera el intervalo indicado en Retry-After.
  • 503: una dependencia no estuvo disponible momentáneamente; vuelve a intentar la llamada.
  • Si las herramientas no aparecen, reinicia el cliente después de guardar su configuración de MCP.