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

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

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: [email protected]