Back to Browse

Tcmb MCP Server

Developer ToolsLow Risk8.3MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

8.3
Low Risk8.3Low Risk

Valid MCP server (1 strong, 4 medium validity signals). 4 known CVEs in dependencies Imported from the Official MCP Registry. Trust signals: trusted author (3/3 approved). 1 finding(s) downgraded by scanner intelligence.

10 files analyzed · 5 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

file_system

Check that this permission is expected for this type of plugin.

How to Install

Add this to your MCP configuration file:

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

Some servers take additional arguments. See the repository for details.

Documentation

View on GitHub

From the project's GitHub 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):

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

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):

{"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

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


Built by Mohammad Abbasi — Almanibama · mabbasi.ir

Reviews

No reviews yet

Be the first to review this server!