TCMB FX Rates

io.github.mohammad-abbasi-shPublished by GitHub account mohammad-abbasi-shv0.1.1Updated Nov 4, 2026

Unofficial read-only MCP server for TCMB indicative FX rates — live TRY rates for 22 currencies.

VerifiedSTDIODesktop only

Overview

TCMB FX Rates's local MCP server; no sign-in required; STDIO; 4 tools.

No AI overview yet: these facts come from the registry entry and the server itself.

Installation

In SourceWeft

  1. Open TCMB FX Rates in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

tcmb-mcp 🇹🇷

mcp-name: io.github.mohammad-abbasi-sh/tcmb-mcp

Unofficial read-only MCP server for the Central Bank of the Republic of Türkiye (TCMB) indicative exchange rates — live TRY rates for 22 currencies, plus history.

Pilot of the "Turkey MCP factory" (Sepehr-style pipeline). Not affiliated with TCMB.

For AI agents

Add to your MCP client config (stdio):

json
{  "mcpServers": {    "tcmb": {      "command": "uvx",      "args": ["tcmb-mcp"]    }  }}

Or run locally: python -m tcmb_mcp.server (needs mcp<2, httpx).

Tools

ToolDescription
tcmb_get_ratesToday's indicative rates for all 22 currencies (TRY)
tcmb_get_rateOne currency today — code: USD, EUR, GBP… (case-insensitive)
tcmb_list_currenciesAll currency codes + names in today's bulletin
tcmb_get_rates_onHistorical rates — date: YYYY-MM-DD (business days only)

Example output (tcmb_get_rate / USD):

json
{"date": "03.11.2026", "code": "USD", "name": "US DOLLAR", "unit": 1, "forex_buying": 49.9094, "forex_selling": 49.9993, "banknote_buying": 49.8744, "banknote_selling": 50.0743}

Notes:

  • Rates are Turkish Lira per <unit> of foreign currency.
  • Forex = interbank; banknote = physical cash.
  • TCMB publishes no bulletin on weekends/holidays (tcmb_get_rates_on returns an error then).
  • Data: TCMB public feed tcmb.gov.tr/kurlar — no key, no login, read-only.

Development

bash
python3 -m venv .venv && .venv/bin/pip install "mcp<2" httpx pytest.venv/bin/python -m pytest tests/ -q
  • tests/test_rates.py — offline, parses a real captured bulletin fixture
  • tests/test_live.py — 2 cautious live requests against tcmb.gov.tr

License

MIT

Source: README.md at commit 0dbf6b2

Tools

4

tcmb_get_rates

Today's TCMB indicative exchange rates for all currencies (TRY).

Takes no parameters.

tcmb_get_rate

One currency's rates today. code: ISO code like USD, EUR, GBP (case-insensitive).

Parameterscoderequired

tcmb_list_currencies

List all currency codes and names in today's TCMB bulletin.

Takes no parameters.

tcmb_get_rates_on

Historical TCMB rates for a date (YYYY-MM-DD). Business days only — no bulletin on weekends/holidays.

Parametersdaterequired

Version history

1
  1. v0.1.1LatestNov 4, 2026

Score

80% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.