TCMB

TCMB döviz kurları için MCP server

python

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "ofurkanuygur-tcmb_mcp": {
      "command": "python",
      "args": [
        "-m",
        "tcmb_mcp"
      ],
      "env": {
        "PORT": "8080",
        "TCMB_DEBUG": "false",
        "TCMB_TIMEOUT": "10",
        "MCP_TRANSPORT": "stdio",
        "TCMB_LOG_LEVEL": "INFO",
        "TCMB_MAX_RETRIES": "3",
        "TCMB_CACHE_DB_PATH": "~/.cache/tcmb-mcp/tcmb_cache.db",
        "TCMB_CACHE_ENABLED": "true",
        "TCMB_CACHE_TTL_TODAY": "3600",
        "TCMB_CACHE_TTL_HISTORICAL": "31536000"
      }
    }
  }
}

A production-ready MCP server that serves Turkish Central Bank exchange rates. You can query current and historical TCMB rates, convert between currencies (including Turkish Lira), and explore rate history across time. This MVP-style server is designed for easy integration with MCP clients and supports simple caching, holidays, and multi-currency comparisons.

How to use

You run the TCMB MCP server locally and connect your MCP client to it to fetch current rates, historical data, perform currency conversions, and analyze rate histories. Start the server in stdio mode for Claude Desktop usage, or run in HTTP mode for remote deployments where a transport is provided. Use the available tools to query current rates, historical dates, conversion results, and trend analyses.

How to install

Prerequisites: Python 3.8+ and a Python virtual environment (optional but recommended). You can also use the Smithery flow for quick deployment.

# Smithery (Recommended)
npx -y @smithery/cli install @ofurkanuygur/tcmb_mcp --client claude

# Local development with uv
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 .

# Python package installation
pip install tcmb-mcp

Configuration and run

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

Starting and testing the server

To start in stdio mode (for Claude Desktop): run the Python module directly. To enable HTTP transport when you deploy, set MCP_TRANSPORT=http before starting, which switches the server into HTTP mode if supported by your deployment.

Notes on environment and usage

Environment variables shown in the configuration control caching and debugging. You can adjust them to tune performance and logs.

Available tools

tcmb_get_current_rates

Fetches current exchange rates from TCMB for specified currencies.

tcmb_get_historical_rates

Retrieves exchange rates for a specific date, returning values for that day.

tcmb_list_currencies

Lists all available currencies supported by TCMB data.

tcmb_convert_currency

Converts a specified amount from one currency to another.

tcmb_get_rate_history

Provides a historical view of a currency with statistics over a date range.

tcmb_compare_currencies

Compares multiple currencies over a time range.

Built by

VeilStrat

AI signals for GTM teams