Skip to main content
Glama
mcp-server-cnb-cache

mcp-server-cnb-cache

by Spoje-NET

mcp-server-cnb-cache

MCP server (stdio) giving AI assistants access to Czech National Bank (CNB) exchange rates through a cnb-cache instance. Rates are CZK per amount units of the foreign currency (JPY is quoted per 100).

Installation

sudo apt install mcp-server-cnb-cache            # the server
sudo apt install mcprack-mcp-server-cnb-cache    # registers it in mcprack

Related MCP server: FX Currency MCP Server

Configuration

Variable

Secret

Default

Meaning

CNB_CACHE_URL

no

http://localhost/cnb-cache/

Base URL of the cnb-cache web interface

CNB_CACHE_TIMEOUT

no

10

Request timeout in seconds

CNB_CACHE_TRANSPORT

no

stdio

MCP transport

CNB_CACHE_READ_ONLY

no

true

Accepted for uniformity; all tools are read-only

Tools

Tool

Annotation class

get_rate

READ_ONLY

list_currencies

READ_ONLY

convert_amount

READ_ONLY

get_rate_history

READ_ONLY (max 31 days)

Development

pytest
mcprack server probe mcp-server-cnb-cache

Available Tools

4 tools
convert_amountConvert AmountA
Read-onlyIdempotent

Convert an amount between CZK and a foreign currency (or two foreign currencies via CZK) using CNB rates of a given day.

Inputs: amount (required), to_currency (required), from_currency (required), date. Returns: object

get_rateGet Exchange RateA
Read-onlyIdempotent

Get the CNB exchange rate (CZK per amount units) of one currency for a given day.

Inputs: currency (required), age, date. Returns: object

get_rate_historyGet Rate HistoryA
Read-onlyIdempotent

Get daily CNB rates of one currency over a date range (max 31 days). Days without a published rate are skipped.

Inputs: currency (required), from_date (required), to_date. Returns: object

list_currenciesList Cached CurrenciesA
Read-onlyIdempotent

List the currency codes that the cnb-cache instance keeps.

Inputs: no named parameters. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct role: single-day rate lookup (get_rate), currency enumeration (list_currencies), currency conversion (convert_amount), and range history retrieval (get_rate_history). An agent can easily pick the right one based on whether it needs a point lookup, a list, a computation, or a time series.

    Naming Consistency5/5

    All four names follow a clean snake_case verb_noun pattern (get_rate, list_currencies, convert_amount, get_rate_history). No mixed conventions or vague verbs.

    Tool Count5/5

    Four tools is well-scoped for a narrow domain (CNB exchange-rate cache): one per core operation with no redundancy. Nothing feels padded or missing at the tool-count level.

    Completeness4/5

    Core lifecycle is covered: rate lookup, currency list, conversion, and historical range. Minor gaps exist, such as fetching the full daily rate sheet for all currencies at once or cache freshness metadata, but agents can work around these with the existing tools.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides access to currency exchange rates and conversion tools using the Frankfurter API, including latest rates, historical data, and time series from sources like the European Central Bank.
      5
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides real-time and historical foreign exchange rates for 31+ currencies, enabling currency conversion, historical rate lookups, and time series analysis using data from the Frankfurter API.
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables real-time currency exchange rate retrieval and conversion for over 200 currencies. Supports operations like getting rates, converting amounts, and comparing currencies through natural language.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides access to Croatian National Bank exchange rates without needing an API key, enabling currency conversion and rate queries through natural language.
      135 npm
      MIT