プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Exchange Rates MCP Server

作者:cyanheadsバージョン 0.7.0i★ 1iパソコンでもクラウドでも公式サイト ↗
レジストリ名io.github.cyanheads/exchange-rates-mcp-server

インストール方法

What it does

Convert currencies, get FX rates, and query historical Frankfurter v1 exchange rate data.

  • Connects パソコンでもクラウドでも
  • Account or key No key needed
  • Category 会計・財務・税務

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気14/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中8/8前回の確認でクラウドのエンドポイントが応答
利用スコア34/100

品質: 基本チェック 5/5 項目に合格(表示のみ、並び順には不使用) · 勢い: 12 (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Exchange Rates MCP Server をインストールして。https://mcp.popnx.com/i/cyanheads-exchange-rates-mcp-server.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 5/5 合格 · 質問内容は提供元のサーバー(exchange-rates.caseyjhand.com)を通ります · ✓ コマンド確認済み 2026年11月16日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげます · 約 2 分

キー不要、インストール不要 · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加

  1. Claude の Connectors ページを開く

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. 「Add」→「Custom」→「Web」を押し、この 2 つを入力

    ここからコピーして Claude の同じ名前の欄に貼り付け、Continue を押します

    Name · 名前Exchange Rates MCP Server
    Remote MCP server URL · アドレスhttps://exchange-rates.caseyjhand.com/mcp

    Claude が検出したサインイン設定の画面で Continue を押す · Authentication は作者の説明どおり(Sign in now・Sign in when needed・No sign in)を選び Add を押します

  3. チャットで有効にする

    +ConnectorsExchange Rates MCP Server

  4. 試してみる

    Exchange Rates MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Exchange Rates MCP Server を使っていると言うか、回答に Exchange Rates MCP Server のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT との接続はプランしだい

フル MCP:Web 版 ChatGPT の Business・Enterprise・Edu · Pro:読み取り/取得の権限で接続、データを変えるツールは使えないことがあります · Plus:公式ドキュメントで未確認。プラグイン画面にカスタム MCP を追加する項目があれば試せます · Web のみ

  1. Web 版 ChatGPT で MCP の追加ページを開く

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. 名前とアドレスを入力

    名前を入れ、Connection にアドレスを貼り付け、注意事項にチェックして Create as a plugin を押します

    Name · 名前Exchange Rates MCP Server
    Connection · アドレスhttps://exchange-rates.caseyjhand.com/mcp
  3. チャットで Exchange Rates MCP Server を選ぶ

    新しいチャットを開き、入力前にプラグインの一覧から Exchange Rates MCP Server を選びます

  4. 試してみる

    Exchange Rates MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ ChatGPT が Exchange Rates MCP Server を使っていると言うか、回答に Exchange Rates MCP Server のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に OpenAI のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Claude Code につなげます · 約 2 分

キー不要、インストール不要

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  2. このコマンドを貼り付けて Enter

    claude mcp add --transport http --scope user exchange-rates https://exchange-rates.caseyjhand.com/mcp
  3. Claude Code で /mcp と入力

    Exchange Rates MCP Server が一覧にあり、接続済みと表示されれば OK です

  4. 試してみる

    Exchange Rates MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Exchange Rates MCP Server を使っていると言うか、回答に Exchange Rates MCP Server のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  2. Cursor の AI チャットを Agent モードで開く

  3. 試してみる

    Exchange Rates MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Exchange Rates MCP Server を使っていると言うか、回答に Exchange Rates MCP Server のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  2. VS Code の AI チャットを Agent モードで開く

  3. 試してみる

    Exchange Rates MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Exchange Rates MCP Server を使っていると言うか、回答に Exchange Rates MCP Server のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

Web 経由でつなぐアプリ用のアドレス

アドレスhttps://exchange-rates.caseyjhand.com/mcp

JSON 設定は下の「開発者向け」にあります

つまずいたら?Exchange Rates MCP Server を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

Web 経由

Claude Code

claude mcp add --transport http --scope user exchange-rates https://exchange-rates.caseyjhand.com/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "exchange-rates": {
      "url": "https://exchange-rates.caseyjhand.com/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "exchange-rates": {
      "type": "http",
      "url": "https://exchange-rates.caseyjhand.com/mcp"
    }
  }
}

