# Türkiye Firma & Cami Arama MCP Server

An [MCP](https://modelcontextprotocol.io) server for searching Turkish businesses, places and mosques — powered by [KolayKaydet.com.tr](https://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](https://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`):

```json
{
  "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

```bash
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](https://kolaykaydet.com.tr) and the companion [open mosque dataset](https://github.com/fsakbas/turkey-mosques-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](./LICENSE).