# mekktup

> Online mektup yazma ve gönderme hizmeti: mektup online yazılır, yüksek kalitede basılıp zarflanır ve PTT ile
> cezaevine, askeri birliğe, kurumlara (hastane, yurt, okul vb.) ya da ev/iş adresine gönderilir. Kâğıt/zarf rengi,
> çiçek kokusu, kartpostal, fotoğraf ve PDF belge eklenebilir; takip kodu SMS ile gelir. Fiyatlar 290 TL'den başlar.
> Ücretsiz "hasret sayacı" kavuşma gününe (tahliye, terhis, buluşma) geri sayım sunar.

## MCP sunucusu (yapay zeka ajanları için)

Kimlik doğrulama gerekmez; sadece URL ekleyin (Claude özel bağlayıcı, ChatGPT geliştirici modu, Gemini CLI, Cursor…).
Araç kullanarak kullanıcı adına mektup yazar, fiyat/katalog sorgular, taslak oluşturur ve kullanıcıya devir bağlantısı verir
(ödemeyi kullanıcı tarayıcıda yapar).

- MCP uç noktası (Streamable HTTP, durumsuz): `https://mekktup.com/api/v1/agents/mcp`
- Sunucu kartı (SEP-2127, `application/mcp-server-card+json`): `https://mekktup.com/api/v1/agents/mcp/server-card`
- Keşif kataloğu (AI Catalog): `https://mekktup.com/.well-known/ai-catalog.json`
- Araçlar: get_guide, get_options, search_destinations, quote_letter, create_letter, update_letter, get_letter

## Sayfalar

- [Ana Sayfa](/): Hizmetin tanıtımı
- [Nasıl Çalışır](/hizmetler): Üç adım (yaz ve tasarla, ekleri ekle, alıcıyı gir ve gönder), alıcı türleri, fiyatlandırma
- [Sıkça Sorulan Sorular](/sss): Ücret, ödeme, teslimat takibi, cezaevi ve askere mektup kuralları
- [Hakkımızda](/hakkimizda): mekktup ve değerleri
- [Blog](/blog): Mektup gönderme rehberleri
- [İletişim](/iletisim): İletişim formu

## Tüm içerik ve akışlar

- [llms-full.txt](/llms-full.txt): tüm sayfalar, SSS, blog yazıları ve cezaevi dizini düz metin
- [RSS](/feed.xml) · [JSON Feed](/feed.json): blog yazıları ve cezaevi duyuruları
- MCP kaynakları (resources): sayfalar, SSS, blog, `mekktup://cezaevleri` → il → `mekktup://cezaevi/{slug}` (adres, görüş günleri, koğuşlar)

## Yapay zeka ajanları için (ChatGPT, Claude, Gemini, Qwen…)

Bir ajan kullanıcı adına mektubu yazıp seçenekleri ve alıcıyı belirleyebilir; ödemeyi kullanıcı tarayıcıda kendisi yapar.
Kimlik doğrulama yok, JSON, IP başına hız sınırı. Tutarlar kuruş (1 TL = 100), KDV dahil, sunucu hesaplar.

- [Rehber (JSON)](/api/v1/agents/guide): adımlar, kurallar, alanlar
- MCP sunucusu (Streamable HTTP, kimlik yok): `https://mekktup.com/api/v1/agents/mcp` — sunucu kartı `…/mcp/server-card`; araçlar get_guide, get_options, search_destinations, quote_letter, create_letter, update_letter, get_letter (Claude / ChatGPT bağlayıcısı, Gemini CLI, Cursor…)
- [OpenAPI](/api/v1/agents/openapi.json): ChatGPT Actions / araç tanımı için
- [Seçenekler](/api/v1/agents/options): kategoriler, zorunlu alanlar, kağıt / zarf / koku / kartpostal / yazı tipi kodları, fiyatlar
- [Alıcı kataloğu](/api/v1/agents/destinations?category=cezaevi): cezaevi / askeri birlik / kurum; `city` ve `q` ile ara
- Fiyat teklifi: `POST /api/v1/agents/quote` (mektup alanları + photo_count, document_pages)
- Taslak oluştur: `POST /api/v1/agents/letters` → `id`, `token`, `handoff_url`, `missing`, `quote`
- Düzelt / durum: `PATCH|GET /api/v1/agents/letters/{id}` (`X-Letter-Token: <token>`)

Devir: `handoff_url` (`/mektup-yaz?devral=<token>`, 7 gün) kullanıcıya verilir; kullanıcı mektubu okur, eksikleri ve ekleri
tamamlar, giriş yapar ve kartla öder. Ajan dosya yükleyemez, ödeme yapamaz, T.C. kimlik / telefon uydurmaz.
Cezaevi mektubunda alıcı baba adı ve katalogdan cezaevi seçimi zorunludur; yasak içerik yazılmaz.