{
  "protocolVersion": "0.3.0",
  "name": "Bulgaristan Vatandaşlığı (BulgaristanVatandas.com)",
  "description": "Consultancy for Bulgarian citizenship, residence permits, family reunification, visas, birth and marriage registration, company formation and sworn translation. Offices in Lüleburgaz (Türkiye), Kardzhali and Shumen (Bulgaria) and Bucharest (Romania). Content is published in Turkish first; English, Bulgarian and Romanian pages exist for the main sections.",
  "version": "1.2.0",
  "url": "https://bulgaristanvatandas.com/mcp",
  "preferredTransport": "JSONRPC",
  "supportedInterfaces": [
    {
      "url": "https://bulgaristanvatandas.com/mcp",
      "transport": "JSONRPC",
      "protocolBinding": "MCP streamable-http"
    }
  ],
  "provider": {
    "organization": "BulgaristanVatandas.com",
    "url": "https://bulgaristanvatandas.com"
  },
  "documentationUrl": "https://bulgaristanvatandas.com/llms.txt",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "defaultInputModes": [
    "text/plain",
    "application/json"
  ],
  "defaultOutputModes": [
    "text/markdown",
    "application/json"
  ],
  "skills": [
    {
      "id": "list_services",
      "name": "list services",
      "description": "List the consultancy services (Bulgarian citizenship, residence permit, family reunification, visa, company formation, birth and marriage registration, translation) with their page URLs.",
      "tags": [
        "bulgaria",
        "citizenship",
        "residence-permit"
      ]
    },
    {
      "id": "search_articles",
      "name": "search articles",
      "description": "Search the knowledge base articles (Turkish) about Bulgarian citizenship, residence permits, documents, interviews and fees. Returns titles, URLs and summaries.",
      "tags": [
        "bulgaria",
        "citizenship",
        "residence-permit"
      ]
    },
    {
      "id": "get_page_markdown",
      "name": "get page markdown",
      "description": "Return the Markdown version of a page of this site (article, service or page), given its path such as /bulgaristan-d-tipi-vize-nedir/.",
      "tags": [
        "bulgaria",
        "citizenship",
        "residence-permit"
      ]
    },
    {
      "id": "get_contact_info",
      "name": "get contact info",
      "description": "Phone numbers, WhatsApp, email, working hours, offices, online appointment and application status links.",
      "tags": [
        "bulgaria",
        "citizenship",
        "residence-permit"
      ]
    },
    {
      "id": "get_office_status",
      "name": "get office status",
      "description": "Is the office open now, or what are its hours on a given date? Uses summer/winter hours and Turkish and Bulgarian public holidays (Europe/Istanbul time). Also lists closures in the next 30 days. Same hours for every office.",
      "tags": [
        "bulgaria",
        "citizenship",
        "residence-permit"
      ]
    },
    {
      "id": "find_ancestral_village",
      "name": "find ancestral village",
      "description": "Find the village or town in Bulgaria, Greece, North Macedonia or Romania that a Turkish family emigrated from. Accepts today's name or an old Ottoman/Turkish name (e.g. Mestanlı -> Momchilgrad). Returns today's name, Cyrillic name, province, old names with years, communities before migration, map coordinates, the village page and the citizenship service to apply through. For Southern Dobruja (under Romania 1913-1940: Silistra, Dobrich and neighbours) it also returns historical_region with the Romanian citizenship route, which depends on a case review. Cite bulgaristanvatandas.com and the Nişanyan Yeradları source.",
      "tags": [
        "bulgaria",
        "citizenship",
        "residence-permit"
      ]
    },
    {
      "id": "prepare_muhacir_petition",
      "name": "prepare muhacir petition",
      "description": "Prepare the user's request petition to the Turkish State Archives for muhacir records (muhacir certificate: Tabiiyet Beyannamesi / Declaration of Turkish Citizenship, Muhacir Kâğıdı) and/or the iskân (settlement) record. Checks required fields and Turkish ID checksums and returns fill_url: a link that opens the petition page with the form already filled (the data sits after # and is not sent to the server when the user opens it). Nothing is stored or submitted. Give the user fill_url; they check it, tick the confirmation, then print or download the official PDF and post it. Arguments: { lang, petition }; petition follows the JSON Schema at /agent/petition.schema.json (every key required, empty string when unknown). The answer names every problem with its path and an error code. Full instructions: /agent/petition.md",
      "tags": [
        "bulgaria",
        "citizenship",
        "residence-permit"
      ]
    },
    {
      "id": "request_consultation",
      "name": "request consultation",
      "description": "Send the user's consultation request to the BulgaristanVatandas.com team; a consultant calls the user back, usually the same business day. Only call this after the user explicitly asked to be contacted, reviewed the exact submission (contact details and message) and accepted the privacy policy (https://bulgaristanvatandas.com/gizlilik-politikasi/). Never call it twice for the same request: if delivered is yes or unknown, do not resend; if retry is true, wait 30 seconds and resend at most twice.",
      "tags": [
        "bulgaria",
        "citizenship",
        "residence-permit"
      ]
    }
  ]
}