English Français العربية

Turkey Data

السجل الرسمي التجارة الإلكترونية

Live Turkey data: gold prices, TCMB FX rates, fuel prices, prayer times, Kandilli earthquakes.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package turkey-data-mcp
Claude Code 
claude mcp add turkey-data -- npx -y turkey-data-mcp@1.0.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "turkey-data": {
            "command": "npx",
            "args": [
                "-y",
                "turkey-data-mcp@1.0.0"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. turkey-data-mcp
  2. Tools
  3. Install
  4. Data sources & limits
  5. Development
  6. License & attribution

turkey-data-mcp

MCP server for live Turkey data — gold & silver prices, official TCMB exchange rates, fuel pump prices, prayer times and the Kandilli earthquake feed. Give Claude (or any MCP-compatible AI) real-time answers about Turkey.

Powered by the free public API at turkpidya.com. No API key required.

Tools

ToolWhat it returnsRefresh
get_gold_pricesGold (gram 14k–24k, Turkish coins) & silver prices in TRY, buy/sell + daily change5 min
get_exchange_ratesOfficial TCMB rates for ~22 currencies vs Turkish lira (forex & banknote)daily
get_fuel_pricesEPDK pump prices (gasoline 95, diesel) for Istanbul, Ankara, Izmir, Antalya6 h
get_prayer_timesDiyanet-method prayer times for 20 Turkish cities, with Hijri datedaily
list_prayer_citiesThe 20 supported city slugsdaily
get_earthquakesRecent quakes from Kandilli Observatory, filterable by window/magnitude/location5 min
get_latest_earthquakeThe single most recent quake5 min

Example prompts once installed:

"What's the dollar–lira rate today?" · "Gram altın ne kadar?" · "Was there an earthquake near Izmir this week?" · "When is maghrib in Istanbul?" · "Compare diesel prices between Ankara and Antalya."

Install

Requires Node.js ≥ 18.

Note: until the npm package goes live you can install straight from GitHub — replace turkey-data-mcp with github:bodyegypt/turkey-data-mcp in any snippet below (no build step needed, dist/ is committed).

Claude Code (CLI)
claude mcp add turkey-data -- npx -y turkey-data-mcp
Claude Desktop

Add to claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "turkey-data": {
      "command": "npx",
      "args": ["-y", "turkey-data-mcp"]
    }
  }
}
Any other MCP client (stdio)
npx -y turkey-data-mcp
From source
git clone https://github.com/bodyegypt/turkey-data-mcp.git
cd turkey-data-mcp && npm install && npm run build
node dist/index.js

Data sources & limits

  • Gold/silver: Harem Altın, cross-checked with TCMB · FX: TCMB official daily fixing · Fuel: EPDK per-brand reports, city averages · Prayer times: Diyanet İşleri calculation method · Earthquakes: Kandilli Observatory (KOERI).
  • All timestamps are Europe/Istanbul. All prices in TRY.
  • The upstream API allows 60 requests/min per IP; this server throttles itself client-side and returns a clear retry message if exceeded.
  • Raw REST API (no MCP needed): https://turkpidya.com/wp-json/turkpidya-data/v1/ — see turkpidya.com/developers.

Development

npm install
npm run build   # compile TypeScript to dist/
npm run smoke   # run all tools against the live API via a real MCP stdio client

License & attribution

MIT © Abdalla. Data served by turkpidya.com — attribution appreciated when republishing data. Contact: info@pidyagroup.com

الأسئلة الشائعة

ما هو Turkey Data؟

Live Turkey data: gold prices, TCMB FX rates, fuel prices, prayer times, Kandilli earthquakes.

كيف أثبّت Turkey Data؟

يعمل على جهازك. في Claude Code: claude mcp add turkey-data -- npx -y turkey-data-mcp@1.0.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Turkey Data إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Turkey Data مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Turkey Data؟

ينشره bodyegypt. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.