Turkiye Firma

An MCP server for searching Turkish businesses, places and mosques — powered by KolayKaydet.com.tr, Turkey's local business & places directory (580,000+ businesses, 90,000+ mosques across all 81 provinces).

🇹🇷 Türkiye genelindeki işletmeleri ve camileri arayan bir MCP server — KolayKaydet.com.tr veritabanını kullanır.

Tools

Tool	Description
search_companies	Search 580K+ businesses by name, city and/or category
get_company_details	Get full details for a business by its KolayKaydet slug
search_mosques	Search 90K+ mosques by city/district and attributes (historic, selatin, wheelchair-accessible, etc.)
list_cities	List all cities with their registered business counts

Every result includes a canonical url pointing to a live KolayKaydet.com.tr profile page.

Connecting to the hosted server

This server is hosted at https://mcp.kolaykaydet.com.tr/mcp (Streamable HTTP transport, stateless — no session/auth required for read-only search).

If you're deploying your own instance, replace this URL with your own domain.

Claude / Claude Code (.mcp.json or claude mcp add):

{
  "mcpServers": {
    "turkiye-firma": {
      "url": "https://mcp.kolaykaydet.com.tr/mcp"
    }
  }
}

Cursor / other MCP clients: point to the same URL using the Streamable HTTP transport.

Running it yourself

git clone https://github.com/fsakbas/turkiye-firma-mcp
cd turkiye-firma-mcp
npm install
DATABASE_URL=postgres://... npm start

Requires a DATABASE_URL pointing to a KolayKaydet-schema Postgres database (this repo does not include the data — see KolayKaydet.com.tr and the companion open mosque dataset for the underlying data).

Why this exists

KolayKaydet.com.tr maintains one of the largest structured directories of Turkish businesses and mosques. This server exposes that data to AI agents and assistants directly, so they can answer location/business questions about Turkey with real, current, sourced data instead of guessing — with every answer traceable back to a canonical source page.

License

MIT — see LICENSE.