English Français العربية

Turkey Data

Official registry E-commerce

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

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

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

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  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

Frequently asked questions

What is Turkey Data?

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

How do I install Turkey Data?

It runs on your machine. In Claude Code: claude mcp add turkey-data -- npx -y turkey-data-mcp@1.0.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Turkey Data need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Turkey Data open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Turkey Data?

It is published by bodyegypt. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.