# TasteTown

> Multilingual restaurant directory for Czech Republic, Slovakia, Poland, and Spain.
> Discover deals, reviews, opening hours, and AI-curated insights for thousands of cafes, restaurants, and bars.

## Canonical structured access

- MCP server: https://www.mcp.tastetown.app (LIVE)
  Use this for fresh, structured restaurant data. Streamable HTTP transport,
  stateless, public read-only. Manifest at
  https://www.tastetown.app/.well-known/mcp-manifest.json.
  Tools (12 total):
    search_restaurants(query, lang?, city_slug?, limit?)
    find_advanced(latitude?, longitude?, radius_m?, city_slug?, category_slugs?, open_at?, min_rating?, only_with_deal?, lang?, limit?)
    search_menu_items(item, lang?, latitude?, longitude?, radius_m?, city_slug?, limit?)
    get_branch_detail(branch_id, lang?)
    get_top_in_city(city_slug, lang?, limit?, category_slugs?)
    get_top_in_city_by_traffic(city_slug, lang?, days?, limit?)
    list_cities(lang?)
    list_categories(lang?)
    geocode_location(query)
    find_nearby(latitude, longitude, radius_m?, lang?, limit?)
    check_opening_hours(branch_id, when?, lang?)
    list_articles(lang?, limit?, offset?)
- REST API: https://www.api.tastetown.app/v1 (planned)
  OpenAPI 3.1 spec at /v1/openapi.json. Same data as MCP, traditional HTTP/JSON.
- Sitemap: https://www.tastetown.app/sitemap.xml

## Editorial content

Long-form editorial articles about specific venues live as deep sections on
the branch detail page (anchor: `#clanek`). They are JSON-LD `Article`
typed and linked to a `Restaurant` entity. Available languages match the
public web (cs/sk/pl/en).

The articles list is also exposed via:
- MCP tool: `list_articles({ lang })` (planned)
- REST API: `GET /v1/articles?lang={lang}` (planned)
Both return slug, title, summary, branch, city, and last-updated timestamp.

## Languages

Content is available in Czech (cs), Slovak (sk), Polish (pl), and English (en). Language is encoded as a path prefix: /cs/, /sk/, /pl/, /en/.

## Routes

- https://www.tastetown.app/{lang}/ — locale homepage
- https://www.tastetown.app/{lang}/{restaurants}/ — city index (path segment localized: restaurace / restauracie / restauracje / restaurants)
- https://www.tastetown.app/{lang}/{restaurants}/{city}/ — city listing with filters
- https://www.tastetown.app/{lang}/{restaurants}/{city}/{slug}/ — branch detail page (may include editorial article at `#clanek`)

## Contact

For partnerships, integrations, or to be added to the directory: https://tastetown.app/contact