Hptsu MCP

Official21 tools

by HPT-SU · Python

Search hpt.su — Russian/EAEU vehicle compliance documents: type approvals, certificates, VIN lookup.

Captured live from the server via tools/list.

search_documents

Cross-registry search by document number across all hpt.su kinds.

Parameters3

number	any	optional	Document number, full or partial.
page	integer	optional	1-based page index.
page_size	integer	optional	Rows per page (max 50).

Raw schema

{
  "type": "object",
  "properties": {
    "number": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Document number, full or partial.",
      "title": "Number"
    },
    "page": {
      "default": 1,
      "description": "1-based page index.",
      "minimum": 1,
      "title": "Page",
      "type": "integer"
    },
    "page_size": {
      "default": 20,
      "description": "Rows per page (max 50).",
      "maximum": 50,
      "minimum": 1,
      "title": "Page Size",
      "type": "integer"
    }
  },
  "title": "search_documentsArguments"
}

get_document

Fetch a single Document by slug+kind.

Parameters2

slug	string	required	Document slug — URL-form of the number (the same as in site URL).
kind	string	required	One of: otts, otch, zotts, zotch, sbkts, zoets, sout, cert, decl. Slug isn't globally unique between kinds, so kind is required.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "Document slug — URL-form of the number (the same as in site URL).",
      "title": "Slug",
      "type": "string"
    },
    "kind": {
      "description": "One of: otts, otch, zotts, zotch, sbkts, zoets, sout, cert, decl. Slug isn't globally unique between kinds, so kind is required.",
      "title": "Kind",
      "type": "string"
    }
  },
  "required": [
    "slug",
    "kind"
  ],
  "title": "get_documentArguments"
}

search_certificates

Search conformity certificates (ТР ТС / ТР ЕАЭС).

Parameters10

number	any	optional	Certificate number, full or partial.
applicant	any	optional	Applicant name (icontains).
applicant_inn	any	optional	Applicant INN (exact match).
manufacturer	any	optional	Manufacturer name (icontains).
regulations	any	optional	Technical regulation code (e.g. 'ТР ТС 018/2011').
product	any	optional	Product full name (icontains).
status	any	optional	Certificate status code.
scheme	any	optional	Certification scheme — '1с'…'9с'.
page	integer	optional	1-based page index.
page_size	integer	optional	Rows per page (max 50).

Raw schema

{
  "type": "object",
  "properties": {
    "number": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Certificate number, full or partial.",
      "title": "Number"
    },
    "applicant": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Applicant name (icontains).",
      "title": "Applicant"
    },
    "applicant_inn": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Applicant INN (exact match).",
      "title": "Applicant Inn"
    },
    "manufacturer": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Manufacturer name (icontains).",
      "title": "Manufacturer"
    },
    "regulations": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Technical regulation code (e.g. 'ТР ТС 018/2011').",
      "title": "Regulations"
    },
    "product": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Product full name (icontains).",
      "title": "Product"
    },
    "status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Certificate status code.",
      "title": "Status"
    },
    "scheme": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Certification scheme — '1с'…'9с'.",
      "title": "Scheme"
    },
    "page": {
      "default": 1,
      "description": "1-based page index.",
      "minimum": 1,
      "title": "Page",
      "type": "integer"
    },
    "page_size": {
      "default": 20,
      "description": "Rows per page (max 50).",
      "maximum": 50,
      "minimum": 1,
      "title": "Page Size",
      "type": "integer"
    }
  },
  "title": "search_certificatesArguments"
}

search_declarations

Search declarations of conformity (ТР ТС / ТР ЕАЭС).

Parameters10

number	any	optional	Declaration number, full or partial.
applicant	any	optional	Applicant name (icontains).
applicant_inn	any	optional	Applicant INN (exact match).
manufacturer	any	optional	Manufacturer name (icontains).
regulations	any	optional	Technical regulation code (e.g. 'ТР ТС 018/2011').
product	any	optional	Product full name (icontains).
status	any	optional	Declaration status code.
scheme	any	optional	Declaration scheme — '1д'…'6д'.
page	integer	optional	1-based page index.
page_size	integer	optional	Rows per page (max 50).

Raw schema

{
  "type": "object",
  "properties": {
    "number": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Declaration number, full or partial.",
      "title": "Number"
    },
    "applicant": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Applicant name (icontains).",
      "title": "Applicant"
    },
    "applicant_inn": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Applicant INN (exact match).",
      "title": "Applicant Inn"
    },
    "manufacturer": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Manufacturer name (icontains).",
      "title": "Manufacturer"
    },
    "regulations": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Technical regulation code (e.g. 'ТР ТС 018/2011').",
      "title": "Regulations"
    },
    "product": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Product full name (icontains).",
      "title": "Product"
    },
    "status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Declaration status code.",
      "title": "Status"
    },
    "scheme": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Declaration scheme — '1д'…'6д'.",
      "title": "Scheme"
    },
    "page": {
      "default": 1,
      "description": "1-based page index.",
      "minimum": 1,
      "title": "Page",
      "type": "integer"
    },
    "page_size": {
      "default": 20,
      "description": "Rows per page (max 50).",
      "maximum": 50,
      "minimum": 1,
      "title": "Page Size",
      "type": "integer"
    }
  },
  "title": "search_declarationsArguments"
}

