Skip to main content
Glama
nbk-mcp

nbk-mcp

by theYahia

@theyahia/nbk-mcp

npm version License: MIT

Курсы валют Национального Банка Казахстана. 5 инструментов. Без авторизации.

MCP-сервер для получения курсов валют НБК, конвертации и отслеживания динамики. Данные берутся напрямую из официального RSS-канала nationalbank.kz.

Quick Start

Claude Desktop

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "nbk": {
      "command": "npx",
      "args": ["-y", "@theyahia/nbk-mcp"]
    }
  }
}

Claude Code

claude mcp add nbk -- npx -y @theyahia/nbk-mcp

Cursor

Добавьте в .cursor/mcp.json:

{
  "mcpServers": {
    "nbk": {
      "command": "npx",
      "args": ["-y", "@theyahia/nbk-mcp"]
    }
  }
}

Related MCP server: TCMB MCP

Инструменты

Инструмент

Описание

Параметры

get_all_rates

Все текущие курсы валют НБК

нет

get_currency_rate

Курс конкретной валюты

currency_code, date?

get_historical_rates

Курсы на определённую дату

date (DD.MM.YYYY)

convert_currency

Конвертация между валютами

amount, from_currency, to_currency?, date?

get_rate_dynamics

Динамика курса (рост/падение)

currency_code

Примеры

  • "Какой курс доллара к тенге?"

  • "Переведи 100000 тенге в рубли"

  • "Покажи все курсы валют на сегодня"

  • "Какой был курс евро 01.01.2025?"

  • "Доллар растёт или падает?"

HTTP-режим

npx @theyahia/nbk-mcp --http
# или
HTTP_PORT=8080 npx @theyahia/nbk-mcp --http

Эндпоинты:

  • POST /mcp — Streamable HTTP transport

  • GET /health — проверка здоровья

Часть серии Russian & CIS API MCP

Смотрите также: russian-mcp

Лицензия

MIT

Available Tools

5 tools
convert_currencyA

Convert between currencies using NBK rates. One side must be KZT.

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

get_all_ratesA

Get all current currency exchange rates from the National Bank of Kazakhstan

Inputs: no named parameters.

get_currency_rateB

Get the exchange rate for a specific currency from the National Bank of Kazakhstan

Inputs: currency_code (required), date.

get_historical_ratesA

Get all currency exchange rates for a specific date from the National Bank of Kazakhstan

Inputs: date (required).

get_rate_dynamicsA

Get the current rate with change direction for a currency (shows if rate went UP or DOWN)

Inputs: currency_code (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 5 tools

    Disambiguation4/5

    Tools are mostly distinct: get_all_rates, get_currency_rate, get_historical_rates, convert_currency, and get_rate_dynamics each serve a clear purpose. Slight overlap exists between get_currency_rate and get_rate_dynamics since both return current rates, but the latter adds change direction, making the distinction clear.

    Naming Consistency4/5

    All tool names follow a verb_noun pattern (get_ or convert_), using snake_case consistently. Minor deviation is the use of 'convert' instead of 'get', but it is still a clear verb and fits the pattern.

    Tool Count5/5

    With 5 tools, the server is well-scoped for a currency rate service. Each tool covers a distinct aspect (all rates, specific rate, historical, conversion, dynamics) without unnecessary bloat.

    Completeness5/5

    The tool set covers the core lifecycle of accessing exchange rates: current, specific currency, historical, conversion, and dynamics. No significant gaps are apparent for the stated purpose of NBK rates.

    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
    • A
      license
      B
      quality
      D
      maintenance
      Provides access to Turkish Central Bank (TCMB) exchange rates with current and historical data since 1996, currency conversion, rate history statistics, and multi-currency comparisons with smart caching.
      6
      1
      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.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables real-time currency exchange rate lookup, conversion, historical rates, and currency catalog using the free Frankfurter API, no API key required.
      ISC