MCP Server
Запрашивайте аналитику глобальных рынков по акциям, сырью, индексам, криптовалютам и AI через Nebula.
Быстрый старт
Подключите любой клиент MCP с поддержкой Streamable HTTP к:
https://nebula-api.hiddensystems.ai/mcp
Инструменты, описания, значения по умолчанию, ограничения селекторов и схемы генерируются из публичного контракта OpenAPI. Используйте list_assets для поиска любой акции, сырья, индекса или криптоактива, а затем передавайте его asset_id и asset_class в последующие инструменты.
Аутентификация
| Эндпоинт | https://nebula-api.hiddensystems.ai/mcp |
|---|
| Плагины | OAuth 2.1 authorization code with PKCE |
|---|
| Прямые клиенты | X-API-Key: YOUR_API_KEY или API-ключ в качестве Authorization: Bearer |
|---|
| Транспорт | Streamable HTTP |
|---|
OAuth-клиенты автоматически определяют параметры авторизации по эндпоинту. Вызовы используют тариф, кредиты и лимиты подключённого аккаунта Nebula.
Платежи x402
Вы также можете оплачивать доступные для этого чтения API с помощью USDC в сети Base через отдельный x402 HTTP API — без аккаунта Nebula и ключа API. Каждый платёж авторизуется вашим кошельком. Подключения MCP и CLI по-прежнему используют аутентификацию аккаунта и кредиты; они не выполняют платежи с кошелька автоматически. См. руководство по оплате через x402.
Подключение Claude Code
claude mcp add nebula \
--transport http \
https://nebula-api.hiddensystems.ai/mcp
Откройте /mcp после добавления сервера и завершите вход в Nebula.
Другие клиенты MCP
Клиенты с поддержкой OAuth могут использовать URL Streamable HTTP без сохранённого API-ключа. Устаревшие клиенты могут передавать заголовок с API-ключом.
URL: https://nebula-api.hiddensystems.ai/mcp
Optional legacy header: X-API-Key: YOUR_API_KEY
Обзор эндпоинтов
Каждый вызов инструмента MCP использует то же ценообразование на уровне операции и общий баланс аккаунта, что и REST API, MCP, CLI и Nebula Agent.
- Операции с фиксированной стоимостью расходуют указанное число кредитов за запрос.
- Параметры не влияют на стоимость операции, кроме случаев, когда в её строке указана цена для конкретного параметра: повторный запуск прогноза доли внимания или настроений с refresh=true стоит 10 кредитов вместо 5. Настроения всегда стоят 1 кредит — с фильтрами по кластерам или без них.
- В строке также может быть указана более низкая цена за менее полный ответ: прогноз, который актив не может иметь (not_forecastable), бесплатен — до 30 таких ответов на аккаунт в час; после этого эндпоинт отвечает 429, пока час не истечёт. Запрос, завершившийся ошибкой, не стоит ничего.
- Запросы агента используют переменную цену, зависящую от объёма токенов, стоимости модели и вызовов инструментов. В завершённом ответе указывается число использованных кредитов.
- Каждая операция доступна на любом тарифе. Тарифы различаются окном истории (Free: 90 дней; Pro: максимум для каждого эндпоинта — год для большинства временных рядов), лимитом запросов (Free: 60 запросов в минуту; Pro: 300) и включёнными месячными кредитами; покупка кредитов продлевает использование, но не изменяет историю или лимиты запросов.
Обнаружение
| Инструмент | Кредиты | Описание |
|---|
screener |
2 |
Скринер |
get_top_momentum |
2 |
Топ по моментуму |
get_top_trending |
2 |
Топ по трендам |
Поиск
| Инструмент | Кредиты | Описание |
|---|
list_assets |
1 |
Текст в asset ID |
search |
1 |
Поиск |
list_subjects |
1 |
Текст в subject ID |
Соцсети и настроения
| Инструмент | Кредиты | Описание |
|---|
get_emotions |
1 |
Распределение эмоций |
get_mindshare |
2 |
Доля внимания |
get_related_subjects |
2 |
Связанные субъекты |
get_sentiment |
1 |
Настроения |
get_sentiment_timeframes |
1 |
Сентимент по таймфреймам |
get_social_momentum |
2 |
Социальный импульс |
Прогнозы
| Инструмент | Кредиты | Описание |
|---|
list_forecast_assets |
1 |
Прогнозируемые активы |
get_mindshare_forecast |
5 (10 при refresh=true; бесплатно при not_forecastable, 30 в час) |
Прогноз Mindshare |
get_sentiment_forecast |
5 (10 при refresh=true; бесплатно при not_forecastable, 30 в час) |
Прогноз сентимента |
Настроения рынка
| Инструмент | Кредиты | Описание |
|---|
get_calls |
2 |
Сигналы long/short |
get_call_returns |
2 |
Распределение исходов сигналов |
get_conviction_index |
2 |
Индекс уверенности |
get_fear_greed_index |
1 |
Индекс страха и жадности |
get_price_levels |
2 |
Упоминаемые в соцсетях ценовые уровни |
get_social_volume_index |
2 |
Социальный объём против торгового |
get_social_volume_profile |
2 |
Профиль социального объёма |
Рыночные данные
| Инструмент | Кредиты | Описание |
|---|
get_price_history |
1 |
История цен |
Аналитика
| Инструмент | Кредиты | Описание |
|---|
list_calendar_events |
5 |
События календаря |
list_insights |
5 |
Аналитика |
get_insight_attention |
5 |
Внимание к инсайтам |
Кластеры
| Инструмент | Кредиты | Описание |
|---|
list_clusters |
2 |
Кластеры авторов |
compare_clusters |
2 |
Сравнение кластеров |
get_divisive_assets |
2 |
Спорные активы |
compare_hype_cycles |
2 |
Приходы цикла хайпа |
compare_cluster_traits |
2 |
Сравнение признаков кластеров |
get_cluster_hype_cycles |
2 |
Циклы хайпа кластеров |
get_cluster_overlap |
2 |
Пересечение кластеров |
get_cluster_profile |
2 |
Профиль кластера |
get_cluster_rotation |
2 |
Ротация кластеров |
get_cluster_stances |
2 |
Позиции кластеров |
Аккаунт
| Инструмент | Кредиты | Описание |
|---|
get_account |
0 |
Аккаунт |
Устранение неполадок
- 401: вход не выполнен или истёк, либо API-ключ недействителен или отозван.
- 402: кредиты аккаунта исчерпаны на текущий цикл.
- 403: запрос выходит за пределы окна истории, доступного по вашему тарифу.
- 429: ключ достиг лимита запросов в минуту; дождитесь интервала Retry-After.
- 503: зависимость была временно недоступна; повторите вызов.
- Если инструменты не появились, перезапустите клиент после сохранения его конфигурации MCP.