# BGSorgulama — Full Knowledge Base & Machine Corpus > Comprehensive documentation, guides, API references, and discovery standards for autonomous AI agents and automated systems. > Canonical URL: https://bgsorgulama.bulgaristanvatandas.com/llms-full.txt > Compact index: https://bgsorgulama.bulgaristanvatandas.com/llms.txt --- ## 1. System Overview & Platform Mission BGSorgulama (BulgaristanVatandas.com) provides real-time verification and notification services for Bulgarian citizenship dossiers processed by the Ministry of Justice (Министерство на правосъдието - publicbg.mjs.bg). - **Production URL**: https://bgsorgulama.bulgaristanvatandas.com - **Telegram Bot**: [@Bulgaristanbot](https://t.me/Bulgaristanbot) - **API Catalog**: https://bgsorgulama.bulgaristanvatandas.com/.well-known/api-catalog - **MCP Server Card**: https://bgsorgulama.bulgaristanvatandas.com/.well-known/mcp.json - **Agent Skills**: https://bgsorgulama.bulgaristanvatandas.com/.well-known/agent-skills/index.json - **Auth Contract**: https://bgsorgulama.bulgaristanvatandas.com/auth.md --- ## 2. Citizenship Vetting Stages & Legal Timelines Bulgarian citizenship applications undergo 5 statutory evaluation stages under the Bulgarian Citizenship Act (Закон за българското гражданство): ### Stage 1: Образувана преписка №... (File Created & Registered) - **Definition**: The dossier is registered into the Ministry's electronic database following the in-person interview. - **Duration**: 1–3 months. - **Action**: Applicant receives dossier number and 6-digit PIN. ### Stage 2: В процедура по задължително съгласуване (Mandatory Inter-Agency Review) - **Definition**: Dossier is forwarded for background checks to the Ministry of Interior (МВР), State Agency for National Security (ДАНС), and Ministry of Foreign Affairs (МВнР). - **Duration**: 18–30 months depending on basis (origin, naturalization, descent). - **Action**: Passive monitoring. ### Stage 3: Финален експертен преглед (Final Expert Review) - **Definition**: Security reports have returned; the Ministry's citizenship directorate prepares the final report. - **Duration**: 2–4 months. - **Risk**: Missing documents (допълнителна проверка) must be submitted within statutory deadlines. ### Stage 4: Положително становище на Съвета по гражданството (Favorable Council Decision) - **Definition**: Citizenship Council has reviewed and approved the application, forwarding the proposal to the Vice President. - **Duration**: 1–2 months. ### Stage 5: Издаден Указ на Вицепрезидента (Citizenship Decree Issued) - **Definition**: Presidential decree (Указ) is signed. The applicant is officially a citizen of the Republic of Bulgaria and European Union. - **Next Steps**: Scheduling certificate pick-up (Удостоверение) in Sofia or Consulate, followed by EGN generation and passport issuance. --- ## 3. Product Pricing & Service Tiers ### Tier 1: Bireysel Kullanıcı (Personal User) — Ücretsiz (Free) - **Audience**: Individual applicants tracking their own and family dossiers. - **File Limit**: 1–3 files. - **Scan Frequency**: 3 automated scans per day. - **Notifications**: Instant Telegram alerts on status changes and decrees. - **Cost**: 0 ₺ (Lifetime Free). - **Access**: [@Bulgaristanbot](https://t.me/Bulgaristanbot). ### Tier 2: Pro Danışman Paketi (Pro Agency Plan) - **Audience**: Citizenship consultancies, translation agencies, and immigration lawyers. - **File Limit**: Up to 500 files tracked simultaneously. - **Scan Frequency**: Hourly automated scans. - **Features**: Bulk CSV/Excel file import, automated client notifications via SMS/Telegram, missing document early warning. - **Cost**: ₺1.490 / month (€49 / month | 95 лв / month). - **Access**: [@Bulgaristanbot?start=plan_pro](https://t.me/Bulgaristanbot?start=plan_pro). ### Tier 3: Kurumsal & Sınırsız (Enterprise Unlimited) - **Audience**: High-volume immigration law firms and international agencies. - **File Limit**: Unlimited citizenship dossiers. - **Scan Frequency**: High-frequency checks every 15 minutes. - **Features**: REST API & Webhooks, custom domain / white-label alerts, dedicated account manager (99.9% SLA), automated PDF export. - **Cost**: ₺3.950 / month (€129 / month | 250 лв / month). - **Access**: [@Bulgaristanbot?start=plan_enterprise](https://t.me/Bulgaristanbot?start=plan_enterprise). --- ## 4. API Reference ### GET /api/status Queries real-time dossier progression. - **URL**: `https://bgsorgulama.bulgaristanvatandas.com/api/status` - **Query Parameters**: - `reqNum` (string, required): Dossier case number, e.g., `14820/2023`. - `pin` (string, required): 6-digit numeric PIN, e.g., `582910`. - **Response Format**: ```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-26T02:00:00Z" } ``` --- ## 5. Model Context Protocol (MCP) Streamable HTTP - **Endpoint**: `POST https://bgsorgulama.bulgaristanvatandas.com/mcp` - **Protocol Version**: `2024-11-05` - **Available Tools**: - `check_citizenship_status`: Takes `{ reqNum: string, pin: string }` and returns structured dossier status. - `get_stages_guide`: Returns complete procedural breakdown with legal timelines. --- ## 6. WebMCP Browser Integration Browser agents equipped with W3C WebMCP can inspect `navigator.modelContext` on any page of this site to execute: 1. `check_bulgarian_citizenship_status`: Parameters `{ caseNumber, pin }`. 2. `get_agent_discovery_endpoints`: Returns all machine-readable URIs. --- ## 7. Security, Privacy & Crawler Preferences - **IETF Content Signals**: `ai-train=no, search=yes, ai-input=no` - **OAuth Discovery**: Complies with RFC 9728 and RFC 8414. - **Authentication**: See `/auth.md` for bearer token and automated agent registration specifications.