search_otts

Search ОТТС (vehicle type approvals, ТР ТС 018/2011).

Parameters14

number	any	optional	ОТТС number, full or partial.
vin	any	optional	VIN substring (5-17 chars) — backend autoroute substring/DAWG.
brand	any	optional	Vehicle brand (e.g. 'Toyota').
type	any	optional	Vehicle type / model (icontains).
comm_name	any	optional	Commercial name (icontains).
chassis	any	optional	Chassis identifier (icontains).
mods	any	optional	Modifications (icontains).
category	any	optional	Vehicle category (M1, N2, L3, …).
eco_class	any	optional	Ecological class — pass '5' or the name; auto-resolved to reference id.
wheel_formula	any	optional	Wheel formula (e.g. '4x2'); auto-resolved to reference id.
axis_count	any	optional	Axle count (e.g. '2') or exact 'axes / wheels' (e.g. '2 / 4') — auto-resolved to reference id. A bare axle count may match several wheel configs; then candidates are returned to pick from.
issuer	any	optional	Certification body name — auto-resolved to id (or pass numeric id). See list_certification_bodies.
page	integer	optional	1-based page index.
page_size	integer	optional	Rows per page (max 50).

Raw schema

{
  "type": "object",
  "properties": {
    "number": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "ОТТС number, full or partial.",
      "title": "Number"
    },
    "vin": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "VIN substring (5-17 chars) — backend autoroute substring/DAWG.",
      "title": "Vin"
    },
    "brand": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Vehicle brand (e.g. 'Toyota').",
      "title": "Brand"
    },
    "type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Vehicle type / model (icontains).",
      "title": "Type"
    },
    "comm_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Commercial name (icontains).",
      "title": "Comm Name"
    },
    "chassis": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Chassis identifier (icontains).",
      "title": "Chassis"
    },
    "mods": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Modifications (icontains).",
      "title": "Mods"
    },
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Vehicle category (M1, N2, L3, …).",
      "title": "Category"
    },
    "eco_class": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Ecological class — pass '5' or the name; auto-resolved to reference id.",
      "title": "Eco Class"
    },
    "wheel_formula": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Wheel formula (e.g. '4x2'); auto-resolved to reference id.",
      "title": "Wheel Formula"
    },
    "axis_count": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Axle count (e.g. '2') or exact 'axes / wheels' (e.g. '2 / 4') — auto-resolved to reference id. A bare axle count may match several wheel configs; then candidates are returned to pick from.",
      "title": "Axis Count"
    },
    "issuer": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Certification body name — auto-resolved to id (or pass numeric id). See list_certification_bodies.",
      "title": "Issuer"
    },
    "page": {
      "default": 1,
      "description": "1-based page index.",
      "minimum": 1,
      "title": "Page",
      "type": "integer"
    },
    "page_size": {
      "default": 20,
      "description": "Rows per page (max 50).",
      "maximum": 50,
      "minimum": 1,
      "title": "Page Size",
      "type": "integer"
    }
  },
  "title": "search_ottsArguments"
}

search_otch

Search ОТШ (chassis type approvals).

Parameters12

number	any	optional	ОТШ number, full or partial.
vin	any	optional	VIN substring (5-17 chars).
brand	any	optional	Brand.
type	any	optional	Type / model.
comm_name	any	optional	Commercial name.
category	any	optional	Vehicle category.
eco_class	any	optional	Ecological class — '5' or name; auto-resolved to reference id.
wheel_formula	any	optional	Wheel formula (e.g. '4x2'); auto-resolved to reference id.
axis_count	any	optional	Axle count (e.g. '2') or exact 'axes / wheels' (e.g. '2 / 4') — auto-resolved to reference id. A bare axle count may match several wheel configs; then candidates are returned to pick from.
issuer	any	optional	Certification body name — auto-resolved to id (or pass numeric id).
page	integer	optional	1-based page index.
page_size	integer	optional	Rows per page (max 50).

Raw schema

{
  "type": "object",
  "properties": {
    "number": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "ОТШ number, full or partial.",
      "title": "Number"
    },
    "vin": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "VIN substring (5-17 chars).",
      "title": "Vin"
    },
    "brand": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Brand.",
      "title": "Brand"
    },
    "type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Type / model.",
      "title": "Type"
    },
    "comm_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Commercial name.",
      "title": "Comm Name"
    },
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Vehicle category.",
      "title": "Category"
    },
    "eco_class": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Ecological class — '5' or name; auto-resolved to reference id.",
      "title": "Eco Class"
    },
    "wheel_formula": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Wheel formula (e.g. '4x2'); auto-resolved to reference id.",
      "title": "Wheel Formula"
    },
    "axis_count": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Axle count (e.g. '2') or exact 'axes / wheels' (e.g. '2 / 4') — auto-resolved to reference id. A bare axle count may match several wheel configs; then candidates are returned to pick from.",
      "title": "Axis Count"
    },
    "issuer": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Certification body name — auto-resolved to id (or pass numeric id).",
      "title": "Issuer"
    },
    "page": {
      "default": 1,
      "description": "1-based page index.",
      "minimum": 1,
      "title": "Page",
      "type": "integer"
    },
    "page_size": {
      "default": 20,
      "description": "Rows per page (max 50).",
      "maximum": 50,
      "minimum": 1,
      "title": "Page Size",
      "type": "integer"
    }
  },
  "title": "search_otchArguments"
}

