Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

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

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

[mcp_servers.exchange-rates-mcp-server]
url = "https://exchange-rates.caseyjhand.com/mcp"

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "exchange-rates-mcp-server": {
      "type": "remote",
      "url": "https://exchange-rates.caseyjhand.com/mcp",
      "enabled": true
    }
  }
}

{
  "mcpServers": {
    "exchange-rates-mcp-server": {
      "type": "http",
      "url": "https://exchange-rates.caseyjhand.com/mcp"
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=exchange-rates-mcp-server&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vZXhjaGFuZ2UtcmF0ZXMuY2FzZXlqaGFuZC5jb20vbWNwIn0%3D"
}

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

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

extensions:
  "exchange-rates-mcp-server":
    enabled: true
    name: "exchange-rates-mcp-server"
    type: streamable_http
    uri: "https://exchange-rates.caseyjhand.com/mcp"
    timeout: 300

Quality 86 / 100good

protocol88 · weight 25

pass
protocol.modernsupports 2026-07-28 (server/discover)
pass
protocol.statelessanswers without a session
pass
protocol.transportstreamable HTTP
warn
protocol.list_ttltools/list declares ttlMs 0, so clients re-fetch it on every use

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene79 · weight 30

pass
tools.descriptionsevery tool has a description
warn
tools.description_length1 tools have descriptions over 1,024 characters, which crowds the context
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations7 of 7 tools declare readOnlyHint or destructiveHint
fail
tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: fx_list_currencies (destructiveHint); fx_get_rate (destructiveHint); fx_get_rates (destructiveHint); …
pass
tools.token_costabout 2,158 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stability100 · weight 15

pass
stability.changesno tool changes in 30 days
pass
stability.rug_pullno tool changed its meaning under the same name

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvabledeps.dev does not know @cyanheads/[email protected], @cyanheads/[email protected]

7 tools, about 2,158 tokens to load them all · tool set 6ff43da7c8aa · checked 2026-10-19 20:38 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 94 / 100

provenance80

liveness100

freshness100

hygiene100

+repository +namespace-matches-repo +reachable +uptime-100% +updated-16d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Dependencies

@cyanheads/[email protected] npmthis version is not known to the dependency resolver

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://exchange-rates.caseyjhand.com/mcp` streamable-http	none	yes	100%	177 ms	2026-07-28	2026-10-19

package	registry	version	runtime	secrets
`@cyanheads/exchange-rates-mcp-server`	npm	0.4.2	npx
`@cyanheads/exchange-rates-mcp-server`	npm	0.4.2	npx

Tools (7)

`fx_convert_currency`read-only	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.
`fx_dataframe_describe`read-only	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 (CANVAS_PROVIDER_TYPE=duckdb) — without it this tool is not listed at all and fx_get_timeseries returns every range inline.
`fx_dataframe_query`read-only	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 (CANVAS_PROVIDER_TYPE=duckdb) — without it this tool is not listed at all and fx_get_timeseries returns every range inline.
`fx_get_rate`read-only	Get the exchange rate for a currency pair on a given date (default: latest). Returns the rate, the actual rate date (which may differ from the requested date on weekends/holidays — ECB publishes business days only), and source provenance. Cross-rates are triangulated through EUR automatically. A same-currency pair returns a rate of 1, dated to the same publication day any other pair would report for that date. Use fx_convert_currency when you want the converted amount; use this tool when you only need the rate number.
`fx_get_rates`read-only	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 from a weekend/holiday to the prior business day. Optionally filter to a subset of quote currencies via symbols. Listing the base currency itself in symbols is accepted and returns a rate of 1 for it.
`fx_get_timeseries`read-only	Get historical daily exchange rates for a currency pair over a date range. ECB publishes on business days only — weekends and holidays produce no entry, and no date outside the requested range is ever returned, so a range covering only non-publication days comes back with an empty rates map and a notice explaining why. A same-currency pair returns a rate of 1 on each publication day in the range. Inline results are returned as a date→rate map paged at 500 publication days: rate_count is always the total for the requested range, and when a page is cut short the response carries truncated=true and next_start_date — call again with start_date set to next_start_date and the same end_date for the next page. When DataCanvas is enabled (CANVAS_PROVIDER_TYPE=duckdb) long ranges (>90 days by default) spill to it instead: the response carries spilled=true, a canvas_id, and a table_name — call fx_dataframe_describe to inspect the staged table, then fx_dataframe_query to run SQL against it. Without DataCanvas long ranges are paged inline (spilled=false) and the notice says so.
`fx_list_currencies`read-only	List all supported ISO 4217 currency codes with their full names. Call this before converting to disambiguate "dollars" (USD vs AUD vs CAD vs HKD vs SGD) or to validate a user-supplied currency code. Covers the ~30 ECB reference currencies.

Schemas: list_tools.

Similar MCP servers

More from io.github.cyanheads

And 136 more from this publisher.

Official server.json

{
  "name": "io.github.cyanheads/exchange-rates-mcp-server",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://exchange-rates.caseyjhand.com/mcp",
      "type": "streamable-http"
    }
  ],
  "version": "0.4.2",
  "packages": [
    {
      "version": "0.4.2",
      "transport": {
        "type": "stdio"
      },
      "identifier": "@cyanheads/exchange-rates-mcp-server",
      "runtimeHint": "npx",
      "registryType": "npm",
      "registryBaseUrl": "https://registry.npmjs.org",
      "environmentVariables": [
        {
          "name": "FRANKFURTER_BASE_URL",
          "format": "string",
          "default": "https://api.frankfurter.dev/v1",
          "description": "Frankfurter API base URL. Override for local testing or self-hosted instances."
        },
        {
          "name": "FX_TIMESERIES_CANVAS_THRESHOLD_DAYS",
          "format": "string",
          "default": "90",
          "description": "Day range above which fx_get_timeseries spills results to DataCanvas for SQL analytics, when DataCanvas is enabled (CANVAS_PROVIDER_TYPE=duckdb). Longer ranges return inline otherwise."
        },
        {
          "name": "FX_ENABLE_CANVAS_DROP",
          "format": "string",
          "default": "false",
          "description": "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."
        },
        {
          "name": "MCP_LOG_LEVEL",
          "format": "string",
          "default": "info",
          "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn')."
        }
      ]
    },
    {
      "version": "0.4.2",
      "transport": {
        "url": "http://localhost:3010/mcp",
        "type": "streamable-http"
      },
      "identifier": "@cyanheads/exchange-rates-mcp-server",
      "runtimeHint": "npx",
      "registryType": "npm",
      "registryBaseUrl": "https://registry.npmjs.org",
      "environmentVariables": [
        {
          "name": "MCP_TRANSPORT_TYPE",
          "value": "http",
          "format": "string",
          "description": "Selects the HTTP transport."
        },
        {
          "name": "FRANKFURTER_BASE_URL",
          "format": "string",
          "default": "https://api.frankfurter.dev/v1",
          "description": "Frankfurter API base URL. Override for local testing or self-hosted instances."
        },
        {
          "name": "FX_TIMESERIES_CANVAS_THRESHOLD_DAYS",
          "format": "string",
          "default": "90",
          "description": "Day range above which fx_get_timeseries spills results to DataCanvas for SQL analytics, when DataCanvas is enabled (CANVAS_PROVIDER_TYPE=duckdb). Longer ranges return inline otherwise."
        },
        {
          "name": "FX_ENABLE_CANVAS_DROP",
          "format": "string",
          "default": "false",
          "description": "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."
        },
        {
          "name": "MCP_HTTP_HOST",
          "format": "string",
          "default": "127.0.0.1",
          "description": "The hostname for the HTTP server."
        },
        {
          "name": "MCP_HTTP_PORT",
          "format": "string",
          "default": "3010",
          "description": "The port to run the HTTP server on."
        },
        {
          "name": "MCP_HTTP_ENDPOINT_PATH",
          "format": "string",
          "default": "/mcp",
          "description": "The endpoint path for the MCP server."
        },
        {
          "name": "MCP_AUTH_MODE",
          "format": "string",
          "default": "none",
          "description": "Authentication mode to use: 'none', 'jwt', or 'oauth'."
        },
        {
          "name": "MCP_LOG_LEVEL",
          "format": "string",
          "default": "info",
          "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn')."
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/cyanheads/exchange-rates-mcp-server",
    "source": "github"
  },
  "description": "Convert currencies, get FX rates, and query historical ECB exchange rate data."
}