FRED — 연방준비은행 경제 데이터

세인트루이스 연방준비은행의 데이터 웨어하우스: 금리, 인플레이션, 고용, GDP, 통화량, 환율, 대도시 지표를 아우르는 80만 개 이상의 경제 시계열 데이터. 미국 거시경제 및 통화 데이터의 가장 권위 있고 지속적으로 업데이트되는 소스로, 경제학자, 정책 입안자, 언론인들이 사용합니다.

Pipeworx의 일부 — AI 에이전트를 1476개 이상의 실시간 데이터 소스에 연결하는 MCP 게이트웨이입니다.

AI 에이전트에게 중요한 이유

대부분의 "현재 X는 무엇인가"라는 거시경제 질문은 FRED 시리즈로 해결됩니다. 시리즈 ID를 아는 에이전트는 훈련 데이터 스냅샷이 아닌 실제 현재 값을 답할 수 있습니다. 일반적인 예는 다음과 같습니다:

• 30년 모기지 금리 → MORTGAGE30US

• 연방기금금리 → DFF

• CPI (전체 품목) → CPIAUCSL

• 실업률 → UNRATE

• 10년 만기 국채 수익률 → DGS10

• 주택 착공 → HOUST

• Case-Shiller 주택 가격 지수 → CSUSHPISA

에이전트가 미국 거시경제 상태에 대한 질문에 답하는 경우, 올바른 패턴은 fred_search(올바른 시리즈 찾기) → fred_series_info(단위와 빈도 확인) → fred_get_series(값 가져오기)입니다.

Related MCP server: FRED Economic MCP Server

인증

FRED는 API 키가 필요합니다. https://fred.stlouisfed.org/docs/api/api_key.html에서 무료로 받을 수 있습니다 — 30초면 충분하며, 결제도 없고, 요금 제한에 대한 걱정도 없습니다.

호출마다 _apiKey로 전달하세요:

fred_get_series({
  series_id: "MORTGAGE30US",
  _apiKey: "your-fred-api-key"
})

또는 키를 관리해 주는 Housing Vertical을 구독하세요.

업데이트 주기

Pipeworx는 이러한 주기에 맞는 TTL로 FRED 응답을 캐시합니다 — 캐싱 및 신선도를 참조하세요.

인용 가능한 URI

안정적인 인용을 위해 출력에 포함하세요:

pipeworx://fred/series/{series_id}
pipeworx://fred/series/{series_id}/observations

다른 에이전트(및 resources/read)는 이를 시리즈의 현재 값으로 해석할 수 있습니다.

일반적인 함정

• 빈티지(Vintages): FRED는 과거 "빈티지"(시간 T에 보고된 데이터)를 보존합니다. 기본 도구 호출은 최신 수정된 시리즈를 가져옵니다. 특정 시점 기준 쿼리를 위해 realtime_start 및 realtime_end를 전달하세요.

• 빈도 집계: frequency 매개변수는 다른 주기(예: 일일 → 월간 평균)로 강제 변환합니다. 기본값은 시리즈의 고유 빈도입니다.

• 단위 변환: units 매개변수는 요청 시 파생 시리즈를 계산합니다(pch는 백분율 변화, pca는 복합 연율 등). 클라이언트 측에서 계산하지 말고 FRED가 처리하도록 하세요.

• 시리즈 이름 변경: 때때로 연방준비제도가 시리즈를 폐기하고 후속 시리즈를 만듭니다. 이전 ID는 오류를 반환합니다. fred_search가 복구 경로입니다.

빠른 시작

MCP 클라이언트(Claude Desktop, Cursor, Windsurf 등)에 추가하세요:

{
  "mcpServers": {
    "fred": {
      "url": "https://gateway.pipeworx.io/fred/mcp"
    }
  }
}

이 엔드포인트가 실제로 제공하는 것

https://gateway.pipeworx.io/fred/mcp의 tools/list는 위 표의 도구 및 공유 Pipeworx 메타 도구 — ask_pipeworx, discover_tools, search_within, remember/recall 및 게이트웨이 전체 세트의 나머지 — 를 반환합니다. 따라서 표시되는 도구 수는 이 표보다 많습니다. 단일 팩 엔드포인트는 현재 팩 자체 도구와 함께 약 30개의 공유 도구를 나열합니다. 연결의 initialize 응답은 정확한 범위를 명시하며, 특정 날짜에 대한 권위 있는 답변입니다.

이는 의도적인 것이지 우연한 멀티플렉싱이 아닙니다. 메타 도구는 범위가 지정된 연결이 이 팩이 다루지 않는 질문에 답할 수 있게 해줍니다 — 전체 카탈로그를 라우팅하는 ask_pipeworx를 통해 — 두 번째 MCP 서버를 추가하지 않고도 말입니다. 현재 이들 없이 팩 엔드포인트를 마운트할 방법은 없습니다. 추가 스키마가 라우팅 가치보다 더 많은 컨텍스트를 소비한다면, 여러 팩 엔드포인트에 연결하는 대신 전체 게이트웨이에 한 번 연결하세요.

또는 전체 Pipeworx 게이트웨이에 연결하여 이 팩의 도구뿐만 아니라 모든 팩의 도구를 직접 나열할 수 있습니다:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

두 URL 모두 동일한 게이트웨이와 동일한 1476개 이상의 데이터 소스에 도달합니다. 유일한 차이점은 어떤 팩의 도구가 직접 나열되는지입니다. ask_pipeworx는 어느 쪽에서든 모든 도구에 도달할 수 있습니다.

ask_pipeworx와 함께 사용하기

도구를 직접 호출하는 대신 일반 영어로 질문할 수 있습니다 — 이는 위의 팩 엔드포인트와 전체 게이트웨이 모두에서 작동합니다:

ask_pipeworx({ question: "your question about Fred data" })

게이트웨이가 올바른 도구를 선택하고 인수를 자동으로 채웁니다.

더 보기

• 문서 및 가이드

• pipeworx.io

라이선스

MIT