search_zotts

Search ЗОТТС (vehicle conformity assessment conclusion).

Parameters11

number	any	optional	ЗОТТС number.
vin	any	optional	VIN substring.
brand	any	optional	Brand.
type	any	optional	Type.
category	any	optional	Vehicle category.
eco_class	any	optional	Ecological class — '5' or name; auto-resolved to reference id.
wheel_formula	any	optional	Wheel formula (e.g. '4x2'); auto-resolved to reference id.
axis_count	any	optional	Axle count (e.g. '2') or exact 'axes / wheels' (e.g. '2 / 4') — auto-resolved to reference id. A bare axle count may match several wheel configs; then candidates are returned to pick from.
issuer	any	optional	Certification body name — auto-resolved to id (or pass numeric id).
page	integer	optional	1-based page index.
page_size	integer	optional	Rows per page (max 50).

Raw schema

{
  "type": "object",
  "properties": {
    "number": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "ЗОТТС number.",
      "title": "Number"
    },
    "vin": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "VIN substring.",
      "title": "Vin"
    },
    "brand": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Brand.",
      "title": "Brand"
    },
    "type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Type.",
      "title": "Type"
    },
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Vehicle category.",
      "title": "Category"
    },
    "eco_class": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Ecological class — '5' or name; auto-resolved to reference id.",
      "title": "Eco Class"
    },
    "wheel_formula": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Wheel formula (e.g. '4x2'); auto-resolved to reference id.",
      "title": "Wheel Formula"
    },
    "axis_count": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Axle count (e.g. '2') or exact 'axes / wheels' (e.g. '2 / 4') — auto-resolved to reference id. A bare axle count may match several wheel configs; then candidates are returned to pick from.",
      "title": "Axis Count"
    },
    "issuer": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Certification body name — auto-resolved to id (or pass numeric id).",
      "title": "Issuer"
    },
    "page": {
      "default": 1,
      "description": "1-based page index.",
      "minimum": 1,
      "title": "Page",
      "type": "integer"
    },
    "page_size": {
      "default": 20,
      "description": "Rows per page (max 50).",
      "maximum": 50,
      "minimum": 1,
      "title": "Page Size",
      "type": "integer"
    }
  },
  "title": "search_zottsArguments"
}

search_zotch

Search ЗОТШ (chassis conformity assessment conclusion).

Parameters11

number	any	optional	ЗОТШ number.
vin	any	optional	VIN substring.
brand	any	optional	Brand.
type	any	optional	Type.
category	any	optional	Vehicle category.
eco_class	any	optional	Ecological class — '5' or name; auto-resolved to reference id.
wheel_formula	any	optional	Wheel formula (e.g. '4x2'); auto-resolved to reference id.
axis_count	any	optional	Axle count (e.g. '2') or exact 'axes / wheels' (e.g. '2 / 4') — auto-resolved to reference id. A bare axle count may match several wheel configs; then candidates are returned to pick from.
issuer	any	optional	Certification body name — auto-resolved to id (or pass numeric id).
page	integer	optional	1-based page index.
page_size	integer	optional	Rows per page (max 50).

Raw schema

{
  "type": "object",
  "properties": {
    "number": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "ЗОТШ number.",
      "title": "Number"
    },
    "vin": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "VIN substring.",
      "title": "Vin"
    },
    "brand": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Brand.",
      "title": "Brand"
    },
    "type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Type.",
      "title": "Type"
    },
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Vehicle category.",
      "title": "Category"
    },
    "eco_class": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Ecological class — '5' or name; auto-resolved to reference id.",
      "title": "Eco Class"
    },
    "wheel_formula": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Wheel formula (e.g. '4x2'); auto-resolved to reference id.",
      "title": "Wheel Formula"
    },
    "axis_count": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Axle count (e.g. '2') or exact 'axes / wheels' (e.g. '2 / 4') — auto-resolved to reference id. A bare axle count may match several wheel configs; then candidates are returned to pick from.",
      "title": "Axis Count"
    },
    "issuer": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Certification body name — auto-resolved to id (or pass numeric id).",
      "title": "Issuer"
    },
    "page": {
      "default": 1,
      "description": "1-based page index.",
      "minimum": 1,
      "title": "Page",
      "type": "integer"
    },
    "page_size": {
      "default": 20,
      "description": "Rows per page (max 50).",
      "maximum": 50,
      "minimum": 1,
      "title": "Page Size",
      "type": "integer"
    }
  },
  "title": "search_zotchArguments"
}

