MCP를 통해 연결

MCP 클라이언트에서 동일한 Narwhal 키와 공개 API 스키마를 사용하세요.

Narwhal은 상태를 유지하지 않는 Streamable HTTP MCP 엔드포인트 하나를 제공합니다. REST와 동일하게 활성화된 데이터 API, 응답 스키마, 인증 및 할당량을 사용합니다.

연결

원격 서버 URL과 Bearer 헤더를 인증된 Streamable HTTP를 지원하는 MCP 클라이언트에 추가하십시오.

클라이언트 중립 필드 맵

{
  "url": "https://api.narwhalapi.com/mcp",
  "headers": {
    "Authorization": "Bearer YOUR_NARWHAL_API_KEY"
  }
}

이 예시는 필드 구성을 보여주며, 그대로 복사해 사용하는 파일이 아닙니다. 바꿀 자리 표시자: YOUR_NARWHAL_API_KEY —클라이언트의 안전한 시크릿 설정에서 바꾸세요. JSON은 셸 변수를 자체적으로 확장하지 않으며 MCP 클라이언트마다 환경 변수 문법이 다릅니다.

실제 키를 공유 설정 파일에 붙여 넣지 마세요.

사용 가능한 도구

tools/list 이 릴리스 프로필에서 활성화된 공개 읽기 전용 도구를 반환합니다. 아래 카탈로그는 공개 도구 집합이며 모든 입력에 대해 모든 출처가 값을 제공한다는 보장은 아닙니다.

economics_get_cpieconomics_get_inflationeconomics_get_unemploymenteconomics_get_labour_force_participationeconomics_get_gdpeconomics_get_gdp_growtheconomics_get_tradeeconomics_get_cpi_historyeconomics_get_inflation_historyeconomics_get_unemployment_historyeconomics_get_labour_force_participation_historyeconomics_get_gdp_historyeconomics_get_gdp_growth_historyeconomics_get_trade_historyeconomics_read_series_observationsfx_get_ratesfx_get_rate_historyfx_convert_currencyfx_get_rate_barscommodities_get_spot_pricecommodities_get_price_historycommodities_list_palmoil_physical_seriescommodities_get_palmoil_physical_pricecommodities_get_palmoil_physical_observationscommodities_list_physical_seriescommodities_get_physical_seriescommodities_get_physical_latestcommodities_get_physical_observationseconomics_list_releaseseconomics_get_releaseevents_listevents_getpredictions_list_topicspredictions_get_topicpredictions_list_eventspredictions_get_scalarpredictions_get_extremepredictions_get_timingpredictions_get_binarypredictions_get_scalar_historypredictions_get_extreme_historypredictions_get_timing_historypredictions_get_binary_historypredictions_get_policy_pathpredictions_get_policy_path_historycalendars_list_holidayscalendars_get_holidays_on_datecalendars_get_next_holidayeconomics_get_yield_curveeconomics_get_yield_curve_history

인수와 결과

최신 발표 도구의 인수: country, 선택 사항 period 및 선택적 version_id. 과거 데이터 도구의 인수: country, 선택 사항 start 및 end, 추가로 limit 및 cursor (페이지 매김용).

도구 인수

{
  "country": "USA",
  "period": "2026-07"
}

도구	기간	기타 인수
`economics_get_cpi`	`YYYY-MM`	`version_id`
`economics_get_inflation`	`YYYY-MM`	`version_id`
`economics_get_unemployment`	`YYYY, YYYY-MM, or YYYY-QN`	`version_id`
`economics_get_labour_force_participation`	`YYYY, YYYY-MM, or YYYY-QN`	`version_id`
`economics_get_gdp`	`YYYY-QN`	`version_id`
`economics_get_gdp_growth`	`YYYY-QN`	`version_id`
`economics_get_trade`	`YYYY or YYYY-MM`	`version_id`
`economics_get_cpi_history`	`YYYY-MM`	`start`, `end`, `limit`, 및 `cursor`
`economics_get_inflation_history`	`YYYY-MM`	`start`, `end`, `limit`, 및 `cursor`
`economics_get_unemployment_history`	`YYYY, YYYY-MM, or YYYY-QN`	`start`, `end`, `limit`, 및 `cursor`
`economics_get_labour_force_participation_history`	`YYYY, YYYY-MM, or YYYY-QN`	`start`, `end`, `limit`, 및 `cursor`
`economics_get_gdp_history`	`YYYY-QN`	`start`, `end`, `limit`, 및 `cursor`
`economics_get_gdp_growth_history`	`YYYY-QN`	`start`, `end`, `limit`, 및 `cursor`
`economics_get_trade_history`	`YYYY-MM`	`start`, `end`, `limit`, 및 `cursor`

성공한 도구 호출이 반환하는 스키마에 맞는 필드: structuredContent 및 클라이언트 호환성을 위해 동일한 JSON을 텍스트로 직렬화한 값입니다. MCP 문제는 REST와 동일한 공개 상태 및 코드 용어를 사용합니다.

할당량 동작

초기화와 도구 검색은 데이터 할당량을 소비하지 않습니다. 성공한 각 tools/call 호출은 성공한 REST 호출 하나와 마찬가지로 요청 1회를 정확히 소비합니다.

첫 tools/call

{
  "method": "tools/call",
  "params": {
    "name": "fx_get_rates",
    "arguments": { "base": "USD", "currencies": ["EUR", "JPY"] }
  }
}

Free 베타 한도: 5,000 건의 성공 요청(UTC 기준 월간)과 분당 30건의 요청. 할당량 상태를 반환하는 헤더: X-RateLimit-Limit, X-RateLimit-Remaining, 및 X-RateLimit-Reset; 단기 구간 상태는 다음에 반환됩니다: X-RateLimit-Short-Limit, X-RateLimit-Short-Remaining, 및 X-RateLimit-Short-Reset. 단기 구간 한도 초과 시 반환하는 오류: 429 rate_limit_exceeded; 월간 소진은 다음을 반환합니다: 429 quota_exhausted.

문제 해결

증상	확인
`401 invalid_api_key`	정확한 Bearer 헤더와 키가 아직 활성 상태인지 확인하세요.
연결이 리디렉션을 따릅니다	정확히 사용하세요 `https://api.narwhalapi.com/mcp` —끝에 슬래시를 붙이지 마세요.
도구가 없습니다	위에 나열된 공개 도구만 이용할 수 있습니다.
도구가 문제를 반환합니다	구조화된 상태, 코드, 세부 정보 및 요청 ID를 확인하세요. 참고 문서: 오류 및 할당량.