tcmb_mcp

Production-ready MCP (Model Context Protocol) server for Turkish Central Bank (TCMB) exchange rates.

[](https://smithery.ai/server/@ofurkanuygur/tcmb_mcp)

• Current Rates: Get today's exchange rates from TCMB
• Historical Rates: Query rates for any date since 1996
• Currency Conversion: Convert between any currencies (including TRY)
• Rate History: Get rate history with statistics (min, max, avg, change %)
• Multi-Currency Comparison: Compare multiple currencies over time
• Smart Caching: SQLite-based cache with configurable TTL
• Holiday Support: Automatic fallback to previous business day
• Turkish Holidays: Includes all official and religious holidays

Install directly via Smithery:

npx -y @smithery/cli install @ofurkanuygur/tcmb_mcp --client claude

git clone https://github.com/ofurkanuygur/tcmb_mcp.git
cd tcmb_mcp
uv venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
uv pip install -e .

pip install tcmb-mcp

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "tcmb": {
      "command": "python",
      "args": ["-m", "tcmb_mcp"],
      "env": {
        "TCMB_CACHE_ENABLED": "true",
        "TCMB_DEBUG": "false"
      }
    }
  }
}

# stdio mode (default, for Claude Desktop)
python -m tcmb_mcp

# HTTP mode (for Smithery deployment)
MCP_TRANSPORT=http python -m tcmb_mcp

npx @modelcontextprotocol/inspector python -m tcmb_mcp