search_sbkts

Search СБКТС (vehicle safety certificate).

Parameters18

number	any	optional	СБКТС number.
vin	any	optional	VIN (10-17 chars; substring/exact).
brand	any	optional	Brand.
type	any	optional	Type.
comm_name	any	optional	Commercial name.
engine	any	optional	ICE engine model (icontains).
year	any	optional	Manufacture year (YYYY).
motor	any	optional	Electric motor model (icontains).
motor_power	any	optional	Motor power (kW).
category	any	optional	Vehicle category.
eco_class	any	optional	Ecological class — '5' or name; auto-resolved to reference id.
wheel_formula	any	optional	Wheel formula (e.g. '4x2'); auto-resolved to reference id.
axis_count	any	optional	Axle count (e.g. '2') or exact 'axes / wheels' (e.g. '2 / 4') — auto-resolved to reference id. A bare axle count may match several wheel configs; then candidates are returned to pick from.
issuer	any	optional	Testing lab name — auto-resolved to id (or pass numeric id). See list_test_labs.
date_from	any	optional	Issue date from (YYYY-MM-DD).
date_to	any	optional	Issue date to (YYYY-MM-DD).
page	integer	optional	1-based page index.
page_size	integer	optional	Rows per page (max 50).

Raw schema

{
  "type": "object",
  "properties": {
    "number": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "СБКТС number.",
      "title": "Number"
    },
    "vin": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "VIN (10-17 chars; substring/exact).",
      "title": "Vin"
    },
    "brand": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Brand.",
      "title": "Brand"
    },
    "type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Type.",
      "title": "Type"
    },
    "comm_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Commercial name.",
      "title": "Comm Name"
    },
    "engine": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "ICE engine model (icontains).",
      "title": "Engine"
    },
    "year": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Manufacture year (YYYY).",
      "title": "Year"
    },
    "motor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Electric motor model (icontains).",
      "title": "Motor"
    },
    "motor_power": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Motor power (kW).",
      "title": "Motor Power"
    },
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Vehicle category.",
      "title": "Category"
    },
    "eco_class": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Ecological class — '5' or name; auto-resolved to reference id.",
      "title": "Eco Class"
    },
    "wheel_formula": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Wheel formula (e.g. '4x2'); auto-resolved to reference id.",
      "title": "Wheel Formula"
    },
    "axis_count": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Axle count (e.g. '2') or exact 'axes / wheels' (e.g. '2 / 4') — auto-resolved to reference id. A bare axle count may match several wheel configs; then candidates are returned to pick from.",
      "title": "Axis Count"
    },
    "issuer": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Testing lab name — auto-resolved to id (or pass numeric id). See list_test_labs.",
      "title": "Issuer"
    },
    "date_from": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Issue date from (YYYY-MM-DD).",
      "title": "Date From"
    },
    "date_to": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Issue date to (YYYY-MM-DD).",
      "title": "Date To"
    },
    "page": {
      "default": 1,
      "description": "1-based page index.",
      "minimum": 1,
      "title": "Page",
      "type": "integer"
    },
    "page_size": {
      "default": 20,
      "description": "Rows per page (max 50).",
      "maximum": 50,
      "minimum": 1,
      "title": "Page Size",
      "type": "integer"
    }
  },
  "title": "search_sbktsArguments"
}

search_zoets

Search ЗОЕТС (vehicle technical expertise conclusion).

Parameters18

number	any	optional	ЗОЕТС number.
vin	any	optional	VIN (10-17 chars).
brand	any	optional	Brand.
type	any	optional	Type.
comm_name	any	optional	Commercial name.
engine	any	optional	ICE engine model.
year	any	optional	Manufacture year.
motor	any	optional	Electric motor model.
motor_power	any	optional	Motor power (kW).
category	any	optional	Vehicle category.
eco_class	any	optional	Ecological class — '5' or name; auto-resolved to reference id.
wheel_formula	any	optional	Wheel formula (e.g. '4x2'); auto-resolved to reference id.
axis_count	any	optional	Axle count (e.g. '2') or exact 'axes / wheels' (e.g. '2 / 4') — auto-resolved to reference id. A bare axle count may match several wheel configs; then candidates are returned to pick from.
issuer	any	optional	Testing lab name — auto-resolved to id (or pass numeric id).
date_from	any	optional	Issue date from (YYYY-MM-DD).
date_to	any	optional	Issue date to (YYYY-MM-DD).
page	integer	optional	1-based page index.
page_size	integer	optional	Rows per page (max 50).

Raw schema

