MCP를 통해 연결

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

Narwhal은 상태를 저장하지 않는 Streamable HTTP MCP 엔드포인트 하나를 제공합니다. REST와 동일한 6개 데이터 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 읽기 전용 도구 33개를 반환합니다: Economics 작업 18개와 FX, Equities, SEC 신고서, Palmoil 및 Calendars 각각 3개입니다.

economics_get_cpieconomics_get_inflationeconomics_get_unemploymenteconomics_get_labour_force_participationeconomics_get_gdpeconomics_get_gdp_growtheconomics_get_tradeeconomics_get_trade_exportseconomics_get_trade_importseconomics_get_cpi_historyeconomics_get_inflation_historyeconomics_get_unemployment_historyeconomics_get_labour_force_participation_historyeconomics_get_gdp_historyeconomics_get_gdp_growth_historyeconomics_get_trade_historyeconomics_get_trade_exports_historyeconomics_get_trade_imports_historyfx_get_ratesfx_get_rate_historyfx_convert_currencyequities_list_instrumentsequities_get_instrumentequities_get_barscompanies_searchcompanies_getcompanies_list_filingscommodities_discover_physical_seriescommodities_get_oil_palm_ffb_pricecommodities_get_oil_palm_ffb_price_observationscalendars_list_holidayscalendars_get_holidays_on_datecalendars_get_next_holiday

인수와 결과

최신 발표 도구는 다음을 허용합니다 country 및 선택적 period 이력 도구는 다음을 허용합니다: country, 선택 사항 start 및 end, 추가로 limit 및 cursor 페이지 매김에 대해.

도구 인수

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

양방향 무역 도구 2개에서 MCP는 다음을 사용합니다 "product": { "classification": "HS2022", "code": "27" } REST는 동일한 필터를 다음과 같은 별도 항목으로 나타냅니다: classification 및 product 쿼리 매개변수입니다.

도구	기간	기타 인수
`economics_get_cpi`	`YYYY-MM`	없음
`economics_get_inflation`	`YYYY-MM`	없음
`economics_get_unemployment`	`YYYY, YYYY-MM, or YYYY-QN`	없음
`economics_get_labour_force_participation`	`YYYY, YYYY-MM, or YYYY-QN`	없음
`economics_get_gdp`	`YYYY-QN`	없음
`economics_get_gdp_growth`	`YYYY-QN`	없음
`economics_get_trade`	`YYYY or YYYY-MM`	없음
`economics_get_trade_exports`	`YYYY or YYYY-MM`	`partner` 및 중첩된 `product` 허용되지만 필터 합계는 아직 게시되지 않았습니다.
`economics_get_trade_imports`	`YYYY or YYYY-MM`	`partner` 및 중첩된 `product` 허용되지만 필터 합계는 아직 게시되지 않았습니다.
`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`
`economics_get_trade_exports_history`	`YYYY-MM`	`start`, `end`, `limit`, 및 `cursor`
`economics_get_trade_imports_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 베타에는 다음이 포함됩니다 3,000 UTC 월간 성공 요청 수와 다음 30 분당 요청 수와 버스트 5 할당량 상태는 다음에 반환됩니다: 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를 읽습니다. 다음을 확인하세요 오류 및 할당량.