Central Bank Rates MCP Server
중앙은행 환율 MCP 서버 — @allratestoday/central-bank-mcp
컴플라이언스, 세무, 회계에서 실제로 요구하는 공식 환율을 AI 어시스턴트에 제공하세요. Claude Code, Cursor, Claude Desktop, Windsurf 및 모든 MCP 호환 클라이언트가 AllRatesToday API를 통해 ECB, Fed, Bank of Japan, HMRC, US Treasury 등 60개 이상의 기관이 발표한 중앙은행 및 세무당국 환율을 조회할 수 있게 해주는 Model Context Protocol 서버입니다.
설치 후 어시스턴트는 다음과 같은 질문에 답할 수 있습니다:
"오늘 ECB 공식 USD/EUR 환율은 얼마인가요?"
"이번 3월 인보이스에 사용해야 할 HMRC 환율은 무엇인가요?"
"1분기 매일의 Bank of Japan 공식 환율을 보여주세요."
"공식 USD/LKR 환율을 발표하는 모든 중앙은행의 값을 비교해 주세요."
⚖️ 공식 환율 vs 시장 중간 환율
이 서버가 반환하는 모든 값은 공식 발표 환율입니다. 기관이 발표하는 즉시 확정되고 해당 기관의 발표일을 담고 있습니다 — 세무당국, 감사인, 관세 당국이 요구하는 바로 그 숫자입니다. 실시간 시장 환율이 아닙니다. 실시간 시장 중간 환율(가격 표시, 환전, 시장을 추적해야 하는 모든 용도)이 필요하다면 함께 제공되는 서버 @allratestoday/mcp-server를 사용하세요. 두 환율은 수 퍼센트까지 차이가 날 수 있으므로 용도에 맞게 선택하세요. 방법론: allratestoday.com/official-rates-methodology.
Related MCP server: plinth-fx-mcp
🚀 왜 이 서버인가?
🏛️ 60개 이상의 공식 소스 — 중앙은행(ECB, Fed, BOJ, SNB, RBI, …)과 세무당국(HMRC, US Treasury, …)을 각 기관이 발표한 자체 테이블로 제공합니다
📅 시점 정확성 — 임의의 날짜를 요청할 수 있습니다. 주말과 공휴일은 법적으로 효력이 있는 환율로 소급되며, 응답에는 적용된 발표일이 명시됩니다
📊 은행 간 비교 — 한 번의 호출로 통화쌍에 대한 모든 기관의 환율을 최소/최대/중앙값 및 스프레드 통계와 함께 반환합니다
🧮 정직한 파생 — 은행이 직접 발표하지 않는 통화쌍은 해당 은행 자체 테이블 내에서만 교차 계산되어
derived로 표시됩니다. 서로 다른 은행을 혼합하지 않습니다🧰 5가지 핵심 도구 — 인터페이스가 작아 모델이 올바르게 사용하기 쉽습니다
🔌 MCP가 동작하는 모든 곳에서 사용 가능 — stdio 전송, MCP 1.x. Claude Code, Cursor, Claude Desktop, Windsurf 또는 모든 범용 호스트
🔑 API 키 받기
서버는 유효한 ALLRATES_API_KEY 없이는 시작되지 않습니다. 무료 키는 최신 발표 테이블을 지원합니다 — 신용카드가 필요 없습니다. 특정 날짜의 테이블과 이력은 유료 플랜이 필요합니다.
allratestoday.com/register에서 등록 — 30초면 충분합니다
이메일을 인증하세요
대시보드에서 키를 복사하세요 (형식:
art_live_xxxxx)아래 구성에서
ALLRATES_API_KEY로 사용하세요
📦 설치
# Run without installing (recommended)
npx -y @allratestoday/central-bank-mcp# Or install globally
npm install -g @allratestoday/central-bank-mcp
central-bank-mcp두 명령 모두 stdio MCP 서버를 시작하고 클라이언트의 연결을 기다립니다 — MCP 클라이언트가 이 서버를 하위 프로세스로 실행합니다.
🏁 클라이언트별 빠른 설정
Claude Code
claude mcp add central-bank-rates -- npx -y @allratestoday/central-bank-mcp
claude mcp env central-bank-rates ALLRATES_API_KEY=art_live_xxxxxClaude Code를 재시작하세요. *"어떤 중앙은행의 공식 환율을 조회할 수 있나요?"*라고 물어 확인해 보세요.
Cursor
~/.cursor/mcp.json(또는 프로젝트 내 .cursor/mcp.json)을 편집하세요:
{
"mcpServers": {
"central-bank-rates": {
"command": "npx",
"args": ["-y", "@allratestoday/central-bank-mcp"],
"env": {
"ALLRATES_API_KEY": "art_live_xxxxx"
}
}
}
}Claude Desktop
claude_desktop_config.json(설정 → 개발자 → 구성 편집)을 편집하고 위의 Cursor 예제와 동일한 mcpServers 블록을 추가한 다음 Claude Desktop을 재시작하세요.
🧰 도구
도구 | 기능 | 플랜 |
| 코드, 메타데이터, 최신 날짜를 포함한 모든 대상 기관 | 무료 |
| 은행의 발표 테이블(또는 단일 통화쌍), 최신 또는 지정 날짜 기준 | 무료(최신) / 유료(날짜 지정) |
| 단일 통화쌍의 날짜별 공식 시계열 | 유료, 적용 월당 약 1회 호출 청구 |
| 모든 은행에 걸친 단일 통화쌍 비교, 스프레드 통계 포함 | 무료 |
| 은행이 실제로 발표한 날짜(값 없음) | 무료 |
🔒 개인정보 보호
allratestoday.com에는 요청 매개변수와 API 키만 전달됩니다 — 대화 콘텍스트는 절대 전송되지 않습니다.
📚 AllRatesToday의 다른 서비스
@allratestoday/mcp-server— 실시간 시장 중간 환율 MCP 서버
라이선스
MIT © AllRatesToday
Available Tools
6 toolscompare_official_ratesCompare one pair across every bankARead-only
Use this when the user wants one currency pair across ALL institutions at once — 'what does each central bank say USD/EUR is?', 'spread between official USD/LKR rates', 'which bank has the highest official rate for X?'. One call returns every covered bank's latest official rate for the pair plus spread stats { min, max, median, spread_bps } over fresh sources (stale quarterly publishers are returned but excluded from stats). Rates a bank doesn't publish directly are cross-computed within that bank's own table only — banks are never mixed. Methodology: https://allratestoday.com/official-rates-methodology/
Inputs: source (required), target (required).
get_official_rate_historyGet a bank's official rate historyARead-only
Use this for a date-by-date series of one bank's OFFICIAL rates — 'ECB USD rate for every day of 2025', 'how did the CBSL official rate move last quarter'. Returns one row per published date: { series: [{ date, rate, rate_type, derived, method }] }. Give either symbol (matches either side of the pair vs the bank's home currency) or a source+target pair. Defaults to the last year when from/to omitted. Paid plans only, and BILLED BY VOLUME: one API call per month of history covered (a year-long series costs ~12 calls) — keep ranges as narrow as the question needs. For publication dates without values (free) use get_publication_calendar.
Inputs: bank (required), to, from, source, +2 more.
get_official_ratesGet a bank's official published ratesARead-only
Use this for OFFICIAL rates a specific institution published — 'what is the ECB rate for USD?', 'Bank of Japan official rate on 2026-03-14', 'HMRC rate for invoicing'. These are the fixed rates in force for compliance, tax, customs, and accounting — NOT live market rates. Omit date for the newest published table; give date (paid plans) for the table in force on that day (weekends/holidays roll back to the last published date — the response's rate_date says which). Omit source/target for the bank's full table { rates: [{ base, quote, type, value }] }; give both for one pair — with an API key, pairs not directly published are cross-computed via the bank's own home currency and flagged derived; keyless serves only published pairs and their inverses. For live mid-market rates use the @allratestoday/mcp-server package instead.
Inputs: bank (required), date, source, target.
get_publication_calendarGet a bank's publication calendarARead-only
Use this to see WHICH dates a bank actually published a rate table — 'did the ECB publish on 2026-01-01?', 'how often does the US Treasury publish?'. Returns dates only, no rate values, so it is available on every plan (unlike history). Gaps reveal weekends, holidays, and weekly/quarterly publication cadence. Give ?year=YYYY or a from/to range; large ranges are capped and flagged truncated.
Inputs: bank (required), to, from, year.
list_central_banksList covered central banks & tax authoritiesARead-only
Call this FIRST when you need a bank code, or when the user asks 'which central banks do you cover?' or 'do you have rates from X?'. Returns { banks: [{ code, name, country, home_ccy, rate_types, latest date, ... }], disclaimer } for 130+ central banks and tax authorities (plus a composite) — central banks (ECB, Fed, BOJ, ...) plus tax authorities (HMRC, US Treasury, ...). The code field is what every other tool takes as its bank parameter. Cheap to call.
Inputs: no named parameters.
request_trial_keyRequest a trial API keyA
Self-issue an AllRatesToday API key with 100 lifetime calls, valid 7 days, with no account and no email. Use it when another tool answered "needs an API key" and the user wants a dated central-bank table, a history series, a cross-bank comparison or a publication calendar right now. The key is adopted by this server for the rest of the session and returned once — tell the user to put it in the MCP config as ALLRATES_API_KEY to keep it. Capped at 3 keys per IP per day. For a lasting key, register at https://allratestoday.com/register (free) or see https://allratestoday.com/pricing.
Inputs: agent, purpose. Returns: key, note, calls, adopted, +1 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a clearly distinct axis: enumerating banks, fetching a bank's official table, fetching a per-date series, comparing across banks for one pair, and listing publication dates only. The descriptions explicitly disambiguate the riskiest overlaps (get_official_rates vs compare_official_rates, history vs calendar) and even steer users to a different package for live market rates.
All names follow a strict snake_case verb_noun pattern (list_central_banks, get_official_rates, get_official_rate_history, compare_official_rates, get_publication_calendar, request_trial_key). The single auth-related tool still fits the same convention, so there is no style drift.
Six tools is tight and well-scoped for a rates data server: one discovery tool, three rate-query tools at different granularity, one comparison aggregator, and one key-bootstrap tool. Nothing looks redundant or padded.
The core lifecycle is covered: discover banks, get latest/dated official tables, get history series, cross-bank comparison, and publication cadence, plus a way to obtain a key. Minor gaps remain — no tool to inspect key status/quota usage, no explicit currency-conversion or bulk multi-pair fetch, so an agent hitting billing limits must infer state from errors.
Maintenance
Related MCP Connectors
Live FX + official central-bank rates, 110+ sources. Hosted, keyless, nothing to install.
Official exchange rates from central banks: latest & historical rates plus currency conversion.
ExchangeRate MCP — wraps open.er-api.com (free, no auth)
Indicative fiat and crypto rates over MCP, paid per request via x402 at $0.0001/request.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceReal-time currency exchange rates and crypto prices via MCP. Convert between 60+ fiat currencies and 30+ cryptocurrencies with multi-source failover. No API keys needed for upstream data.ISC
- -licenseNot gradedqualityNot gradedmaintenanceMCP server that provides real exchange-rate data from the European Central Bank, including latest rates, currency conversion, historical rates, and time series.-
- AlicenseNot gradedqualityBmaintenanceConvert currencies, get FX rates, and query historical ECB exchange rate data via MCP.233 npm1Apache 2.0
- AlicenseNot gradedqualityDmaintenanceEnables querying official Brazilian Central Bank currency exchange rates and quotes through a read-only MCP tool, with pay-per-use prepaid credits.MIT