{
  "type": "object",
  "properties": {
    "number": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "ЗОЕТС number.",
      "title": "Number"
    },
    "vin": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "VIN (10-17 chars).",
      "title": "Vin"
    },
    "brand": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Brand.",
      "title": "Brand"
    },
    "type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Type.",
      "title": "Type"
    },
    "comm_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Commercial name.",
      "title": "Comm Name"
    },
    "engine": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "ICE engine model.",
      "title": "Engine"
    },
    "year": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Manufacture year.",
      "title": "Year"
    },
    "motor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Electric motor model.",
      "title": "Motor"
    },
    "motor_power": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Motor power (kW).",
      "title": "Motor Power"
    },
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Vehicle category.",
      "title": "Category"
    },
    "eco_class": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Ecological class — '5' or name; auto-resolved to reference id.",
      "title": "Eco Class"
    },
    "wheel_formula": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Wheel formula (e.g. '4x2'); auto-resolved to reference id.",
      "title": "Wheel Formula"
    },
    "axis_count": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Axle count (e.g. '2') or exact 'axes / wheels' (e.g. '2 / 4') — auto-resolved to reference id. A bare axle count may match several wheel configs; then candidates are returned to pick from.",
      "title": "Axis Count"
    },
    "issuer": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Testing lab name — auto-resolved to id (or pass numeric id).",
      "title": "Issuer"
    },
    "date_from": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Issue date from (YYYY-MM-DD).",
      "title": "Date From"
    },
    "date_to": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Issue date to (YYYY-MM-DD).",
      "title": "Date To"
    },
    "page": {
      "default": 1,
      "description": "1-based page index.",
      "minimum": 1,
      "title": "Page",
      "type": "integer"
    },
    "page_size": {
      "default": 20,
      "description": "Rows per page (max 50).",
      "maximum": 50,
      "minimum": 1,
      "title": "Page Size",
      "type": "integer"
    }
  },
  "title": "search_zoetsArguments"
}

search_sout

Search СУТ (vehicle type notification — small dataset, only basic fields).

Parameters5

number	any	optional	СУТ number.
brand	any	optional	Brand.
type	any	optional	Type.
page	integer	optional	1-based page index.
page_size	integer	optional	Rows per page (max 50).

Raw schema

{
  "type": "object",
  "properties": {
    "number": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "СУТ number.",
      "title": "Number"
    },
    "brand": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Brand.",
      "title": "Brand"
    },
    "type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Type.",
      "title": "Type"
    },
    "page": {
      "default": 1,
      "description": "1-based page index.",
      "minimum": 1,
      "title": "Page",
      "type": "integer"
    },
    "page_size": {
      "default": 20,
      "description": "Rows per page (max 50).",
      "maximum": 50,
      "minimum": 1,
      "title": "Page Size",
      "type": "integer"
    }
  },
  "title": "search_soutArguments"
}

search_by_vin

Aggregated search by VIN across all car-kinds (ОТТС/ОТШ/ЗОТТС/ЗОТШ/ СБКТС/ЗОЕТС). Open for any active API key — no subscription required. Returns substring matches via UNION across kind-tables sorted by `issue_date DESC`. For exact full-VIN match within a single kind, use the per-kind tool (search_otts/search_sbkts/…) — they autoroute substring↔DAWG by VIN validity.

Parameters1

vin

string

required

VIN substring or full code (5-17 chars).

Raw schema

{
  "type": "object",
  "properties": {
    "vin": {
      "description": "VIN substring or full code (5-17 chars).",
      "title": "Vin",
      "type": "string"
    }
  },
  "required": [
    "vin"
  ],
  "title": "search_by_vinArguments"
}

fulltext_search

Full-text search inside type-approval document bodies (PDF text). Covers ОТТС / ОТШ / ЗОТТС / ЗОТШ — kinds where `Document.fulltext` index is populated. СБКТС / ЗОЕТС / СУТ / cert / decl don't have fulltext index and are not searchable here. **Premium feature** — requires a paid MCP key with `use_fulltext` + subscription on at least one type-approval kind.

Parameters4

query	string	required	Free-text query (Russian, tsquery-syntax allowed).
kind	any	optional	Filter by registry kind. One of: otts, otch, zotts, zotch. Default: search across all 4 type-approval kinds.
page	integer	optional	1-based page index.
page_size	integer	optional	Rows per page (max 50).

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Free-text query (Russian, tsquery-syntax allowed).",
      "title": "Query",
      "type": "string"
    },
    "kind": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter by registry kind. One of: otts, otch, zotts, zotch. Default: search across all 4 type-approval kinds.",
      "title": "Kind"
    },
    "page": {
      "default": 1,
      "description": "1-based page index.",
      "minimum": 1,
      "title": "Page",
      "type": "integer"
    },
    "page_size": {
      "default": 20,
      "description": "Rows per page (max 50).",
      "maximum": 50,
      "minimum": 1,
      "title": "Page Size",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "title": "fulltext_searchArguments"
}

list_document_files

List the files attached to a document. Returns `[{file_uid, file_name, kind, pages_count, published_at}]` — each entry's `file_uid` can be passed to `download_document_file`. A document often has several PDFs (e.g. cleaned + original); use this tool to enumerate them and pick the right one before download.

Parameters2

document_slug	string	required	Document slug (from search.slug field).
kind	string	required	One of: otts, otch, zotts, zotch, sbkts, zoets, sout, cert, decl. Slug isn't globally unique between kinds, so kind is required.

