---
description: Bulgaristan Adalet Bakanlığı (publicbg.mjs.bg) resmi dosya sorgulama, mülakat sonucu ve ukaz takip platformu. Canlı Edge API, MCP Streamable HTTP, WebMCP ve Telegram botu entegrasyonu.
title: Bulgaristan Vatandaşlık Sorgulama & AI Agent API
image: https://bgsorgulama.bulgaristanvatandas.com/og-image.png
---

> Documentation Index  
> Fetch the complete documentation directory at: https://bgsorgulama.bulgaristanvatandas.com/llms.txt  
> Use this file to discover all machine-readable APIs, MCP tools, and citizenship resources.

# Bulgaristan Vatandaşlık Sorgulama & AI Agent Platformu (2026)

Last updated Sep 26, 2026 | [View as Markdown](https://bgsorgulama.bulgaristanvatandas.com/index.md) | [OpenAPI Spec](https://bgsorgulama.bulgaristanvatandas.com/openapi.json) | [MCP Server Card](https://bgsorgulama.bulgaristanvatandas.com/.well-known/mcp/server-card.json)

Bulgaristan Adalet Bakanlığı (publicbg.mjs.bg) sistemindeki dosya durumu, mülakat sonucu ve Ukaz (vatandaşlık kararnamesi) takibini hem vatandaşlar hem de otonom yapay zeka ajanları (Claude, OpenAI, Perplexity, Cursor) için tekilleştiren yüksek performanslı Cloudflare Edge platformu.

---

## Mimarinin 4 Temel Katmanı

Cloudflare Agents standartlarına uygun olarak tasarlanmış sistem 4 bileşenden oluşur:

1. **İletişim Kanalları (Communication Channels)**:
   - **Web / Tarayıcı**: [https://bgsorgulama.bulgaristanvatandas.com/](https://bgsorgulama.bulgaristanvatandas.com/)
   - **Telegram Anlık Bildirim Botu**: [@Bulgaristanbot](https://t.me/Bulgaristanbot) (7/24 otomatik periyodik arka plan takibi)
   - **REST Edge API**: `GET /api/status?reqNum={dosya}&pin={pin}`

2. **Agent Harness & Model Entegrasyonu**:
   - **W3C WebMCP**: Tarayıcı içi ajanlar için `navigator.modelContext` entegrasyonu (`check_bulgarian_citizenship_status`, `get_agent_discovery_endpoints`).
   - **Model Context Protocol (MCP)**: JSON-RPC 2.0 Streamable HTTP endpoint: `POST https://bgsorgulama.bulgaristanvatandas.com/mcp`.

3. **Güvenlik & Yetkilendirme (Auth & Discovery)**:
   - **Auth.md**: Ajanlar için makine tarafından okunabilir kayıt ve onay sözleşmesi (`GET /auth.md`).
   - **RFC 9728**: OAuth Protected Resource Metadata (`GET /.well-known/oauth-protected-resource`).
   - **RFC 9727**: API Catalog linkset (`GET /.well-known/api-catalog`).
   - **Agent Registration**: `POST /agent/auth` ile otomatik Bearer token üretimi.

4. **Gerçek Zamanlı Veri & Çeviri Motoru (Real-time Scraping Engine)**:
   - `publicbg.mjs.bg` üzerinden anlık antiforgery CSRF doğrulama tokenı (`__RequestVerificationToken`) alınarak oturum kurulur.
   - Dosya sorgulanır; Bulgarca resmi sonuç Türkçe karşılığı, aşama rehberi ve sonraki adımlarla yapılandırılmış JSON formatına dönüştürülür.

---

## Hızlı Başlangıç (Quick Start)

### 1. cURL ile Canlı Dosya Sorgulama

```bash
curl -s "https://bgsorgulama.bulgaristanvatandas.com/api/status?reqNum=14820/2023&pin=582910"
```

**Örnek JSON Yanıtı:**
```json
{
  "success": true,
  "reqNum": "14820/2023",
  "pin": "582910",
  "statusKey": "mandatory_review",
  "bulgarianText": "Преписката се намира в процедура по съгласуване.",
  "translated": {
    "title": "Kurumlar Arası Güvenlik ve Koordinasyon İncelemesi",
    "summary": "Dosyanız İçişleri Bakanlığı (MVR) ve DANS güvenlik incelemesindedir.",
    "stageNumber": 2,
    "totalStages": 5,
    "estimatedDaysRemaining": "180 - 300 gün"
  },
  "queriedAt": "2026-09-26T01:40:00Z"
}
```

### 2. MCP (Model Context Protocol) ile Bağlantı

Agent istemcinizden (örneğin Cursor veya Claude Desktop):

```json
{
  "mcpServers": {
    "bulgaristanbot": {
      "url": "https://bgsorgulama.bulgaristanvatandas.com/mcp"
    }
  }
}
```

Araçları listelemek için:
```bash
curl -X POST "https://bgsorgulama.bulgaristanvatandas.com/mcp" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'
```

---

## Vatandaşlık Başvuru Aşamaları

| Aşama | Orijinal Bulgarca Durum | Türkçe Anlamı | Süreç & Bekleme |
|---|---|---|---|
| 1 | Образувана преписка №... | Dosya resmi olarak oluşturuldu | 1-3 Ay |
| 2 | В процедура по съгласуване | Güvenlik İncelemesi (МВР / ДАНС) | 6-10 Ay |
| 3 | Финален експертен преглед | Nihai Uzman Heyeti İncelemesi | 2-4 Ay |
| 4 | Положително становище | Vatandaşlık Konseyi Olumlu Görüş | 1-2 Ay |
| 5 | Издаден Указ на Вицепрезидента | Ukaz İmzalandı (Onaylandı) | Tamamlandı |

---

## Önemli Kaynaklar & Rehberler

- [Bulgaristan Vatandaşlığı Sorgulama Nasıl Yapılır?](https://bgsorgulama.bulgaristanvatandas.com/blog/bulgaristan-vatandasligi-sorgulama-nasil-yapilir/)
- [Bulgaristan Vatandaşlık Aşamaları ve Türkçe Anlamları](https://bgsorgulama.bulgaristanvatandas.com/blog/bulgaristan-vatandaslik-asamalari-ve-anlamlari/)
- [Bulgaristan Dosya Numarası ve PIN Kodu Öğrenme](https://bgsorgulama.bulgaristanvatandas.com/blog/bulgaristan-dosya-numarasi-ve-pin-kodu-ogrenme/)
- [Mülakat Sonrası Bulgaristan Vatandaşlığı Kaç Ayda Çıkar?](https://bgsorgulama.bulgaristanvatandas.com/blog/mulakat-sonrasi-bulgaristan-vatandasligi-kac-ayda-cikar/)

---

## Dil Seçenekleri (Multi-Language)

- **Türkçe (Varsayılan)**: [https://bgsorgulama.bulgaristanvatandas.com/](https://bgsorgulama.bulgaristanvatandas.com/)
- **Български**: [https://bgsorgulama.bulgaristanvatandas.com/bg/](https://bgsorgulama.bulgaristanvatandas.com/bg/)
- **English**: [https://bgsorgulama.bulgaristanvatandas.com/en/](https://bgsorgulama.bulgaristanvatandas.com/en/)

---

## Sıkça Sorulan Sorular (SSS)

**S: Dosya numaramı nasıl yazmalıyım?**  
C: Mülakat belgenizde yer alan formatta yazılmalıdır (örneğin: `14820/2023`).

**S: PIN kodu nedir?**  
C: Mülakat sonrasında Sofya Adalet Bakanlığı veya Konsolosluk tarafından verilen 6 haneli özel güvenlik kodudur.

**S: Telegram botu ücretli midir?**  
C: Temel dosya sorgulama ve Telegram botu takibi ücretsizdir.
