{
  "specVersion": "1.0",
  "host": {
    "displayName": "MK Express",
    "identifier": "did:web:mkexpress.uz",
    "description": "Xitoy → O'zbekiston kargo va avia pochta: trek kuzatuvi, tariflar, reyslar, filiallar.",
    "url": "https://mkexpress.uz"
  },
  "entries": [
    {
      "identifier": "urn:air:mkexpress.uz:server:webmcp",
      "displayName": "MK Express WebMCP asboblari",
      "type": "application/mcp-server-card+json",
      "url": "https://mkexpress.uz/.well-known/mcp/server-card.json",
      "description": "Sahifa ichidagi WebMCP asboblari (navigator.modelContext): track_parcel, calculate_price, get_branches.",
      "tags": ["cargo", "tracking", "webmcp", "uzbekistan", "china"],
      "capabilities": ["track_parcel", "calculate_price", "get_branches"],
      "representativeQueries": [
        "mkexpress trek raqamimni tekshir",
        "xitoydan kargo narxini hisobla",
        "eng yaqin MK Express filialini top"
      ]
    },
    {
      "identifier": "urn:air:mkexpress.uz:api:shipment-track",
      "displayName": "Jo'natma holati (trek raqami bo'yicha)",
      "type": "application/json",
      "url": "https://api.mkexpress.uz/common/shipments/",
      "description": "GET /common/shipments/{trek}/ — ochiq, JWT talab qilmaydi: mahsulot, soni, og'irligi, reysi va joriy bosqich.",
      "tags": ["tracking", "parcel", "status"],
      "representativeQueries": [
        "YT7513542086123 trek raqami qayerda",
        "посылка MK Express — статус по трек-номеру",
        "where is my parcel from China right now"
      ]
    },
    {
      "identifier": "urn:air:mkexpress.uz:api:cargo-price",
      "displayName": "Tariflar — yo'nalishlar va narx qatorlari",
      "type": "application/json",
      "url": "https://api.mkexpress.uz/api/v2/client/cargo-price",
      "description": "GET, ochiq: avia/avto yo'nalishlar, kg narxi (USD) va yetkazish muddati.",
      "tags": ["pricing", "tariff", "air-cargo", "auto-cargo"],
      "representativeQueries": [
        "xitoydan 1 kg avia kargo qancha turadi",
        "сколько стоит доставка из Китая за килограмм",
        "avto kargo tarifi va yetkazish muddati"
      ]
    },
    {
      "identifier": "urn:air:mkexpress.uz:api:branches",
      "displayName": "Filiallar — manzil, koordinata, ish vaqti",
      "type": "application/json",
      "url": "https://api.mkexpress.uz/api/v2/client/branches",
      "description": "GET, ochiq: topshirish punktlari, telefon, koordinatalar va ish vaqti.",
      "tags": ["branches", "pickup-point", "tashkent", "uzbekistan"],
      "representativeQueries": [
        "MK Express filiallari manzillari",
        "ближайший филиал MK Express в Ташкенте",
        "filial ish vaqti va telefon raqami"
      ]
    },
    {
      "identifier": "urn:air:mkexpress.uz:api:flights",
      "displayName": "Reyslar jadvali — status va qadoqlash sanalari",
      "type": "application/json",
      "url": "https://api.mkexpress.uz/api/v2/client/flights/public",
      "description": "GET, ochiq: faol reyslar, ochilish/yopilish sanalari va joriy holati.",
      "tags": ["flights", "schedule", "packaging"],
      "representativeQueries": [
        "keyingi reys qachon qadoqlanadi",
        "MK Express reyslar jadvali",
        "когда закрывается ближайший рейс"
      ]
    },
    {
      "identifier": "urn:air:mkexpress.uz:catalog:api",
      "displayName": "MK Express ochiq API katalogi (RFC 9727)",
      "type": "application/linkset+json",
      "url": "https://mkexpress.uz/.well-known/api-catalog",
      "description": "Barcha ochiq endpointlar va service-doc havolasi bitta linkset ichida.",
      "tags": ["api-catalog", "openapi", "rest"],
      "representativeQueries": [
        "MK Express ochiq API endpointlari ro'yxati",
        "какие открытые API есть у MK Express",
        "MK Express REST API hujjatlari qayerda"
      ]
    },
    {
      "identifier": "urn:air:mkexpress.uz:skill:track-parcel",
      "displayName": "Skill: jo'natmani kuzatish va bosqichni tushuntirish",
      "type": "application/ai-skill",
      "url": "https://mkexpress.uz/.well-known/agent-skills/track-parcel.md",
      "description": "Agent uchun qadamma-qadam ko'rsatma: trek raqamni so'rash, API'ni chaqirish, 9 bosqichli statusni odam tilida tushuntirish.",
      "tags": ["skill", "tracking", "support"],
      "representativeQueries": [
        "trek raqam bosqichlarini tushuntir",
        "jo'natma statusi nimani anglatadi",
        "как объяснить клиенту статус посылки"
      ]
    },
    {
      "identifier": "urn:air:mkexpress.uz:doc:auth",
      "displayName": "Agent kirishi va autentifikatsiya (auth.md)",
      "type": "text/markdown",
      "url": "https://mkexpress.uz/auth.md",
      "description": "Qaysi endpointlar ochiq, qaysilari OAuth 2.1 talab qiladi; token olish va limitlar.",
      "tags": ["auth", "oauth", "documentation"],
      "representativeQueries": [
        "MK Express API uchun token qanday olinadi",
        "qaysi endpointlar autentifikatsiyasiz ishlaydi",
        "MK Express OAuth authorization server metadata"
      ]
    }
  ]
}