Raw schema

{
  "type": "object",
  "properties": {
    "document_slug": {
      "description": "Document slug (from search.slug field).",
      "title": "Document Slug",
      "type": "string"
    },
    "kind": {
      "description": "One of: otts, otch, zotts, zotch, sbkts, zoets, sout, cert, decl. Slug isn't globally unique between kinds, so kind is required.",
      "title": "Kind",
      "type": "string"
    }
  },
  "required": [
    "document_slug",
    "kind"
  ],
  "title": "list_document_filesArguments"
}

download_document_file

Issue a signed URL to download the document PDF from hpt.su. Returns `{download_url, file_name, kind, document_id}`. The URL is encrypted with the user_id behind the API key — opening it works only if the user is signed in to hpt.su under the same account. The `dl_counter` is decremented on the website at actual download time, not here. Requires an active subscription covering the document's kind or a stand-alone DOC_PURCHASE. On the free tier returns 403 with an upgrade prompt to https://hpt.su/pricing/.

Parameters1

file_uid

string

required

DocumentFile UID (from list_document_files).

Raw schema

{
  "type": "object",
  "properties": {
    "file_uid": {
      "description": "DocumentFile UID (from list_document_files).",
      "title": "File Uid",
      "type": "string"
    }
  },
  "required": [
    "file_uid"
  ],
  "title": "download_document_fileArguments"
}

list_brands

Resolve a vehicle brand name to its canonical record (used to filter type approvals).

Parameters3

name	any	optional	Brand name substring (e.g. 'KAMAZ').
page	integer	optional	1-based page index.
page_size	integer	optional	Rows per page (max 50).

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Brand name substring (e.g. 'KAMAZ').",
      "title": "Name"
    },
    "page": {
      "default": 1,
      "description": "1-based page index.",
      "minimum": 1,
      "title": "Page",
      "type": "integer"
    },
    "page_size": {
      "default": 20,
      "description": "Rows per page (max 50).",
      "maximum": 50,
      "minimum": 1,
      "title": "Page Size",
      "type": "integer"
    }
  },
  "title": "list_brandsArguments"
}

list_vehicle_models

Resolve a vehicle model name (within a brand) to canonical record.

Parameters4

brand	any	optional	Brand name (auto-resolved to id) or numeric brand id.
name	any	optional	Model name substring.
page	integer	optional	1-based page index.
page_size	integer	optional	Rows per page (max 50).

Raw schema

{
  "type": "object",
  "properties": {
    "brand": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Brand name (auto-resolved to id) or numeric brand id.",
      "title": "Brand"
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Model name substring.",
      "title": "Name"
    },
    "page": {
      "default": 1,
      "description": "1-based page index.",
      "minimum": 1,
      "title": "Page",
      "type": "integer"
    },
    "page_size": {
      "default": 20,
      "description": "Rows per page (max 50).",
      "maximum": 50,
      "minimum": 1,
      "title": "Page Size",
      "type": "integer"
    }
  },
  "title": "list_vehicle_modelsArguments"
}

list_test_labs

Lookup accredited testing laboratories (issuers of СБКТС/ЗОЕТС).

Parameters4

name	any	optional	Lab name substring.
short_id	any	optional	Lab short identifier.
page	integer	optional	1-based page index.
page_size	integer	optional	Rows per page (max 50).

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Lab name substring.",
      "title": "Name"
    },
    "short_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Lab short identifier.",
      "title": "Short Id"
    },
    "page": {
      "default": 1,
      "description": "1-based page index.",
      "minimum": 1,
      "title": "Page",
      "type": "integer"
    },
    "page_size": {
      "default": 20,
      "description": "Rows per page (max 50).",
      "maximum": 50,
      "minimum": 1,
      "title": "Page Size",
      "type": "integer"
    }
  },
  "title": "list_test_labsArguments"
}

list_certification_bodies

Lookup accredited certification bodies (issuers of сертификатов/деклараций).

Parameters3

name	any	optional	Body name substring.
page	integer	optional	1-based page index.
page_size	integer	optional	Rows per page (max 50).

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Body name substring.",
      "title": "Name"
    },
    "page": {
      "default": 1,
      "description": "1-based page index.",
      "minimum": 1,
      "title": "Page",
      "type": "integer"
    },
    "page_size": {
      "default": 20,
      "description": "Rows per page (max 50).",
      "maximum": 50,
      "minimum": 1,
      "title": "Page Size",
      "type": "integer"
    }
  },
  "title": "list_certification_bodiesArguments"
}

list_tnved_codes

TN VED EAEU classifier lookup. Note: TN VED codes are linked **only** to certificates and declarations — not to vehicle type approvals or safety reports.

Parameters4

prefix	any	optional	TN VED code prefix (e.g. '8704').
query	any	optional	Free-text description search.
page	integer	optional	1-based page index.
page_size	integer	optional	Rows per page (max 50).

Raw schema

