Türkiye Central Bank (TCMB) Exchange Rates

Unofficial access to CBRT/TCMB daily exchange rates: latest, history since 1996, conversion.

Sollte ich dies verwenden

Qualität und Sicherheit

A
Qualität der Beschreibung
100%
Vollständigkeit des Schemas
79%
Qualität der Benennung
100%
Risiko der Vergiftung
100%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~2,806Tokens (Tool-Definitionen)
~6.0 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (2.19% von 128k Kontext)

Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.

Installieren

Installation mit einem Klick

Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:

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

Remote-Endpunkte

https://foster-mcp.esakiz.workers.dev/mcpstreamable-http

Was es kann

Tool-Inventar

Tools (4)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢get_latest_rates(currencies)

Returns the most recent TCMB exchange-rate bulletin (TRY per unit of foreign currency). Source: Central Bank of the Republic of Türkiye (CBRT/TCMB) daily indicative bulletin, published on business days around 15:30 Türkiye time (UTC+3). Rates are TRY per `unit` of currency (JPY is per 100). Decimals are strings. Every result includes source_url, bulletin_date and a disclaimer; rates are indicative, not for official use.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "currencies": {
      "description": "Currency codes to include; omit for all (about 20 currencies)",
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Za-z]{3}$",
        "description": "ISO 4217 code, e.g. USD"
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "source": {
      "type": "string",
      "const": "TCMB"
    },
    "source_url": {
      "type": "string",
      "format": "uri"
    },
    "bulletin_date": {
      "type": "string"
    },
    "bulletin_no": {
      "type": [
        "string",
        "null"
      ]
    },
    "requested_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "is_fallback": {
      "type": "boolean"
    },
    "fallback_reason": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "no_bulletin_weekend_or_holiday",
            "not_yet_published"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "domestic_currency": {
      "type": "string",
      "enum": [
        "TRY",
        "TRL"
      ]
    },
    "retrieved_at": {
      "type": "string"
    },
    "rates": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "name_tr": {
            "type": "string"
          },
          "name_en": {
            "type": "string"
          },
          "unit": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "forex_buying": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d+(\\.\\d+)?$"
              },
              {
                "type": "null"
              }
            ]
          },
          "forex_selling": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d+(\\.\\d+)?$"
              },
              {
                "type": "null"
              }
            ]
          },
          "banknote_buying": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d+(\\.\\d+)?$"
              },
              {
                "type": "null"
              }
            ]
          },
          "banknote_selling": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d+(\\.\\d+)?$"
              },
              {
                "type": "null"
              }
            ]
          },
          "cross_rate_usd": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d+(\\.\\d+)?$"
              },
              {
                "type": "null"
              }
            ]
          },
          "cross_rate_other": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d+(\\.\\d+)?$"
              },
              {
                "type": "null"
              }
            ]
          },
          "cross_rate_euro": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d+(\\.\\d+)?$"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "code",
          "name_tr",
          "name_en",
          "unit",
          "forex_buying",
          "forex_selling",
          "banknote_buying",
          "banknote_selling",
          "cross_rate_usd",
          "cross_rate_other"
        ],
        "additionalProperties": false
      }
    },
    "disclaimer": {
      "type": "string"
    }
  },
  "required": [
    "source",
    "source_url",
    "bulletin_date",
    "bulletin_no",
    "requested_date",
    "is_fallback",
    "fallback_reason",
    "domestic_currency",
    "retrieved_at",
    "rates",
    "disclaimer"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢get_rates_on_date(date, currencies)

Returns the TCMB bulletin published on a given date (history back to 1996). If no bulletin was published that day (weekend, holiday, or today before ~15:30 TRT), returns the previous bulletin with is_fallback=true and a fallback_reason. Bulletins before 2005-01-01 are in old Turkish lira (domestic_currency TRL). Source: Central Bank of the Republic of Türkiye (CBRT/TCMB) daily indicative bulletin, published on business days around 15:30 Türkiye time (UTC+3). Rates are TRY per `unit` of currency (JPY is per 100). Decimals are strings. Every result includes source_url, bulletin_date and a disclaimer; rates are indicative, not for official use.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Bulletin date, YYYY-MM-DD"
    },
    "currencies": {
      "description": "Currency codes to include; omit for all (about 20 currencies)",
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Za-z]{3}$",
        "description": "ISO 4217 code, e.g. USD"
      }
    }
  },
  "required": [
    "date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "source": {
      "type": "string",
      "const": "TCMB"
    },
    "source_url": {
      "type": "string",
      "format": "uri"
    },
    "bulletin_date": {
      "type": "string"
    },
    "bulletin_no": {
      "type": [
        "string",
        "null"
      ]
    },
    "requested_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "is_fallback": {
      "type": "boolean"
    },
    "fallback_reason": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "no_bulletin_weekend_or_holiday",
            "not_yet_published"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "domestic_currency": {
      "type": "string",
      "enum": [
        "TRY",
        "TRL"
      ]
    },
    "retrieved_at": {
      "type": "string"
    },
    "rates": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "name_tr": {
            "type": "string"
          },
          "name_en": {
            "type": "string"
          },
          "unit": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "forex_buying": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d+(\\.\\d+)?$"
              },
              {
                "type": "null"
              }
            ]
          },
          "forex_selling": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d+(\\.\\d+)?$"
              },
              {
                "type": "null"
              }
            ]
          },
          "banknote_buying": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d+(\\.\\d+)?$"
              },
              {
                "type": "null"
              }
            ]
          },
          "banknote_selling": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d+(\\.\\d+)?$"
              },
              {
                "type": "null"
              }
            ]
          },
          "cross_rate_usd": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d+(\\.\\d+)?$"
              },
              {
                "type": "null"
              }
            ]
          },
          "cross_rate_other": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d+(\\.\\d+)?$"
              },
              {
                "type": "null"
              }
            ]
          },
          "cross_rate_euro": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d+(\\.\\d+)?$"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "code",
          "name_tr",
          "name_en",
          "unit",
          "forex_buying",
          "forex_selling",
          "banknote_buying",
          "banknote_selling",
          "cross_rate_usd",
          "cross_rate_other"
        ],
        "additionalProperties": false
      }
    },
    "disclaimer": {
      "type": "string"
    }
  },
  "required": [
    "source",
    "source_url",
    "bulletin_date",
    "bulletin_no",
    "requested_date",
    "is_fallback",
    "fallback_reason",
    "domestic_currency",
    "retrieved_at",
    "rates",
    "disclaimer"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢convert_currency(from, to, amount, date, rate_type)

Converts an amount between two currencies using TCMB rates. TRY may be either side. Cross conversions (e.g. USD to EUR) go through TRY using the same rate_type on both legs. Returns the result (6 decimals), the effective rate and a calculation breakdown. Omit date for the latest bulletin. Source: Central Bank of the Republic of Türkiye (CBRT/TCMB) daily indicative bulletin, published on business days around 15:30 Türkiye time (UTC+3). Rates are TRY per `unit` of currency (JPY is per 100). Decimals are strings. Every result includes source_url, bulletin_date and a disclaimer; rates are indicative, not for official use.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Source currency, ISO 4217 (TRY allowed)"
    },
    "to": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Target currency, ISO 4217 (TRY allowed)"
    },
    "amount": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number",
          "exclusiveMinimum": 0
        }
      ],
      "description": "Positive amount; a string like \"1234.56\" preserves precision"
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Bulletin date, YYYY-MM-DD"
    },
    "rate_type": {
      "default": "forex_selling",
      "description": "TCMB rate to use. forex_* are for transfers, banknote_* for cash; some currencies lack banknote rates.",
      "type": "string",
      "enum": [
        "forex_buying",
        "forex_selling",
        "banknote_buying",
        "banknote_selling"
      ]
    }
  },
  "required": [
    "from",
    "to",
    "amount"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "source": {
      "type": "string",
      "const": "TCMB"
    },
    "source_url": {
      "type": "string",
      "format": "uri"
    },
    "bulletin_date": {
      "type": "string"
    },
    "bulletin_no": {
      "type": [
        "string",
        "null"
      ]
    },
    "requested_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "is_fallback": {
      "type": "boolean"
    },
    "fallback_reason": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "no_bulletin_weekend_or_holiday",
            "not_yet_published"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "domestic_currency": {
      "type": "string",
      "enum": [
        "TRY",
        "TRL"
      ]
    },
    "retrieved_at": {
      "type": "string"
    },
    "query": {
      "type": "object",
      "properties": {
        "from": {
          "type": "string"
        },
        "to": {
          "type": "string"
        },
        "amount": {
          "type": "string"
        },
        "rate_type": {
          "type": "string",
          "enum": [
            "forex_buying",
            "forex_selling",
            "banknote_buying",
            "banknote_selling"
          ]
        }
      },
      "required": [
        "from",
        "to",
        "amount",
        "rate_type"
      ],
      "additionalProperties": false
    },
    "result": {
      "type": "string",
      "pattern": "^\\d+(\\.\\d+)?$"
    },
    "rate": {
      "type": "string",
      "pattern": "^\\d+(\\.\\d+)?$"
    },
    "calculation": {
      "type": "object",
      "properties": {
        "rate_type": {
          "type": "string",
          "enum": [
            "forex_buying",
            "forex_selling",
            "banknote_buying",
            "banknote_selling"
          ]
        },
        "via": {
          "type": "string",
          "enum": [
            "TRY",
            "TRL"
          ]
        },
        "legs": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "currency": {
                "type": "string"
              },
              "rate": {
                "type": "string",
                "pattern": "^\\d+(\\.\\d+)?$"
              },
              "unit": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              "quote": {
                "type": "string"
              }
            },
            "required": [
              "currency",
              "rate",
              "unit",
              "quote"
            ],
            "additionalProperties": false
          }
        },
        "formula": {
          "type": "string"
        },
        "note": {
          "type": "string"
        },
        "rounding": {
          "type": "string"
        }
      },
      "required": [
        "rate_type",
        "via",
        "legs",
        "formula",
        "note",
        "rounding"
      ],
      "additionalProperties": false
    },
    "disclaimer": {
      "type": "string"
    }
  },
  "required": [
    "source",
    "source_url",
    "bulletin_date",
    "bulletin_no",
    "requested_date",
    "is_fallback",
    "fallback_reason",
    "domestic_currency",
    "retrieved_at",
    "query",
    "result",
    "rate",
    "calculation",
    "disclaimer"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢list_currencies

Lists currencies in the latest TCMB bulletin with English/Turkish names, quoting unit and which rate types are published for each. Use it to check codes before calling the other tools.

Eingabe-Schema

{
  "type": "object",
  "properties": {}
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "source": {
      "type": "string",
      "const": "TCMB"
    },
    "as_of_bulletin": {
      "type": "string"
    },
    "domestic_currency": {
      "type": "string",
      "enum": [
        "TRY",
        "TRL"
      ]
    },
    "currencies": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "name_en": {
            "type": "string"
          },
          "name_tr": {
            "type": "string"
          },
          "unit": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "rate_types": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "forex_buying",
                "forex_selling",
                "banknote_buying",
                "banknote_selling"
              ]
            }
          }
        },
        "required": [
          "code",
          "name_en",
          "name_tr",
          "unit",
          "rate_types"
        ],
        "additionalProperties": false
      }
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "disclaimer": {
      "type": "string"
    }
  },
  "required": [
    "source",
    "as_of_bulletin",
    "domestic_currency",
    "currencies",
    "notes",
    "disclaimer"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Community

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet4 Tools