# Türkiye Central Bank (TCMB) Exchange Rates

> Türkiye Central Bank (TCMB) Exchange Rates is a free MCP server for finance and payments. Daily Central Bank of Türkiye exchange rates since 1996, with currency conversion. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API
- **Website:** https://foster-mcp.esakiz.workers.dev/llms.txt
- **MCP Registry name:** io.github.foster-ops/tcmb-exchange-rates
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-16

## About

Rates are quoted in Turkish lira per unit of foreign currency, taken from the central bank's daily bulletin published on business days at about 15:30 Türkiye time. Every response carries the bulletin date and a source link. On weekends and holidays the previous bulletin is returned and flagged as a fallback with a reason.

A few details matter for money work. Four rate types exist (forex buying and selling, banknote buying and selling), some currencies have no banknote rate, and rates apply per a stated unit, so yen is per 100. Decimals come back as strings to avoid float errors. Bulletins before 2005 are in old lira, at one million to one new lira. The registry entry calls the service unofficial and the rates indicative.

Conversions between two foreign currencies go through lira using the same rate type on both legs. The same host also exposes REST routes and a separate calendar MCP endpoint.

## Features

- **History to 1996:** Query any past bulletin date.
- **Four rate types:** Forex or banknote, buying or selling.
- **Currency conversion:** Convert between any pair, with lira on either side.
- **Fallback flag:** Weekend requests return the previous bulletin, marked as such.
- **String decimals:** Avoids floating-point rounding for money.
- **REST and MCP:** Same data over JSON endpoints and a remote MCP server.

## Good for

- Look up the USD rate on a past invoice date
- Convert an amount with the official selling rate
- Build a currency table for a Turkish report
- Check old-lira values in historical records

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http tcmb-exchange-rates https://foster-mcp.esakiz.workers.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://foster-mcp.esakiz.workers.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "tcmb-exchange-rates": {
      "url": "https://foster-mcp.esakiz.workers.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "tcmb-exchange-rates": {
      "type": "http",
      "url": "https://foster-mcp.esakiz.workers.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "tcmb-exchange-rates": {
      "serverUrl": "https://foster-mcp.esakiz.workers.dev/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://foster-mcp.esakiz.workers.dev/mcp
```

Enter a Name (for example "Türkiye Central Bank (TCMB) Exchange Rates"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "tcmb-exchange-rates": {
      "type": "http",
      "url": "https://foster-mcp.esakiz.workers.dev/mcp"
    }
  }
}
```

## Tools

- `get_latest_rates`: Returns the latest published bulletin.
- `get_rates_on_date`: Returns the bulletin for a date or the previous one.
- `convert_currency`: Converts an amount between currencies.
- `list_currencies`: Lists supported codes, units and rate types.

## FAQ

### How often is data published?

On business days around 15:30 Türkiye time.

### What happens on a holiday?

The previous bulletin comes back with is_fallback set and a reason.

### Is it official?

The registry entry describes it as unofficial; rates are indicative, so check tcmb.gov.tr for legal use.

### Is an API key required?

No, the host says it is free with no API key.

### Is Türkiye Central Bank (TCMB) Exchange Rates free?

Yes. Türkiye Central Bank (TCMB) Exchange Rates is free to use.

### How do I add Türkiye Central Bank (TCMB) Exchange Rates to Claude Code?

Run this command in your terminal: claude mcp add --transport http tcmb-exchange-rates https://foster-mcp.esakiz.workers.dev/mcp

### What are the best alternatives to Türkiye Central Bank (TCMB) Exchange Rates?

The closest alternatives to Türkiye Central Bank (TCMB) Exchange Rates are Faceabot Exchange rates, Central Bank Rates (AllRatesToday), Ortak Alan, Hasfiyat Altın API and CurrencyKit.

## Where this comes from

- Description: written from the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Faceabot Exchange rates](https://ai-powered.com/mcp/faceabot-exchange-rates): Faceabot Exchange rates is a free MCP server for finance and payments.
- [Central Bank Rates (AllRatesToday)](https://ai-powered.com/mcp/central-bank-rates-allratestoday): Central Bank Rates (AllRatesToday) is a freemium MCP server for finance and payments.
- [Ortak Alan](https://ai-powered.com/mcp/ortak-alan): Ortak Alan is a free MCP server for analytics and data.
- [Hasfiyat Altın API](https://ai-powered.com/mcp/hasfiyat-alt-n-api): Hasfiyat Altın API is an MCP server for finance and payments.
- [CurrencyKit](https://ai-powered.com/mcp/currencykit): CurrencyKit is a freemium MCP server for finance and payments.
- [ECB exchange rates](https://ai-powered.com/mcp/ecb-exchange-rates): ECB exchange rates is an open-source MCP server for finance and payments.
- [BNR exchange rates](https://ai-powered.com/mcp/bnr-exchange-rates): BNR exchange rates is a free MCP server for finance and payments.
- [NetArz FX Rates](https://ai-powered.com/mcp/netarz-fx-rates): NetArz FX Rates is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/turkiye-central-bank-tcmb-exchange-rates