{
  "type": "object",
  "properties": {
    "prefix": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "TN VED code prefix (e.g. '8704').",
      "title": "Prefix"
    },
    "query": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Free-text description search.",
      "title": "Query"
    },
    "page": {
      "default": 1,
      "description": "1-based page index.",
      "minimum": 1,
      "title": "Page",
      "type": "integer"
    },
    "page_size": {
      "default": 20,
      "description": "Rows per page (max 50).",
      "maximum": 50,
      "minimum": 1,
      "title": "Page Size",
      "type": "integer"
    }
  },
  "title": "list_tnved_codesArguments"
}

list_registry_kinds

Return the catalogue of registry kinds exposed by the hpt.su public API.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "list_registry_kindsArguments"
}

README.md9 KBView on GitHub

hpt.su MCP Server

Model Context Protocol server for the hpt.su registry of Russian and EAEU vehicle compliance documents — type approvals (ОТТС / СБКТС / ОТШ), conformity certificates (ТР ТС / ТР ЕАЭС), declarations of conformity, type-approval notifications (СУТ), and single-vehicle evaluation reports.

What this is

hptsu-mcp lets any MCP-compatible AI assistant (Claude Desktop, Cursor, Cline, Continue, Goose, Cherry Studio, 5ire, LM Studio, ChatGPT Desktop, …) search the hpt.su registry directly — without you copy-pasting numbers between the chat window and the website.

hpt.su is the largest aggregated database in the Russian Federation and the EAEU customs union for:

Сертификаты соответствия — conformity certificates issued under TR CU / TR EAEU technical regulations. Browse at hpt.su/documents/cert/.
Декларации о соответствии — declarations of conformity. Browse at hpt.su/documents/decl/.
ОТТС — Vehicle Type Approval (Одобрение типа транспортного средства) under TR CU 018/2011 — covers automobiles, trucks, buses, trailers, motorcycles. Browse at hpt.su/documents/otts/.
СБКТС — Vehicle Safety-of-Design Certificate (Свидетельство о безопасности конструкции транспортного средства). Browse at hpt.su/documents/sbkts/.
ОТШ — Chassis Type Approval (Одобрение типа шасси). Browse at hpt.su/documents/otch/.
СУТ — Notification of Type Approval (Сообщение об утверждении типа транспортного средства). Browse at hpt.su/documents/sout/.
ЗОЕТС / ЗОТШ / ЗОТТС — single-vehicle / chassis / vehicle evaluation reports issued by accredited testing laboratories. Browse at hpt.su/documents/zoets/, zotch/, zotts/.

Use cases an LLM agent can solve through this server:

"Find the type approval for a 2024 KAMAZ-43118 truck."
"What is the status of EAC declaration ЕАЭС N RU Д-RU.HA67.B.12345/24?"
"List recent conformity certificates issued to applicant 'Group GAZ' under scheme 1с."
"Has SBKTS been issued for VIN-derived chassis number XYZ123…?"
"Fetch type-approval notifications (СУТ) issued for manufacturer X."

Quick start

1. Install

bash

uv tool install hptsu-mcp
# or
pipx install hptsu-mcp
# or with plain pip
pip install hptsu-mcp

2. Get an API key

Two tiers exist for MCP:

Tier	Throttle	Price	Where to get
Free MCP	50 requests/day	Free, signup required	hpt.su/user/mcp/
Paid MCP	10 000 requests/day, fulltext + downloads	See pricing	hpt.su/pricing/

The free tier is plenty for demos and personal use. Upgrade unlocks fulltext_search, download_document_file, the VIN aggregator, and the higher daily limit.

Create an account at hpt.su/accounts/signup/.
Click "Get free MCP key" in hpt.su/user/mcp/.
(Optional) Upgrade on hpt.su/pricing/.

API documentation (Swagger UI): https://hpt.su/api/v1/docs/ · OpenAPI schema: https://hpt.su/api/v1/schema/

3. Wire it into your MCP client

Claude Desktop (`claude_desktop_config.json`)

json

{
  "mcpServers": {
    "hpt-su": {
      "command": "hptsu-mcp",
      "env": {
        "HPTSU_API_KEY": "your-key-here"
      }
    }
  }
}

Cursor (`.cursor/mcp.json`)

json

{
  "mcpServers": {
    "hpt-su": {
      "command": "hptsu-mcp",
      "env": { "HPTSU_API_KEY": "your-key-here" }
    }
  }
}

Cline / Continue / Goose / etc.

Any MCP client that supports stdio transport works the same way — point it at the hptsu-mcp executable and pass HPTSU_API_KEY in the environment.

HTTP / SSE transport

For hosted MCP gateways set HPTSU_TRANSPORT=streamable-http (or sse) and call the server over the network.

Tools

Search & retrieval