パソコンにインストール

Claude Code

claude mcp add --scope user exchange-rates -- npx -y @cyanheads/exchange-rates-mcp-server

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "exchange-rates": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/exchange-rates-mcp-server"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "exchange-rates": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/exchange-rates-mcp-server"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "exchange-rates": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/exchange-rates-mcp-server"
      ]
    }
  }
}

自分で入力する値

  • FRANKFURTER_BASE_URL env
    Frankfurter API のベース URL。ローカルテストや自己ホスト型インスタンスで上書きします。
    英語の原文を見るFrankfurter API base URL. Override for local testing or self-hosted instances.
  • FX_TIMESERIES_CANVAS_THRESHOLD_DAYS env
    fx_get_timeseries が SQL 分析のために DataCanvas への自動ステージングを検討する日数の範囲の上限です。canvas_id または stage: true がない場合、プレビューに収まる系列はインラインのままです。DataCanvas はデフォルトでオンです。
    英語の原文を見るDay range above which fx_get_timeseries considers automatic DataCanvas staging for SQL analytics. Without canvas_id or stage: true, series that fit the preview remain inline. DataCanvas is on by defa…
  • FX_ENABLE_CANVAS_DROP env
    fx_dataframe_drop を有効にします。これは DataCanvas 内のステージング済みテーブルまたはビューを 1 つ完全に削除します。デフォルトは無効です。true に設定されるまで、ツールは登録されず(tools/list に表示されません)。
    英語の原文を見るEnable fx_dataframe_drop, which permanently removes one staged table or view from a DataCanvas. Disabled by default; the tool is not registered (absent from tools/list) until set to true.
  • MCP_LOG_LEVEL env
    出力する最小のログレベルを設定します(例: 'debug'、'info'、'warn')
    英語の原文を見るSets the minimum log level for output (e.g., 'debug', 'info', 'warn').

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
415/週
接続方法
パソコンでもクラウドでも
最新バージョンi
0.7.0
レジストリ公開日i
2026年11月16日
コードの最終更新i
2026年11月16日
最終確認
2026年11月17日
作者
cyanheads
パッケージ
npm: @cyanheads/exchange-rates-mcp-server
npm: @cyanheads/exchange-rates-mcp-server
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

インターネット経由でつなげるアプリ

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

ツールの名前と説明は、サーバーが2026年11月17日に返したそのままの内容です。書いたのは作者で、私たちではありません。プレーンテキストとして表示しています。

  • fx_list_currencies

    List current Frankfurter v1 currency codes and names with as_of, the latest served rate date. include_retired=true adds historical codes absent from the current set, each marked retired=true. Optional official ECB start_date/end_date are outer coverage bounds, not uninterrupted a

  • fx_get_rates

    Get all available exchange rates for one base currency in a single snapshot. Useful for bulk comparison and seeding downstream tools. Returns a map of quote currency → rate, the actual snapshot date, and whether a historical date was snapped to the prior published date. Optionall

  • fx_get_rate

    Get the exchange rate for a currency pair on a given date (default: latest). Returns the rate, the actual rate date (the prior published date when none was published for the requested date), and source provenance. Cross-rates are triangulated through EUR automatically. A same-cur

  • fx_convert_currency

    Convert an amount between any two currencies at the latest or a historical rate. Returns the converted amount, the rate used, the actual rate date, and whether the date was snapped to the prior published date. Cross-rates are triangulated through EUR automatically.

  • fx_get_timeseries

    Get historical daily Frankfurter v1 rates over an inclusive date range. Same-date EUR legs are divided without intermediate rounding; only days with both currencies appear, including observed self-pairs at 1 and historical retired currencies. Missing-leg served days produce cover

  • fx_dataframe_describe

    List tables and columns staged on a DataCanvas from a prior fx_get_timeseries call. Required first step before fx_dataframe_query — use it to discover table names and column schemas. Requires DataCanvas, which is on by default — a deployment that turns it off does not list this t

  • fx_dataframe_query

    Run a read-only SQL SELECT against DataCanvas tables staged by fx_get_timeseries. Supports aggregations, GROUP BY, window functions, and JOINs across multiple registered tables. Run fx_dataframe_describe first to discover table names and column schemas. Requires DataCanvas, which

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント cyanheads で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:3 日前

  • ✓ 合格

    ライセンスがある

    Apache-2.0を使用

  • ✓ 合格

    エンドポイントが応答する

    40ミリ秒で応答(HTTP 200)

  • – 対象外

    OAuthでサインイン

    サインイン不要

  • ✓ 合格

    ツールの説明に隠れた指示がない

    7件のツールの説明を読み、AIへの隠れた指示は見つかりませんでした

