MCP 서버

Nebula를 통해 주식, 원자재, 지수, 크립토, AI 전반에 걸친 글로벌 시장 인텔리전스를 쿼리하세요.

시작하기

빠른 시작Streamable HTTP 클라이언트를 Nebula MCP 서버에 연결하세요. 인증OAuth로 Nebula 계정을 연결하거나 API 키를 직접 사용하세요. Claude Code구성 명령 하나로 Nebula를 Claude Code에 추가하세요. 생성된 도구공개 API 계약에서 생성된 도구를 살펴보세요.

빠른 시작

모든 Streamable HTTP MCP 클라이언트를 다음에 연결하세요.

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

도구, 설명, 기본값, 선택자 제약 조건, 스키마는 공개 OpenAPI 계약에서 생성됩니다. list_assets를 사용하여 모든 주식, 원자재, 지수 또는 크립토 자산을 찾은 다음, 해당 asset_id와 asset_class를 다운스트림 도구에 전달하세요.

인증

엔드포인트https://nebula-api.hiddensystems.ai/mcp
플러그인PKCE를 사용하는 OAuth 2.1 인증 코드
직접 클라이언트X-API-Key: YOUR_API_KEY 또는 API 키를 Authorization: Bearer로 사용
전송Streamable HTTP

OAuth 클라이언트는 엔드포인트에서 인증 정보를 자동으로 검색합니다. 호출은 연결된 Nebula 계정의 플랜, 크레딧, 속도 제한을 사용합니다.

x402 결제

Nebula 계정이나 API 키 없이 별도의 x402 HTTP API를 통해 Base의 USDC로 적격 API 읽기에 대한 비용을 지불할 수도 있습니다. 각 결제는 지갑에서 승인합니다. MCP와 CLI 연결은 계속 계정 인증과 크레딧을 사용하며, 자동으로 지갑 결제를 수행하지 않습니다. x402 결제 가이드 보기

Claude Code 연결

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

서버를 추가한 후 /mcp를 열고 Nebula 로그인 흐름을 완료하세요.

기타 MCP 클라이언트

OAuth를 지원하는 클라이언트는 저장된 API 키 없이 Streamable HTTP URL을 사용할 수 있습니다. 레거시 클라이언트는 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로 다시 실행하면 5 크레딧 대신 10 크레딧이 부과됩니다. 심리는 클러스터 필터 사용 여부와 관계없이 항상 1 크레딧입니다.
  • 행에 따라 더 낮은 수준의 답변에 더 낮은 가격이 명시될 수도 있습니다. 자산이 가질 수 없는 예측(not_forecastable)은 무료이며, 계정당 시간당 최대 30건까지 허용됩니다. 이를 초과하면 해당 시간이 지날 때까지 엔드포인트가 429를 반환합니다. 오류로 끝난 요청은 비용이 발생하지 않습니다.
  • Agent 요청은 토큰 볼륨, 모델 비용, 도구 호출을 기반으로 한 변동 가격을 사용합니다. 완료된 응답에는 사용된 크레딧이 보고됩니다.
  • 모든 작업은 모든 플랜에서 사용할 수 있습니다. 플랜은 히스토리 기간(Free: 90일, Pro: 각 엔드포인트의 최대치이며 대부분의 시계열은 1년), 속도 제한(Free: 분당 60 요청, Pro: 300), 포함된 월간 크레딧에 따라 다릅니다. 크레딧을 구매하면 사용량을 늘릴 수 있지만 히스토리나 속도 제한은 변경되지 않습니다.

디스커버리

도구크레딧설명
screener 2 스크리너
get_top_momentum 2 상위 모멘텀
get_top_trending 2 상위 트렌딩

조회

도구크레딧설명
list_assets 1 텍스트 → 자산 ID
search 1 검색
list_subjects 1 텍스트 → 주체 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회, not_forecastable이면 무료, 시간당 30회) 마인드셰어 예측
get_sentiment_forecast 5회(새로 고침 시 10회, not_forecastable이면 무료, 시간당 30회) 심리 예측

시장 센티먼트

도구크레딧설명
get_calls 2 롱/숏 콜
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 클러스터 입장

Account

도구크레딧설명
get_account 0 Account

생성된 도구

MCP가 활성화된 모든 OpenAPI 데이터 작업이 도구가 됩니다. Nebula Agent 채팅 완료 작업은 호스트 모델이 추론을 제공하므로 의도적으로 제외됩니다.

compare_cluster_traits클러스터 특성 비교
compare_clusters클러스터 비교
compare_hype_cycles하이프 사이클 도달
get_accountAccount
get_call_returns콜 결과 분포
get_calls롱/숏 콜
get_cluster_hype_cycles클러스터 하이프 사이클
get_cluster_overlap클러스터 중첩
get_cluster_profile클러스터 프로필
get_cluster_rotation클러스터 로테이션
get_cluster_stances클러스터 입장
get_conviction_index확신 지수
get_divisive_assets논쟁적인 자산
get_emotions감정 분포
get_fear_greed_index공포와 탐욕 지수
get_insight_attention인사이트 주목도
get_mindshare마인드셰어
get_mindshare_forecast마인드셰어 예측
get_price_history가격 이력
get_price_levels소셜 언급 가격대
get_related_subjects관련 주제
get_sentiment센티먼트
get_sentiment_forecast심리 예측
get_sentiment_timeframes시간대별 심리
get_social_momentum소셜 모멘텀
get_social_volume_index소셜 대비 거래량
get_social_volume_profile소셜 거래량 프로필
get_top_momentum상위 모멘텀
get_top_trending상위 트렌딩
list_assets텍스트 → 자산 ID
list_calendar_events캘린더 이벤트
list_clusters작성자 클러스터
list_forecast_assets예측 가능 자산
list_insights인텔리전스
list_subjects텍스트 → 주체 ID
screener스크리너
search검색

문제 해결

  • 401: 로그인이 누락되었거나 만료되었거나, API 키가 유효하지 않거나 폐기되었습니다.
  • 402: 이번 주기의 계정 크레딧이 모두 소진되었습니다.
  • 403: 요청이 플랜의 히스토리 윈도우를 벗어났습니다.
  • 429: 키가 분당 요청 한도에 도달했습니다. Retry-After 간격만큼 기다리세요.
  • 503: 의존 서비스가 잠시 사용할 수 없는 상태였습니다. 호출을 재시도하세요.
  • 도구가 나타나지 않으면 MCP 구성을 저장한 뒤 클라이언트를 다시 시작하세요.