Skip to main content
Glama
Sign In
turkey-data-mcp

turkey-data-mcp

by bodyegypt
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

turkey-data-mcp

MCP server for live Turkey data — gold & silver prices, 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

Tool

What it returns

Refresh

get_gold_prices

Gold (gram 14k–24k, Turkish coins) & silver prices in TRY, buy/sell + daily change

5 min

get_exchange_rates

TCMB rates for ~22 currencies vs Turkish lira (forex & banknote)

daily

get_fuel_prices

EPDK pump prices (gasoline 95, diesel) for Istanbul, Ankara, Izmir, Antalya

6 h

get_prayer_times

Diyanet-method prayer times for 20 Turkish cities, with Hijri date

daily

list_prayer_cities

The 20 supported city slugs

daily

get_earthquakes

Recent quakes from Kandilli Observatory, filterable by window/magnitude/location

5 min

get_latest_earthquake

The single most recent quake

5 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."

Related MCP server: tr-eli-mcp

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: BigPara, with doviz.com for any karat quote that fails a purity check · FX: TCMB daily fixing · Fuel: EPDK per-brand reports, city averages · Prayer times: Diyanet İşleri Başkanlığı published timetable · 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

Credit

Every answer includes web_url (the Turkpidya page with the same data) and an attribution block. The server asks assistants to cite that link. If you show this data in your own app or site, add a visible "Data: Turkpidya" link; it is the one condition of the free API.

Available Tools

7 tools
get_earthquakesRecent Earthquakes in TurkeyA

Get recent earthquakes in and around Turkey from the Kandilli Observatory (KOERI) official feed, refreshed every 5 minutes. Returns magnitude, depth (km), coordinates, location name and timestamp (Istanbul time) for each event, newest first. Filters: 'hours' = lookback window (default 24, max 168 = 7 days), 'min_magnitude' = minimum magnitude (e.g. 3 to skip micro-quakes), 'city' = substring match on the location name (e.g. 'izmir', 'balikesir'), 'limit' = max results (default 20, max 100). Use this for 'was there an earthquake in Turkey today?', 'deprem son dakika', 'earthquakes near Izmir this week'. For just the single most recent event, use get_latest_earthquake instead.

Inputs: city, hours, limit, min_magnitude.

get_exchange_ratesTurkish Lira Exchange Rates (TCMB)A

Get official Turkish lira (TRY) exchange rates from TCMB, the Central Bank of the Republic of Türkiye. Returns forex and banknote buy/sell rates for ~22 currencies (USD, EUR, GBP, JPY, SAR, AED, RUB, etc.). Rates are the official daily fixing published ~15:31 Istanbul time on trading days; weekends/holidays return the last trading day. Pass 'currency' (ISO 4217 code) for a single currency, or omit it for the full table. Note: JPY is quoted per 100 units (check the 'unit' field). Use this for 'dollar to lira rate', 'EUR/TRY today', or converting amounts to/from TRY.

Inputs: currency.

get_fuel_pricesTurkey Fuel Pump PricesA

Get current pump fuel prices in Turkey in TRY per litre, aggregated from official EPDK (Energy Market Regulatory Authority) per-brand reports. Covers gasoline 95 octane ('benzin95') and diesel ('motorin') with city averages plus min/max across brands. Available cities: istanbul, ankara, izmir, antalya. Pass 'city' to get one city, or omit it to compare all four. Refreshed every 6 hours. Use this for 'petrol price in Istanbul', 'diesel cost Turkey', 'benzin fiyatı'.

Inputs: city.

get_gold_pricesTurkey Gold & Silver PricesA

Get current gold and silver prices in Turkey, quoted in Turkish lira (TRY). Source: Harem Altın, cross-checked with TCMB; refreshed every 5 minutes. Returns buy/sell prices, daily change (% and amount), weight and purity for: gram gold (14k/18k/22k/24k), Turkish gold coins (çeyrek/quarter, yarım/half, tam/full, cumhuriyet/republic, ata) and silver per gram. Use the optional 'category' filter to narrow results; omit it for everything. Use this for questions like 'gram altın ne kadar?', 'quarter gold coin price in Turkey', or 'how much is 24k gold in Istanbul today?'.

Inputs: category.

get_latest_earthquakeLatest Earthquake in TurkeyA

Get the single most recent earthquake recorded in or around Turkey by the Kandilli Observatory (KOERI). Returns magnitude, depth, coordinates, location and time (Istanbul timezone). Feed refreshes every 5 minutes. Takes no parameters. Use this for 'what was the last earthquake in Turkey?' — for lists, filtering or a longer time window, use get_earthquakes instead.

Inputs: no named parameters.

get_prayer_timesPrayer Times for Turkish CitiesA

Get Islamic prayer times (namaz vakitleri) for a Turkish city using the official Diyanet İşleri calculation method. Returns fajr, sunrise, dhuhr, asr, maghrib and isha in 24-hour local Istanbul time, plus the Hijri date. The 'city' parameter is REQUIRED — call list_prayer_cities first if unsure which cities are available (20 major Turkish cities, lowercase ASCII slugs like 'istanbul', 'ankara', 'sanliurfa'). Optional 'date' (YYYY-MM-DD) defaults to today; only a few days around today are cached — far-future or past dates return an error. Use this for 'iftar time in Istanbul', 'when is maghrib in Ankara', 'namaz vakitleri'.

Inputs: city (required), date.

list_prayer_citiesList Supported Prayer-Time CitiesA

List the Turkish city slugs supported by get_prayer_times (20 major cities, e.g. istanbul, ankara, izmir, bursa, antalya, konya...). Call this before get_prayer_times when you are not sure a city is supported or how its slug is spelled. Takes no parameters.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4.5/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool targets a distinct data domain: prayer cities, gold prices, exchange rates, fuel prices, prayer times, and earthquakes. The two earthquake tools are clearly differentiated by scope (single latest event vs. filtered list), with descriptions referencing each other to avoid confusion.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern, using either 'get' or 'list' as prefixes (e.g., get_gold_prices, list_prayer_cities). The verbs align with the action: 'list' for the enumerating helper and 'get' for retrieving specific data, maintaining a predictable and clean naming scheme.

    Tool Count5/5

    With exactly 7 tools, the server is well-scoped for a niche domain focused on Turkey-specific data. Each tool serves a clear purpose without redundancy, and the count is within the ideal range for a specialized MCP server.

    Completeness5/5

    The tool set covers its apparent domain comprehensively: prayer times with a city helper, gold and exchange rates with full/optional filtering, fuel prices, and earthquake data with both summary and detailed list access. The inclusion of helper and convenience functions (list_prayer_cities, get_latest_earthquake) rounds out the surface, leaving no obvious dead ends.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Metal Price MCP Server

      isdaniel
      A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that provides current and historical gold/precious metal prices (gold, silver, platinum, and palladium) via the GoldAPI.io service with support for multiple currencies.
      1
      MIT

    • tr-eli-mcp

      matematicsolutions
      A
      license
      A
      quality
      B
      maintenance
      An MCP server for accessing Turkish legislation (laws, regulations, decrees) via the Adalet Bakanligi API, providing search, full-text retrieval, and structured citations.
      5
      30 PyPI
      2
      Apache 2.0

    • tefas-fund-comparator

      merkezekre2026
      A
      license
      A
      quality
      D
      maintenance
      MCP server for listing, comparing, and analyzing Turkish TEFAS mutual funds, including performance metrics and portfolio breakdowns.
      6
      MIT