公開済みの脆弱性(OSV.dev)

まだ確認していません

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/cyanheads-exchange-rates-mcp-server.svg)](https://mcp.popnx.com/en/servers/cyanheads-exchange-rates-mcp-server)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

会計・財務・税務のほかのサーバーとの比較i

  • このカテゴリのほかの3407件のうち87%よりスターが多い
  • このカテゴリのほかの3407件のうち90%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの3407件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Exchange Rates MCP Serverは安全ですか?

当てはまる基本チェック5項目のうち5項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

どちらでも使えます。パソコンにインストールしても、クラウド版につないでもかまいません。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は3 日前、最新バージョン(0.7.0)がレジストリに届いたのは3 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。

代わりに使えるものは?

同じカテゴリには:SolidInvoice, Signal8, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

作者:SolidInvoice成長中★ 98910 日前更新

クラウドで動く✓ 提供元 · solidinvoice.co

Signal8

SEC filings, dilution, insider & institutional ownership, and political-trade data for AI agents.

作者:signal8ai成長中↓ 431/週★ 42510 日前更新

パソコンでもクラウドでも✓ 提供元 · signal8.ai

Journalit

Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.

作者:Cursivez成長中★ 26111 日前更新

クラウドで動く✓ 提供元 · journalit.co

Beancount.io

Query, edit, and reconcile a hosted Beancount ledger: BQL, reports, files, and bank imports.

作者:bex-co成長中★ 688 リポジトリ全体のスター44 日前更新

クラウドで動く✓ 提供元 · beancount.io
似たものと比べる
これ
Exchange Rates MCP Server
SolidInvoiceSignal8JournalitBeancount.ioTapetide - Indian Stock Market MCP
動く場所クラウドでもパソコンにインストールでも使えるクラウドで動き、インストール不要クラウドでもパソコンにインストールでも使えるクラウドで動き、インストール不要クラウドで動き、インストール不要クラウドでもパソコンにインストールでも使える
キーが必要いいえいいえはいいいえいいえはい
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック5/54/65/54/44/45/5
ライセンスApache-2.0MITMITNOASSERTIONMITMIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

@cyanheads/exchange-rates-mcp-server Convert currencies, get FX rates, and query historical Frankfurter v1 exchange rate data via MCP. STDIO or Streamable HTTP. 7 Tools • 1 Opt-in Tool • 2 Resources

Public Hosted Server: https://exchange-rates.caseyjhand.com/mcp


Overview

Daily exchange rates from Frankfurter v1, with current currency discovery and historical coverage from 1999-01-04. Convert amounts, pull point-in-time or historical rates, summarize a full date range, and run SQL over staged series. Historical availability includes retired currencies and is checked against the requested data. Responses identify source: "Frankfurter v1" and rate_type: "Daily rate (Frankfurter v1)"; the v1 payload does not identify individual providers. No API key required.

Tools
ToolDescription
fx_list_currenciesCurrent currency discovery with full names and the latest served rate date
fx_get_ratesSnapshot of all rates for a base currency at latest or a historical date
fx_get_rateExchange rate for a single currency pair at latest or a historical date
fx_convert_currencyConvert an amount between two currencies at latest or a historical rate
fx_get_timeseriesHistorical daily rates for a currency pair over a date range
fx_dataframe_describeList DataCanvas tables and columns staged by a prior fx_get_timeseries call
fx_dataframe_queryRun a read-only SQL SELECT against a staged DataCanvas table
fx_dataframe_dropRemove one staged DataCanvas table or view (opt-in, destructive)

DataCanvas (DuckDB) is on by default. Set CANVAS_PROVIDER_TYPE=none to turn it off: the three fx_dataframe_* tools then drop out of tools/list, and fx_get_timeseries returns ranges inline when canvas_id and stage are omitted; explicit staging (canvas_id or stage: true) fails canvas_unavailable. The Claude Desktop bundle (.mcpb) ships without DuckDB's native binding, so it runs with DataCanvas off. fx_dataframe_drop additionally needs FX_ENABLE_CANVAS_DROP=true.

The four rate and conversion tools accept base as an alias of base_currency; pair tools also accept quote for quote_currency. Send either spelling for a field, never both. Advertised schemas use the canonical names.

Currency values, including symbols, are trimmed and uppercased. Point dates accept YYYY-MM-DD or literal latest (also the default); range dates require YYYY-MM-DD. Advertised date patterns preserve handler-level invalid_date_format errors for malformed, blank or impossible calendar dates. Future range errors recommend an end_date today or earlier; end_date remains required.

Resources
ResourceDescription
fx://currenciesAll supported currencies as a stable reference document
fx://rates/latest/{base}Latest rates snapshot for a base currency as a stable URI

All resource data is also reachable via tools — use fx_list_currencies or fx_get_rates for programmatic access.

Skill

exchange-rates-guide covers historical currency coverage, observed-day summaries, paging and SQL comparisons. It ships with npm, Docker and MCPB installs and is available over MCP at skill://exchange-rates-guide/SKILL.md.

Cancelling a tool call or resource read stops its upstream fetch, response-body read, and retry backoff. V1 requests retain two retries and a 10-second timeout per attempt within a 12-second total budget per read. Optional coverage metadata gets one 1-second request without retries.

Capability reference

fx_list_currencies tool
  • Optional include_retired (default false) adds historical codes absent from current v1 discovery; the rows it appends carry retired: true
  • Returns currencies: [{ code, name, start_date?, end_date?, retired }], count, source and as_of (the latest served daily rate date, read uncached on every call so it matches the rate_date of a latest-rate call), sorted alphabetically by code. Coverage dates come from optional official ECB metadata and describe outer bounds, not uninterrupted availability. Read retired, not end_date, for retirement.
  • Metadata is cached for a day (a failed read is retried after five minutes) and queried only for the default official v1 base. Unavailable metadata leaves current discovery intact with a notice; valid v1 rate requests never depend on metadata.
  • Default discovery lists current currencies; include_retired: true adds historical codes when metadata is available. Historical requests validate against their unfiltered EUR snapshot or raw served range, so retired codes remain usable on dates where they have observations. Unknown codes fail unsupported_currency with sorted accepted/rejected codes and the input field; current currencies without historical observations fail upstream_no_data, with currency_windows and a sentence naming the coverage bound when ECB coverage metadata is available.

fx_get_rates tool
  • base_currency required; date optional (default latest, history from 1999-01-04, no future dates); optional symbols array narrows the response and must name at least one code
  • Returns a rates map (quote code → rate), the actual rate_date, and date_snapped: true when a weekend, a holiday, or a day whose fix is not yet published snapped to the prior published date
  • Naming the base currency in symbols is valid — answered locally with a rate of 1 rather than sent upstream
  • Missing observations from a served snapshot identify the offending field and sorted, deduplicated missing_codes, plus currency_windows and a sentence naming the bound (coverage begins or ends, or a date or range inside the bounds that can contain gaps) when ECB coverage metadata is available; unknown currencies retain unsupported_currency precedence. A response without any snapshot remains an unattributed upstream_no_data failure.
  • Typed failures: invalid_date_format, unsupported_currency, date_out_of_range, upstream_no_data

fx_get_rate tool
  • base_currency, quote_currency required; date optional (default latest, history from 1999-01-04, no future dates)
  • Returns rate, rate_date, and date_snapped: true when a weekend, a holiday, or a day whose fix is not yet published snapped to the prior published date
  • Every pair uses quote EUR leg / base EUR leg from one unfiltered EUR snapshot without intermediate rounding; EUR's leg is 1. Same-currency pairs return 1 only on actual observation dates.
  • Typed failures: invalid_date_format, unsupported_currency, date_out_of_range, upstream_no_data

fx_convert_currency tool
  • base_currency, quote_currency, amount (must be > 0) required; date optional (default latest, history from 1999-01-04, no future dates)
  • Handles EUR↔any, any↔EUR, and cross-rate pairs (e.g. USD→JPY) in a single upstream call
  • Returns quote_amount as the unrounded JavaScript-number amount * rate product, rate, rate_date, date_snapped, plus rate_type and source provenance. No currency minor-unit rounding policy is applied; formatted rates use quote currency per base currency.
  • Typed failures: invalid_date_format, unsupported_currency, date_out_of_range, upstream_no_data

fx_get_timeseries tool
  • base_currency, quote_currency, start_date, end_date required (history from 1999-01-04, no future dates, start ≤ end); optional canvas_id appends to an existing canvas
  • Optional stage (default false): true stages the complete series on a new canvas whose canvas_id is returned, even for short or empty ranges. To stage another series beside it, pass that canvas_id rather than stage: true again, since fx_dataframe_query reads one canvas at a time. canvas_id always stages, whatever stage says.
  • Optional integer limit (default 500, minimum 0) bounds returned observations, clamping values above 500 with a notice. limit: 0 returns summary and metadata with empty rates; a nonempty inline result then points next_start_date at the first observation. Repeat with a positive limit to advance. Counts, summary, bounds, staging eligibility and complete staged tables are independent of the limit.
  • Inline results page at up to 500 observed publication days — rate_count is always the range total; truncated: true plus next_start_date continue the page
  • Ranges over FX_TIMESERIES_CANVAS_THRESHOLD_DAYS (default 90 days) are considered for DataCanvas staging. Series over the 40,000-character preview budget return spilled: true, canvas_id, and table_name; smaller series and deployments with CANVAS_PROVIDER_TYPE=none page inline
  • A same-currency pair returns 1 on actual observation dates. Every non-identity row requires both EUR legs on that same date; missing legs never fabricate observations. Membership uses all raw served dates before inclusive clipping, preserving weekend-only empty windows.
  • Missing either leg on a served in-window day produces a notice with the affected day count and first/last dates. Each day counts once, even if both legs are absent; weekends, holidays and clipped prior dates do not count. Statistics cover observed days only. Coverage and delivery notices coexist; truncated describes omitted observations in delivery, not missing upstream coverage.
  • An empty range (weekends, holidays, a fix not yet published, or currency gaps) returns rate_count: 0 with an explanatory notice, distinguishable from an error
  • Whether a long range overflows the preview is measured before any canvas is acquired, so a series that fits inline never acquires one (pending cyanheads/mcp-ts-core#501); a failed or ca

冒頭だけを表示しています。続きはリポジトリで読めます