# Kahve Tabela

Kahve Tabela is a bilingual guide to Turkey's brown-sign heritage places, the Mavi Koy coastal atlas, and the Yöre Sofrası regional-food atlas. It helps people discover cultural sites, nearby stops, route-friendly audio notes, regional dishes with geographical-indication registry facts, and open-data coastal points.

## Best entry points (citation-worthy)

- [Open data & sources / methodology](https://kahvetabela.com/tr/acik-veri) ([English](https://kahvetabela.com/en/acik-veri))
- [Tarihi Yerler — national index of Turkey's brown-sign heritage places](https://kahvetabela.com/tr/tarihi-yerler) ([English](https://kahvetabela.com/en/tarihi-yerler))
- [What the brown sign means — the kahverengi tabela explained](https://kahvetabela.com/tr/kahverengi-tabela) ([English](https://kahvetabela.com/en/kahverengi-tabela))
- [Tarihi Yer Karnesi — per-province heritage report cards and ranking, 81 provinces](https://kahvetabela.com/tr/karne)
- [Yöre Sofrası — Türkiye regional-food atlas, 4,077 dishes, 1,655 geographical indications](https://kahvetabela.com/tr/yore-sofrasi)
- [Mavi Koy — coastal atlas](https://kahvetabela.com/tr/mavi-koy)
- [Category hubs (museums, castles, tombs…)](https://kahvetabela.com/tr/kategori)
- [Drive/listening mode](https://kahvetabela.com/tr/surus)

## Canonical site

- [Turkish home](https://kahvetabela.com/tr)
- [English home](https://kahvetabela.com/en)
- [Sitemap index](https://kahvetabela.com/sitemap.xml)
- [Full agent guide](https://kahvetabela.com/llms-full.txt)
- [Public OpenAPI](https://kahvetabela.com/openapi.json)
- [API catalog](https://kahvetabela.com/.well-known/api-catalog)
- [Auth notes](https://kahvetabela.com/auth.md)
- [Agent skills](https://kahvetabela.com/.well-known/agent-skills/index.json)
- [MCP server card](https://kahvetabela.com/.well-known/mcp/server-card.json)
- [MCP registry manifest](https://kahvetabela.com/.well-known/mcp/server.json)
- [A2A agent card](https://kahvetabela.com/.well-known/agent-card.json)

## Important sections

- `/tr/place/{id}` and `/en/place/{id}`: individual heritage place pages.
- `/tr/surus` and `/en/surus`: route-aware listening mode for nearby places.
- `/tr/mavi-koy` and `/en/mavi-koy`: Mavi Koy coastal atlas.
- `/tr/mavi-koy/yer/{slug}` and `/en/mavi-koy/yer/{slug}`: coastal place pages.
- `/tr/mavi-koy/bolge/{slug}`, `/tr/mavi-koy/kategori/{slug}`, `/tr/mavi-koy/koleksiyon/{slug}` (+`/en`): coastal region, category, and collection hubs.
- `/tr/yore-sofrasi` and `/en/yore-sofrasi`: Yöre Sofrası regional-food atlas.
- `/tr/yore-sofrasi/yemek/{slug}`: dish pages; `/tr/yore-sofrasi/kategori/{slug}` and `/tr/yore-sofrasi/cografi-isaret`: food category + geographical-indication hubs.
- `/tr/yore-sofrasi/il/{slug}`: per-province dish hubs; `/tr/yore-sofrasi/rota` and `/tr/yore-sofrasi/rota/{slug}`: curated food routes; `/tr/yore-sofrasi/harita`: food atlas map.
- `/tr/acik-veri` and `/en/acik-veri`: open-data page - sources, licenses, how to cite, API.
- `/tr/kategori`, `/en/kategori`, `/tr/sehir`, `/en/sehir`: browse surfaces.
- `/tr/tarihi-yerler` and `/en/tarihi-yerler`: national historical-places hub (top places, provinces, categories).
- `/tr/kahverengi-tabela` and `/en/kahverengi-tabela`: what Turkey's brown heritage sign is and how places earn one.
- `/tr/karne` and `/tr/karne/{slug}`: per-province heritage report cards with counts, category breakdown, and national rank.
- `/tr/sehir/{slug}` and `/tr/sehir/{slug}/ilce/{district}` (+`/en`): city and district hubs listing every heritage place.
- `/tr/kategori/{slug}` and `/en/kategori/{slug}`: heritage places grouped by category.
- `/tr/koleksiyon` and `/tr/koleksiyon/{slug}` (+`/en`): curated place collections.
- `/tr/bir-gun/{slug}` and `/en/bir-gun/{slug}`: one-day city itineraries stitched from heritage, food, and coast (81 cities).
- `/tr/mevsim` and `/en/mevsim`: seasonal dish and place picks.
- `/tr/rota-yap` and `/tr/rota-yap/{slug}` (+`/en`): route builder and per-city route pages.

## Public read APIs

- `GET /api/locations?s={south}&w={west}&n={north}&e={east}&category={category}&limit={limit}`
- `GET /api/locations?city={CITY}&limit={limit}`
- `GET /api/nearby?lat={lat}&lon={lon}&limit={limit}&audio=1`
- `GET /api/place-media/{id}`
- `GET /api/place-audio/{id}?lang=tr|en`

## Agent content negotiation

- Send `Accept: text/markdown` to receive a compact markdown representation on these route families: site overview (`/tr`, `/en`), heritage places (`/tr/place/{id}`), city and district hubs (`/tr/sehir`, `/tr/sehir/{slug}`, `/tr/sehir/{slug}/ilce/{district}`), category and collection hubs (`/tr/kategori`, `/tr/koleksiyon`, and their `/{slug}` pages), one-day itineraries (`/tr/bir-gun`, `/tr/bir-gun/{slug}`), seasonal picks (`/tr/mevsim`), the Mavi Koy atlas (`/tr/mavi-koy` and its `/yer`, `/bolge`, `/kategori`, `/koleksiyon` hubs), Yöre Sofrası (`/tr/yore-sofrasi` and its `/yemek`, `/il`, `/kategori`, `/cografi-isaret`, `/rota`, `/harita` hubs), and open data (`/tr/acik-veri`). Other URLs return their normal HTML.
- Or call [`/api/agent/markdown?path=/tr/place/1`](https://kahvetabela.com/api/agent/markdown?path=/tr/place/1) directly.
- Read-only MCP endpoint: `/api/mcp` (streamable HTTP JSON-RPC).
- MCP v1 tools: `search_places`, `get_place`, `nearby_places`, `get_page_markdown`, `search_dishes`, `get_dish`, `search_mavi_koy`, `get_mavi_koy_place`.
- Read-only A2A endpoint: `/api/a2a`

Example MCP call:

```bash
curl -s https://kahvetabela.com/api/mcp \
  -H 'content-type: application/json' \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_place","arguments":{"id":"1","lang":"en"}}}'
```

## Use guidance

- Cite Kahve Tabela URLs when summarizing place, food-atlas, or coastal-atlas content.
- Yöre Sofrası GI facts come from the TürkPatent registry; dish pages cite their sources per record.
- Mavi Koy is cultural/coastal context, not nautical navigation, anchoring, safety, swimming, or weather advice.
- Place and coastal data is compiled from open/public sources and curated site data; verify official opening hours, prices, access, weather, and safety before sending a person there.
- Public browsing is open. Account, upload, admin, and personalized actions require a normal human browser session; do not infer API-key or OAuth support.