@cyanheads/exchange-rates-mcp-server 0.1.1

package/changelog/template.md

@@ -0,0 +1,127 @@
+---
+# FORMAT REFERENCE — do not edit. Copy this file to
+# `changelog/<major.minor>.x/<version>.md` (e.g. `changelog/0.8.x/0.8.6.md`)
+# to author a new release. Set that file's H1 to `# <version> — YYYY-MM-DD`
+# with a concrete date.
+
+# Required. One-line GitHub Release-style headline. 350 character cap.
+# Default short and scannable. Don't pad, don't stitch unrelated changes with
+# semicolons — pick the headline. Quotes required: unquoted YAML treats `: `
+# inside the value as a key separator and fails GitHub's strict parser.
+summary: ""
+
+# Set `true` when consumers must change code to upgrade: API removals,
+# signature changes, config renames, behavior changes that break existing
+# usage. Flagged as `Breaking` in the rollup.
+breaking: false
+
+# Set `true` if this release contains any security fix. Pairs with the
+# `## Security` section below. Flagged as `Security` in the rollup so
+# users can triage upgrade urgency at a glance.
+security: false
+
+# Optional free-form notes for maintenance agents processing this release.
+# Not rendered in CHANGELOG — consumed by agents running `maintenance` on
+# downstream servers. Use for adoption instructions that don't fit the
+# human-facing sections: new files to create, fields to populate, one-time
+# migration steps. Omit the field entirely when there's nothing to say.
+# agent-notes: |
+#   <instructions for downstream maintenance agents>
+---
+
+# <version> — YYYY-MM-DD
+
+<!--
+  AUTHORING GUIDE — applies to the new per-version file you create from this
+  template.
+
+  Audience: someone scanning release notes to decide what affects them. Lead
+  each bullet with the symbol or concept name in **bold** so they can skip
+  what's irrelevant and zoom in on what's not.
+
+  Tone: terse, fact-dense, not verbose. Default to one sentence per bullet —
+  name the symbol, state what changed, stop. Use a second sentence only when
+  it carries weight. If a bullet feels long, it is.
+
+  Cut: mechanism walkthroughs (those belong in JSDoc, CLAUDE.md/AGENTS.md, or the
+  relevant skill), ceremonial framings ("This release introduces…",
+  backwards-compat paragraphs), file-by-file test enumerations, internal
+  implementation notes. Prefer code/symbol names over English re-explanations.
+
+  Narrative intro: skip by default. Add one short sentence only when the
+  release theme genuinely needs framing the bullets can't carry.
+
+  Sections: Keep a Changelog order — Added, Changed, Deprecated, Removed,
+  Fixed, Security. Include only sections with entries; delete the rest
+  (including the commented-out scaffolding below). Don't ship empty headers.
+
+  Include: every distinct fact a reader needs to adopt or audit the release —
+  new exports, signatures, lint rule IDs, env vars, breaking changes, version
+  bumps on shipped skills. Nothing more.
+
+  Links: link issues, PRs, docs, or skills where they help a reader jump to
+  context. Once per item per entry — don't re-link the same issue in summary,
+  narrative, and bullet. Skip links for inline symbol names; code spans speak
+  for themselves.
+
+  Issue/PR URLs: use full URLs. GitHub's bare `#NN` auto-link only resolves
+  inside its own UI, not in npm reads or local editors.
+
+      [#38](https://github.com/cyanheads/mcp-ts-core/issues/38)   ← issue
+      [#42](https://github.com/cyanheads/mcp-ts-core/pull/42)     ← PR
+
+  Verify numbers exist before linking (`gh issue view NN`, `gh pr view NN`).
+  Never speculate on a future number — `#42` for an upcoming PR silently
+  resolves to whatever real item already owns 42, and timeline previews pull
+  in that unrelated item's metadata.
+
+  TAG ANNOTATIONS — the annotated tag body renders as the GitHub Release body
+  via `gh release create --notes-from-tag`. The tag is a derivative of this
+  changelog entry — a condensed, scannable version, not a copy. Format:
+
+    <theme — omit version number, GitHub prepends it>
+                                                          ← blank line
+    <1-2 sentence context: what this release does>
+                                                          ← blank line
+    Dependency bumps:                                     ← section header
+                                                          ← blank line
+    - `@cyanheads/mcp-ts-core` ^0.9.1 → ^0.9.6          ← bullet
+                                                          ← blank line
+    Changed:                                              ← only sections with entries
+                                                          ← blank line
+    - `format()` output includes `query` in text mode
+                                                          ← blank line
+    Added:
+                                                          ← blank line
+    - `manifest.json` scaffolded for MCPB bundle support
+    - Install badges (Claude Desktop, Cursor, VS Code)
+                                                          ← blank line
+    <N> tests pass; `bun run devcheck` clean.             ← footer
+
+  Never a flat comma-separated string. Always structured markdown with
+  sections. The tag must scan well as a rendered GitHub Release page.
+-->
+
+## Added
+
+-
+
+## Changed
+
+-
+
+<!-- ## Deprecated
+
+- -->
+
+<!-- ## Removed
+
+- -->
+
+## Fixed
+
+-
+
+<!-- ## Security
+
+- -->

package/dist/config/server-config.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Server-specific configuration schema for exchange-rates-mcp-server.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+declare const ServerConfigSchema: z.ZodObject<{
+    frankfurterBaseUrl: z.ZodDefault<z.ZodString>;
+    timeseriesCanvasThresholdDays: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+/** Return the parsed, validated server config (lazy-init on first call). */
+export declare function getServerConfig(): z.infer<typeof ServerConfigSchema>;
+export {};
+//# sourceMappingURL=server-config.d.ts.map

package/dist/config/server-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.d.ts","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAG3C,QAAA,MAAM,kBAAkB;;;iBAYtB,CAAC;AAIH,4EAA4E;AAC5E,wBAAgB,eAAe,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAMpE"}

package/dist/config/server-config.js

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview Server-specific configuration schema for exchange-rates-mcp-server.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { parseEnvConfig } from '@cyanheads/mcp-ts-core/config';
+const ServerConfigSchema = z.object({
+    frankfurterBaseUrl: z
+        .string()
+        .url()
+        .default('https://api.frankfurter.dev/v1')
+        .describe('Frankfurter API base URL. Override for local testing or self-hosted instances.'),
+    timeseriesCanvasThresholdDays: z.coerce
+        .number()
+        .default(90)
+        .describe('Day count above which fx_get_timeseries spills the result to DataCanvas instead of inlining.'),
+});
+let _config;
+/** Return the parsed, validated server config (lazy-init on first call). */
+export function getServerConfig() {
+    _config ??= parseEnvConfig(ServerConfigSchema, {
+        frankfurterBaseUrl: 'FRANKFURTER_BASE_URL',
+        timeseriesCanvasThresholdDays: 'FX_TIMESERIES_CANVAS_THRESHOLD_DAYS',
+    });
+    return _config;
+}
+//# sourceMappingURL=server-config.js.map

package/dist/config/server-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,kBAAkB,EAAE,CAAC;SAClB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,OAAO,CAAC,gCAAgC,CAAC;SACzC,QAAQ,CAAC,gFAAgF,CAAC;IAC7F,6BAA6B,EAAE,CAAC,CAAC,MAAM;SACpC,MAAM,EAAE;SACR,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CACP,8FAA8F,CAC/F;CACJ,CAAC,CAAC;AAEH,IAAI,OAAuD,CAAC;AAE5D,4EAA4E;AAC5E,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,cAAc,CAAC,kBAAkB,EAAE;QAC7C,kBAAkB,EAAE,sBAAsB;QAC1C,6BAA6B,EAAE,qCAAqC;KACrE,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview exchange-rates-mcp-server MCP server entry point.
+ * @module index
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG"}

package/dist/index.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview exchange-rates-mcp-server MCP server entry point.
+ * @module index
+ */
+import { createApp } from '@cyanheads/mcp-ts-core';
+import { fxCurrenciesResource, fxRatesLatestResource, } from './mcp-server/resources/definitions/index.js';
+import { fxConvertCurrency, fxDataframeDescribe, fxDataframeQuery, fxGetRate, fxGetRates, fxGetTimeseries, fxListCurrencies, } from './mcp-server/tools/definitions/index.js';
+import { setCanvas } from './services/canvas/canvas-accessor.js';
+await createApp({
+    tools: [
+        fxListCurrencies,
+        fxGetRates,
+        fxGetRate,
+        fxConvertCurrency,
+        fxGetTimeseries,
+        fxDataframeDescribe,
+        fxDataframeQuery,
+    ],
+    resources: [fxCurrenciesResource, fxRatesLatestResource],
+    prompts: [],
+    instructions: 'ECB reference FX rates via Frankfurter (keyless, ~30 currencies, 1999-01-04 to present).\n' +
+        '- Rates are mid-market ECB reference rates — not tradeable bid/ask.\n' +
+        '- Use fx_list_currencies first to disambiguate "dollars" (USD/AUD/CAD/HKD/SGD).\n' +
+        '- Cross-rates (e.g. USD→JPY) are triangulated through EUR automatically.\n' +
+        '- Long time-series (>90 days) spill to DataCanvas; use fx_dataframe_query for SQL.',
+    setup(core) {
+        setCanvas(core.canvas);
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EACL,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,eAAe,EACf,gBAAgB,GACjB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAEjE,MAAM,SAAS,CAAC;IACd,KAAK,EAAE;QACL,gBAAgB;QAChB,UAAU;QACV,SAAS;QACT,iBAAiB;QACjB,eAAe;QACf,mBAAmB;QACnB,gBAAgB;KACjB;IACD,SAAS,EAAE,CAAC,oBAAoB,EAAE,qBAAqB,CAAC;IACxD,OAAO,EAAE,EAAE;IAEX,YAAY,EACV,4FAA4F;QAC5F,uEAAuE;QACvE,mFAAmF;QACnF,4EAA4E;QAC5E,oFAAoF;IAEtF,KAAK,CAAC,IAAI;QACR,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/prompts/definitions/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Barrel export for all prompt definitions. No prompts in this server.
+ * @module mcp-server/prompts/definitions/index
+ */
+export declare const allPromptDefinitions: never[];
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/prompts/definitions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,oBAAoB,EAAE,KAAK,EAAO,CAAC"}

package/dist/mcp-server/prompts/definitions/index.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Barrel export for all prompt definitions. No prompts in this server.
+ * @module mcp-server/prompts/definitions/index
+ */
+export const allPromptDefinitions = [];
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/prompts/definitions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAY,EAAE,CAAC"}

package/dist/mcp-server/resources/definitions/fx-currencies.resource.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @fileoverview fx://currencies resource — stable reference document for all supported currencies.
+ * @module mcp-server/resources/definitions/fx-currencies.resource
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const fxCurrenciesResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+    currencies: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+    count: z.ZodNumber;
+    source: z.ZodString;
+}, z.core.$strip>, undefined>;
+//# sourceMappingURL=fx-currencies.resource.d.ts.map

package/dist/mcp-server/resources/definitions/fx-currencies.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fx-currencies.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/fx-currencies.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAGrD,eAAO,MAAM,oBAAoB;;;;;;;6BAwC/B,CAAC"}

package/dist/mcp-server/resources/definitions/fx-currencies.resource.js

@@ -0,0 +1,43 @@
+/**
+ * @fileoverview fx://currencies resource — stable reference document for all supported currencies.
+ * @module mcp-server/resources/definitions/fx-currencies.resource
+ */
+import { resource, z } from '@cyanheads/mcp-ts-core';
+import { getFrankfurterService } from '../../../services/frankfurter/frankfurter-service.js';
+export const fxCurrenciesResource = resource('fx://currencies', {
+    name: 'fx-currencies',
+    description: 'All supported ISO 4217 currency codes with full names. ' +
+        'Injectable context for clients that support resources. ' +
+        'Covers the ~30 ECB reference currencies.',
+    mimeType: 'application/json',
+    params: z.object({}),
+    output: z.object({
+        currencies: z
+            .array(z
+            .object({
+            code: z.string().describe('ISO 4217 currency code.'),
+            name: z.string().describe('Full currency name.'),
+        })
+            .describe('A single supported currency.'))
+            .describe('All supported currencies, sorted alphabetically by code.'),
+        count: z.number().describe('Total number of supported currencies.'),
+        source: z.string().describe('Always "ECB via Frankfurter" — the upstream data provider.'),
+    }),
+    async handler(_params, ctx) {
+        const service = getFrankfurterService();
+        const currencies = await service.listCurrencies();
+        ctx.log.info('Fetched currencies resource', { count: currencies.length });
+        return { currencies, count: currencies.length, source: 'ECB via Frankfurter' };
+    },
+    list: () => ({
+        resources: [
+            {
+                uri: 'fx://currencies',
+                name: 'Supported Currencies',
+                mimeType: 'application/json',
+                description: 'All ISO 4217 currency codes supported by ECB/Frankfurter.',
+            },
+        ],
+    }),
+});
+//# sourceMappingURL=fx-currencies.resource.js.map

package/dist/mcp-server/resources/definitions/fx-currencies.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fx-currencies.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/fx-currencies.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AAEtF,MAAM,CAAC,MAAM,oBAAoB,GAAG,QAAQ,CAAC,iBAAiB,EAAE;IAC9D,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,yDAAyD;QACzD,yDAAyD;QACzD,0CAA0C;IAC5C,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACpB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,UAAU,EAAE,CAAC;aACV,KAAK,CACJ,CAAC;aACE,MAAM,CAAC;YACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;YACpD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;SACjD,CAAC;aACD,QAAQ,CAAC,8BAA8B,CAAC,CAC5C;aACA,QAAQ,CAAC,0DAA0D,CAAC;QACvE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;QACnE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;KAC1F,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG;QACxB,MAAM,OAAO,GAAG,qBAAqB,EAAE,CAAC;QACxC,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC;QAClD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1E,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;IACjF,CAAC;IAED,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QACX,SAAS,EAAE;YACT;gBACE,GAAG,EAAE,iBAAiB;gBACtB,IAAI,EAAE,sBAAsB;gBAC5B,QAAQ,EAAE,kBAAkB;gBAC5B,WAAW,EAAE,2DAA2D;aACzE;SACF;KACF,CAAC;CACH,CAAC,CAAC"}

package/dist/mcp-server/resources/definitions/fx-rates-latest.resource.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview fx://rates/latest/{base} resource — latest rates snapshot for a base currency.
+ * @module mcp-server/resources/definitions/fx-rates-latest.resource
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const fxRatesLatestResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{
+    base: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    base_currency: z.ZodString;
+    rate_date: z.ZodString;
+    rates: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    rate_type: z.ZodString;
+    source: z.ZodString;
+}, z.core.$strip>, undefined>;
+//# sourceMappingURL=fx-rates-latest.resource.d.ts.map

package/dist/mcp-server/resources/definitions/fx-rates-latest.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fx-rates-latest.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/fx-rates-latest.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAGrD,eAAO,MAAM,qBAAqB;;;;;;;;6BA6DhC,CAAC"}

package/dist/mcp-server/resources/definitions/fx-rates-latest.resource.js

@@ -0,0 +1,61 @@
+/**
+ * @fileoverview fx://rates/latest/{base} resource — latest rates snapshot for a base currency.
+ * @module mcp-server/resources/definitions/fx-rates-latest.resource
+ */
+import { resource, z } from '@cyanheads/mcp-ts-core';
+import { getFrankfurterService } from '../../../services/frankfurter/frankfurter-service.js';
+export const fxRatesLatestResource = resource('fx://rates/latest/{base}', {
+    name: 'fx-rates-latest',
+    description: 'Latest exchange rates snapshot for a base currency as a stable URI. ' +
+        'Returns all available quote currencies at the most recent ECB business-day fix.',
+    mimeType: 'application/json',
+    params: z.object({
+        base: z.string().describe('ISO 4217 base currency code (e.g. USD, EUR, GBP).'),
+    }),
+    output: z.object({
+        base_currency: z.string().describe('The base currency code.'),
+        rate_date: z.string().describe('Actual date of the rates.'),
+        rates: z
+            .record(z.string(), z.number())
+            .describe('Map of quote currency code → exchange rate (units of quote currency per 1 unit of base).'),
+        rate_type: z
+            .string()
+            .describe('Always "ECB reference (mid-market)" — these are reference rates, not tradeable bid/ask.'),
+        source: z.string().describe('Always "ECB via Frankfurter" — the upstream data provider.'),
+    }),
+    async handler(params, ctx) {
+        const service = getFrankfurterService();
+        let raw;
+        try {
+            raw = await service.getRates(params.base, 'latest');
+        }
+        catch (err) {
+            const msg = err.message ?? '';
+            if (msg.includes('not found')) {
+                throw new Error(`Currency "${params.base}" is not supported by the ECB. Call fx_list_currencies to get valid codes.`);
+            }
+            throw err;
+        }
+        ctx.log.info('Fetched latest rates resource', {
+            base: params.base,
+            date: raw.date,
+            count: Object.keys(raw.rates).length,
+        });
+        return {
+            base_currency: raw.base,
+            rate_date: raw.date,
+            rates: raw.rates,
+            rate_type: 'ECB reference (mid-market)',
+            source: 'ECB via Frankfurter',
+        };
+    },
+    list: () => ({
+        resources: [
+            { uri: 'fx://rates/latest/EUR', name: 'Latest EUR rates', mimeType: 'application/json' },
+            { uri: 'fx://rates/latest/USD', name: 'Latest USD rates', mimeType: 'application/json' },
+            { uri: 'fx://rates/latest/GBP', name: 'Latest GBP rates', mimeType: 'application/json' },
+            { uri: 'fx://rates/latest/JPY', name: 'Latest JPY rates', mimeType: 'application/json' },
+        ],
+    }),
+});
+//# sourceMappingURL=fx-rates-latest.resource.js.map

package/dist/mcp-server/resources/definitions/fx-rates-latest.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fx-rates-latest.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/fx-rates-latest.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AAEtF,MAAM,CAAC,MAAM,qBAAqB,GAAG,QAAQ,CAAC,0BAA0B,EAAE;IACxE,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,sEAAsE;QACtE,iFAAiF;IACnF,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;KAC/E,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QAC7D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;QAC3D,KAAK,EAAE,CAAC;aACL,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;aAC9B,QAAQ,CACP,0FAA0F,CAC3F;QACH,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,QAAQ,CACP,yFAAyF,CAC1F;QACH,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;KAC1F,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG;QACvB,MAAM,OAAO,GAAG,qBAAqB,EAAE,CAAC;QACxC,IAAI,GAAiD,CAAC;QACtD,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACtD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAI,GAAa,CAAC,OAAO,IAAI,EAAE,CAAC;YACzC,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC9B,MAAM,IAAI,KAAK,CACb,aAAa,MAAM,CAAC,IAAI,4EAA4E,CACrG,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,+BAA+B,EAAE;YAC5C,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM;SACrC,CAAC,CAAC;QACH,OAAO;YACL,aAAa,EAAE,GAAG,CAAC,IAAI;YACvB,SAAS,EAAE,GAAG,CAAC,IAAI;YACnB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,SAAS,EAAE,4BAA4B;YACvC,MAAM,EAAE,qBAAqB;SAC9B,CAAC;IACJ,CAAC;IAED,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QACX,SAAS,EAAE;YACT,EAAE,GAAG,EAAE,uBAAuB,EAAE,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,kBAAkB,EAAE;YACxF,EAAE,GAAG,EAAE,uBAAuB,EAAE,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,kBAAkB,EAAE;YACxF,EAAE,GAAG,EAAE,uBAAuB,EAAE,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,kBAAkB,EAAE;YACxF,EAAE,GAAG,EAAE,uBAAuB,EAAE,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,kBAAkB,EAAE;SACzF;KACF,CAAC;CACH,CAAC,CAAC"}

package/dist/mcp-server/resources/definitions/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Barrel export for all resource definitions.
+ * @module mcp-server/resources/definitions/index
+ */
+export { fxCurrenciesResource } from './fx-currencies.resource.js';
+export { fxRatesLatestResource } from './fx-rates-latest.resource.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/resources/definitions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/mcp-server/resources/definitions/index.js

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Barrel export for all resource definitions.
+ * @module mcp-server/resources/definitions/index
+ */
+export { fxCurrenciesResource } from './fx-currencies.resource.js';
+export { fxRatesLatestResource } from './fx-rates-latest.resource.js';
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/resources/definitions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/mcp-server/tools/definitions/fx-convert-currency.tool.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @fileoverview fx_convert_currency — convert an amount between any two currencies.
+ * @module mcp-server/tools/definitions/fx-convert-currency.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const fxConvertCurrency: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    base_currency: z.ZodString;
+    quote_currency: z.ZodString;
+    amount: z.ZodNumber;
+    date: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    base_currency: z.ZodString;
+    quote_currency: z.ZodString;
+    base_amount: z.ZodNumber;
+    quote_amount: z.ZodNumber;
+    rate: z.ZodNumber;
+    rate_date: z.ZodString;
+    date_snapped: z.ZodBoolean;
+    rate_type: z.ZodString;
+    source: z.ZodString;
+}, z.core.$strip>, readonly [{
+    readonly reason: "unsupported_currency";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "base_currency or quote_currency is not in the ECB currency set.";
+    readonly recovery: "Call fx_list_currencies to get the list of valid currency codes.";
+}, {
+    readonly reason: "date_out_of_range";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "date is before 1999-01-04 or in the future.";
+    readonly recovery: "ECB data starts 1999-01-04; omit date for the latest available rate.";
+}], undefined>;
+//# sourceMappingURL=fx-convert-currency.tool.d.ts.map

package/dist/mcp-server/tools/definitions/fx-convert-currency.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fx-convert-currency.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/fx-convert-currency.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAOjE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;cAuJ5B,CAAC"}

package/dist/mcp-server/tools/definitions/fx-convert-currency.tool.js

@@ -0,0 +1,133 @@
+/**
+ * @fileoverview fx_convert_currency — convert an amount between any two currencies.
+ * @module mcp-server/tools/definitions/fx-convert-currency.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { ECB_START_DATE, getFrankfurterService, } from '../../../services/frankfurter/frankfurter-service.js';
+export const fxConvertCurrency = tool('fx_convert_currency', {
+    description: '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 from a weekend/holiday to the prior business day. ' +
+        'Cross-rates are triangulated through EUR automatically. ' +
+        'The primary tool for agent-driven FX workflows.',
+    annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+    input: z.object({
+        base_currency: z
+            .string()
+            .describe('ISO 4217 source currency code (e.g. USD). Call fx_list_currencies to get valid codes.'),
+        quote_currency: z
+            .string()
+            .describe('ISO 4217 target currency code (e.g. EUR). The amount will be expressed in this currency.'),
+        amount: z
+            .number()
+            .describe('Amount in the base currency to convert. Must be a positive number.'),
+        date: z
+            .string()
+            .optional()
+            .describe('ISO 8601 date (YYYY-MM-DD) for a historical rate. Omit for the latest available rate. ' +
+            'ECB data starts 1999-01-04. Future dates are not supported.'),
+    }),
+    output: z.object({
+        base_currency: z.string().describe('Source currency code.'),
+        quote_currency: z.string().describe('Target currency code.'),
+        base_amount: z.number().describe('The input amount in the base currency.'),
+        quote_amount: z
+            .number()
+            .describe('The converted amount in the quote currency, rounded to 6 decimal places.'),
+        rate: z
+            .number()
+            .describe('Exchange rate used: units of quote currency per 1 unit of base currency.'),
+        rate_date: z.string().describe('Actual date of the rate used for conversion.'),
+        date_snapped: z
+            .boolean()
+            .describe('True when the API returned a different date than requested — ' +
+            'ECB silently snaps weekend/holiday requests to the prior business day.'),
+        rate_type: z
+            .string()
+            .describe('Always "ECB reference (mid-market)" — these are reference rates, not tradeable bid/ask.'),
+        source: z.string().describe('Always "ECB via Frankfurter" — the upstream data provider.'),
+    }),
+    errors: [
+        {
+            reason: 'unsupported_currency',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'base_currency or quote_currency is not in the ECB currency set.',
+            recovery: 'Call fx_list_currencies to get the list of valid currency codes.',
+        },
+        {
+            reason: 'date_out_of_range',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'date is before 1999-01-04 or in the future.',
+            recovery: 'ECB data starts 1999-01-04; omit date for the latest available rate.',
+        },
+    ],
+    async handler(input, ctx) {
+        const service = getFrankfurterService();
+        const date = input.date ?? 'latest';
+        if (date !== 'latest') {
+            if (date < ECB_START_DATE) {
+                throw ctx.fail('date_out_of_range', `Date ${date} is before ECB data start ${ECB_START_DATE}.`, {
+                    ...ctx.recoveryFor('date_out_of_range'),
+                });
+            }
+            const today = new Date().toISOString().slice(0, 10);
+            if (date > today) {
+                throw ctx.fail('date_out_of_range', `Date ${date} is in the future.`, {
+                    ...ctx.recoveryFor('date_out_of_range'),
+                });
+            }
+        }
+        let resolved;
+        try {
+            resolved = await service.getRate(input.base_currency, input.quote_currency, date);
+        }
+        catch (err) {
+            const msg = err.message ?? '';
+            if (msg.includes('not found')) {
+                throw ctx.fail('unsupported_currency', `Currency "${input.base_currency}" or "${input.quote_currency}" is not supported by the ECB.`, { ...ctx.recoveryFor('unsupported_currency') });
+            }
+            throw err;
+        }
+        const quoteAmount = Math.round(input.amount * resolved.rate * 1_000_000) / 1_000_000;
+        ctx.log.info('Converted currency', {
+            base: resolved.baseCurrency,
+            quote: resolved.quoteCurrency,
+            amount: input.amount,
+            result: quoteAmount,
+            rate: resolved.rate,
+            date: resolved.rateDate,
+            snapped: resolved.dateSnapped,
+        });
+        return {
+            base_currency: resolved.baseCurrency,
+            quote_currency: resolved.quoteCurrency,
+            base_amount: input.amount,
+            quote_amount: quoteAmount,
+            rate: resolved.rate,
+            rate_date: resolved.rateDate,
+            date_snapped: resolved.dateSnapped,
+            rate_type: resolved.rateType,
+            source: resolved.source,
+        };
+    },
+    format: (result) => {
+        const snapNote = result.date_snapped
+            ? `\n⚠️ *Requested date snapped to ${result.rate_date} (weekend/holiday)*`
+            : '';
+        return [
+            {
+                type: 'text',
+                text: `**${result.base_amount} ${result.base_currency}** = **${result.quote_amount} ${result.quote_currency}**\n` +
+                    `Rate: ${result.rate} (${result.quote_currency}/${result.base_currency}) · ${result.rate_date}` +
+                    snapNote +
+                    `\n*${result.rate_type} · ${result.source}*`,
+            },
+        ];
+    },
+});
+//# sourceMappingURL=fx-convert-currency.tool.js.map

package/dist/mcp-server/tools/definitions/fx-convert-currency.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fx-convert-currency.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/fx-convert-currency.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/fx-dataframe-describe.tool.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @fileoverview fx_dataframe_describe — list tables and columns on a DataCanvas.
+ * @module mcp-server/tools/definitions/fx-dataframe-describe.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const fxDataframeDescribe: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    canvas_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    canvas_id: z.ZodString;
+    tables: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodString;
+        row_count: z.ZodNumber;
+        columns: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodString;
+            nullable: z.ZodBoolean;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    expires_at: z.ZodString;
+}, z.core.$strip>, readonly [{
+    readonly reason: "canvas_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "canvas_id does not exist or has been evicted.";
+    readonly recovery: "Re-run fx_get_timeseries to obtain a fresh canvas_id.";
+}], undefined>;
+//# sourceMappingURL=fx-dataframe-describe.tool.d.ts.map