Türkiye Central Bank (TCMB) Exchange Rates
Unofficial access to CBRT/TCMB daily exchange rates: latest, history since 1996, conversion.
¿Debería usar esto?
Calidad y seguridad
A
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
~2,806Tokens (definiciones de herramientas)
~6.0 KBTamaño de respuesta típico
Impacto significativo en la atención (2.19% del contexto de 128k)
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"tcmb-exchange-rates": {
"url": "https://foster-mcp.esakiz.workers.dev/mcp"
}
}
}Puntos de conexión remotos
https://foster-mcp.esakiz.workers.dev/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (4)
🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢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.
Esquema de entrada
{
"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"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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"
}Esquema de salida
{
"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.
Esquema de entrada
{
"type": "object",
"properties": {}
}Esquema de salida
{
"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
}Comunidad
Evidencia
Observaciones recientes
verificadoversión no registrada4 herramientas