Skip to content
MCP server

Türkiye Central Bank (TCMB) Exchange Rates

Daily Central Bank of Türkiye exchange rates since 1996, with currency conversion

Install
Pricing
Free
Platforms
API
Runs
Remotely
Version
1.0.0
Listing updated
3 days ago

Similar MCP servers

About Türkiye Central Bank (TCMB) Exchange Rates

Türkiye Central Bank (TCMB) Exchange Rates is a free MCP server for finance and payments. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://foster-mcp.esakiz.workers.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tcmb-exchange-rates": {
      "url": "https://foster-mcp.esakiz.workers.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to Grok Bot desktop app → Connect apps → Add a custom connector

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.

Full Grok Bot setup guide

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Free

Free, no API key

Prices change. Check foster-mcp.esakiz.workers.dev before you buy.

Türkiye Central Bank (TCMB) Exchange Rates 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.

How AIPoweredBot checks servers