{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_99kearsm67f5","handle":"mcp-tcmb-exchange","url":"https://wellknown.network/agents/mcp-tcmb-exchange","links":{"self":"https://wellknown.network/agents/mcp-tcmb-exchange/record.json","html":"https://wellknown.network/agents/mcp-tcmb-exchange","markdown":"https://wellknown.network/agents/mcp-tcmb-exchange/record.md","api":"https://wellknown.network/api/v1/agents/mcp-tcmb-exchange","status":"https://wellknown.network/api/v1/agents/mcp-tcmb-exchange/status","claim":"https://wellknown.network/agents/mcp-tcmb-exchange/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-tcmb-exchange/claim.json","badge":"https://wellknown.network/agents/mcp-tcmb-exchange/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-tcmb-exchange/history","tools":"https://wellknown.network/api/v1/agents/mcp-tcmb-exchange/tools"},"ard":{"identifier":"urn:air::server:mcp-tcmb-exchange","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-tcmb-exchange","summary":"TCMB (Türkiye Cumhuriyet Merkez Bankası) döviz kurlarını MCP protokolü üzerinden sunan server","description":"# 🏦 mcp-tcmb-exchange\n\n[![PyPI Version](https://img.shields.io/pypi/v/mcp-tcmb-exchange.svg)](https://pypi.org/project/mcp-tcmb-exchange/)\n[![Python Version](https://img.shields.io/pypi/pyversions/mcp-tcmb-exchange.svg)](https://pypi.org/project/mcp-tcmb-exchange/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n**TCMB (Türkiye Cumhuriyet Merkez Bankası)** resmi günlük döviz kurlarını **MCP (Model Context Protocol)** üzerinden AI asistanlarına (Claude, Cursor, Gemini vb.) sunan güçlü ve güvenilir bir Python sunucusudur.\n\n---\n\n## ✨ Özellikler\n\n- **Gerçek Zamanlı Veri:** TCMB'nin güncel döviz kurlarına anında erişim.\n- **Hassas Hesaplama:** Tamamı `Decimal` kullanılarak geliştirilmiş, yuvarlama hatalarından arındırılmış finansal hesaplamalar.\n- **Geçmiş Tarih Desteği:** İstenilen tarihteki (YYYY-MM-DD) kurları sorgulayabilme.\n- **Çoklu Çeviri:** Tek bir tutarı aynı anda birden fazla döviz cinsine çevirebilme.\n- **Hızlı ve Asenkron:** `httpx` ve asenkron mimari ile gecikmesiz haberleşme.\n- **Dahili Önbellekleme:** Gereksiz ağ isteklerini önlemek için 30 dakikalık memory cache.\n\n## 🛠️ MCP Araçları (Tools)\n\nBu sunucu, AI asistanlarına aşağıdaki araçları sağlar:\n\n| Araç Adı | Açıklama | Zorunlu Parametreler |\n|----------|----------|----------------------|\n| `get_exchange_rate` | Tek bir dövizin günlük TCMB kurunu getirir. | `currency_code` (Örn: USD, EUR) |\n| `list_all_rates` | Tüm TCMB kurlarını detaylı olarak listeler. | *Yok* |\n| `convert_currency` | TL↔Döviz veya Döviz↔Döviz arasında çeviri yapar. | `amount`, `from_currency`, `to_currency` |\n| `convert_to_multiple` | Bir tutarı aynı anda birçok farklı dövize çevirir. | `amount`, `target_currencies` |\n\n*Not: Tüm araçlar opsiyonel olarak `date` (YYYY-MM-DD) parametresi alabilir. Belirtilmezse o günkü güncel kur kullanılır.*\n\n## 🚀 Çalıştırma Yöntemleri\n\nSunucuyu sisteminizde çalıştırmak için aşağıdaki yöntemlerden birini seçebilirsiniz (Python 3.10 veya üzeri…","publisher":null,"homepage":"https://github.com/iamseyhmus7/mcp-tcmb-exchange","repository":"https://github.com/iamseyhmus7/mcp-tcmb-exchange","version":"0.1.8","license":"MIT","protocols":["mcp"],"tags":["currency","döviz","exchange-rate","mcp","tcmb","turkey"],"pricing":null,"endpoints":[{"url":"pypi:mcp-tcmb-exchange","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"finance.markets","name":"Markets & Trading","confidence":1,"provenance":"derived"}],"categories":["finance"],"language":"tr"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-tcmb-exchange","registry":"pypi","observedAt":"2026-11-03T16:26:04.382Z","publishedAt":"2026-03-09T21:33:52.089768Z","latestVersion":"0.1.8"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-tcmb-exchange","url":"https://pypi.org/project/mcp-tcmb-exchange/","firstSeenAt":"2026-09-10T04:23:38.335Z","fetchedAt":"2026-11-03T16:24:48.223Z","normalizedAt":"2026-11-03T16:24:48.223Z"}]},"firstSeenAt":"2026-09-10T04:23:38.335Z","updatedAt":"2026-11-03T16:26:04.382Z"}