Turkish public data for your agent.
Kılavuz is a remote MCP server and REST API: 134 read-only tools for Turkish public data and official calculation rules, one account and one credit balance. Every response carries kaynak (source) and guncelleme (last updated), so the agent can say where a number came from and how fresh it is.
What you can ask
- Live and daily data
- On-duty pharmacies (77 of 81 provinces), fuel prices by province and brand (EPDK), recent earthquakes (AFAD), wholesale produce prices, gold prices, dam levels, weather, Istanbul open data, power and water outages, the Official Gazette index.
- Economy
- CPI (TÜİK), the legal rent increase cap, central bank policy rate decisions, TÜİK indicators and series.
- Tax, payroll and fees
- Gross-to-net payroll, severance, income tax, VAT, stamp duty, title deed fees, property and inheritance tax, motor vehicle tax, traffic fines, attorney and notary fee schedules, tax offices, GİB tax rulings.
- Addresses
- Parse and normalize free-text Turkish addresses against the official street registry, compare two addresses, province/district/neighbourhood lists, reverse geocoding, distance.
- Validation
- IBAN, Turkish ID number (TCKN) and tax ID (VKN) checksums, phone numbers, EAN barcodes, e-Invoice (UBL) files.
- Education and football
- Universities and 21,000+ programmes with base scores, schools, the ÖSYM exam calendar; Turkish league standings, fixtures and results.
Tool descriptions and responses are in Turkish; Claude reads them and answers in your language. Calculators state their legal basis and flag uncertain values instead of guessing. They are not legal or financial advice.
Connect
Streamable HTTP at https://api.kilavuzapi.com/mcp. Tool discovery needs no sign-in; tool calls do.
Settings → Connectors → Add custom connector. Paste this URL, then sign in with Google and approve access:
https://api.kilavuzapi.com/mcpNo API key needed; an account is created on first sign-in. The desktop app uses the same connector.
Run once in a terminal, with an API key from the dashboard:
claude mcp add --transport http kilavuz https://api.kilavuzapi.com/mcp \
--header "Authorization: Bearer ak_live_…"Add --scope user to use it in every project.
Every tool is also a plain HTTPS endpoint:
curl -G "https://api.kilavuzapi.com/v1/eczane/nobetci" \
--data-urlencode "il=İstanbul" --data-urlencode "ilce=Kadıköy" \
-H "Authorization: Bearer $KILAVUZ_API_KEY"Example prompts
- “Which pharmacies are on duty in Bornova, İzmir tonight?”
nobetci_eczane - “What is the price of diesel in Ankara today, by brand?”
akaryakit_fiyat - “Were there any earthquakes of magnitude 4 or more in Turkey in the last 24 hours?”
son_depremler - “My rent is 20,000 TL and the lease renews on 1 November 2026. What is the maximum legal increase?”
kira_artis_orani - “What is the monthly net of a 60,000 TL gross salary in 2026, and the cost to the employer?”
bordro_hesapla - “Normalize this address against the official registry: Vişnezade Mah. Dolmabahçe Cad. Beşiktaş İstanbul”
adres_coz - “What is in today’s Official Gazette?”
resmi_gazete - “Generate 5 fake but checksum-valid Turkish IBANs and ID numbers for my test suite.”
test_verisi_uret
Pricing
1,000 credits free every month, commercial use included, no card. Many reference tools (tax, payroll, calendars, lists) cost 0 credits; data tools cost 1 credit per call and 0 when the result is empty.
| Plan | Credits / month | Price / month |
|---|---|---|
| Free | 1,000 | 0 |
| Developer | 30,000 | 149 TL · $5 |
| Team | 150,000 | 490 TL · $15 |
| High volume | 1,000,000 | 2,490 TL · $59 |
Credit packs (25,000 for $5, 100,000 for $15, 500,000 for $49) are valid for 12 months and are used after the monthly allowance. Prices include VAT. Payment is not open yet; for now every account uses the free tier. Per-tool credits: pricing table (Turkish).
Privacy in short
- We keep your email address, a one-way hash of your API keys and connection tokens, and a usage counter (which endpoint, credits, time; kept 90 days, then daily totals only).
- We do not store what you send to tools: addresses, IBANs, ID numbers, questions and the responses are processed and discarded, never logged. We do not see your conversation, only the tool call the client sends.
- We do not collect personal data from public sources. No cookies for tracking, no analytics, no ads; we do not sell data.
- Revoke a connection at any time from the dashboard (Bağlantılar / Connections). Deleting your account deletes its keys and connections.
Full text (Turkish): privacy policy, KVKK notice, terms, sources and takedown. Contact: destek@kilavuzapi.com.