Tool	What it does	Tier
`search_documents`	Cross-registry search by document number (any kind).	Free
`get_document`	Fetch a single Document by UUID.	Free
`search_certificates`	Conformity certificates — filter by number, applicant, status, scheme, TN VED code.	Free
`search_declarations`	Declarations of conformity.	Free
`search_type_approvals`	Vehicle (ОТТС) or chassis (ОТШ) type approvals — filter by brand / model / year / applicant.	Free
`search_safety_reports`	СБКТС / СУТ / ЗОЕТС / ЗОТШ / ЗОТТС feeds.	Free
`search_by_vin`	Aggregated VIN search across ОТТС / СБКТС / ЗОЕТС / ЗОТТС.	Free
`fulltext_search`	Full-text search inside PDF bodies.	Paid
`download_document_file`	Issue a time-limited signed PDF download URL.	Paid

Reference dictionaries

Tool	What it does
`list_brands`	Resolve vehicle brand names.
`list_vehicle_models`	Resolve vehicle model names within a brand.
`list_test_labs`	Accredited testing laboratories.
`list_certification_bodies`	Accredited certification bodies.
`list_tnved_codes`	TN VED EAEU classifier (cert/decl context only).
`list_registry_kinds`	Enumerate registry kinds the API exposes.

Reference filters accept names, not internal ids. The search tools resolve human-readable values automatically — pass issuer="НАМИ", brand="KAMAZ", eco_class="5", wheel_formula="4x2", axis_count="2" and the server looks up the reference id for you (issuer / brand also take a numeric id directly). An ambiguous name returns the matching candidates to pick from.

Configuration

Variable	Default	Meaning
`HPTSU_API_KEY`	required	Bearer key from hpt.su cabinet.
`HPTSU_BASE_URL`	`https://hpt.su/api/v1`	Override for staging / on-prem deployments.
`HPTSU_TRANSPORT`	`stdio`	`stdio` · `streamable-http` · `sse`.
`HPTSU_TIMEOUT`	`30.0`	Per-request HTTP timeout (s).
`HPTSU_USER_AGENT`	`hptsu-mcp/0.1`	User-Agent header.
`HPTSU_LOG_LEVEL`	`INFO`	Standard `logging` levels.

SEO description (for catalogue listings)

hpt.su MCP server — let your AI assistant search the hpt.su database of Russian and EAEU vehicle compliance documents directly. Covers type approvals (ОТТС, ОТШ), safety-of-design certificates (СБКТС), conformity certificates and declarations under TR CU / TR EAEU technical regulations, and type-approval notifications (СУТ). Source registry: https://hpt.su. API documentation: https://hpt.su/api/v1/docs/. Read-only, Bearer-key auth, MIT licence.

Russian-language version:

MCP-сервер hpt.su — поиск по крупнейшей базе российских и ЕАЭС документов соответствия для автотранспорта: ОТТС, СБКТС, ОТШ, СУТ (сообщения об утверждении типа), сертификаты соответствия и декларации (ТР ТС / ТР ЕАЭС). Источник: https://hpt.su. REST API: https://hpt.su/api/v1/docs/. Только чтение, Bearer-аутентификация, лицензия MIT.

Keywords

mcp · model-context-protocol · hpt.su · vehicle certification · type approval · ОТТС · СБКТС · EAEU · TR CU 018 · conformity certificate · declaration of conformity · сертификат соответствия · декларация о соответствии · СУТ · Russian compliance database · AI agent · Claude · Cursor · Cline

Development

bash

git clone https://github.com/hpt-su/hptsu-mcp
cd hptsu-mcp
uv sync --all-groups
uv run pytest
uv run hptsu-mcp           # launch via stdio

License

MIT — see LICENSE.

Install

Tools (21)

search_documentsget_documentsearch_certificatessearch_declarationssearch_ottssearch_otchsearch_zottssearch_zotch

Configuration

Environment variables

HPTSU_API_KEYrequiredsecret

X-API-Key issued in the hpt.su cabinet (requires MCP_FREE or MCP_PAID scope).

HPTSU_BASE_URLdefault https://hpt.su/api/v1

Override of the API base URL.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "hptsu-mcp": {
      "command": "uvx",
      "args": [
        "hptsu-mcp"
      ],
      "env": {
        "HPTSU_API_KEY": "<YOUR_HPTSU_API_KEY>",
        "HPTSU_BASE_URL": "https://hpt.su/api/v1"
      }
    }
  }
}

search_documents

get_document

search_certificates

search_declarations

search_otts

search_otch

search_zotts

search_zotch

search_sbkts

search_zoets

search_sout

search_by_vin

fulltext_search

list_document_files

download_document_file

list_brands

list_vehicle_models

list_test_labs

list_certification_bodies

list_tnved_codes

list_registry_kinds

hpt.su MCP Server

What this is

Quick start

1. Install

2. Get an API key

3. Wire it into your MCP client

Claude Desktop (claude_desktop_config.json)

Cursor (.cursor/mcp.json)

Cline / Continue / Goose / etc.

HTTP / SSE transport

Tools

Search & retrieval

Reference dictionaries

Configuration

SEO description (for catalogue listings)

Keywords

Development

License

Links

Install

Configuration

Claude Desktop (`claude_desktop_config.json`)

Cursor (`.cursor/mcp.json`)