Herramientas de MCP

Identificá un vehículo#

Usá consultar_vehiculo para obtener los datos básicos disponibles por patente. Requiere mcp:query y autorización previa para consumir 1 consulta de patente, incluso si no devuelve datos o los obtiene de caché.

Ejemplo de argumentos#

{
  "patente": "AB123CD",
  "confirmar_consumo": true
}

Respuesta#

Devuelve operation y consumption. Los datos del vehículo están en operation.result. Este extracto ficticio muestra una consulta completada sin registros; también consume una unidad.

{
  "operation": {
    "kind": "vehicle",
    "status": "completed",
    "result": {
      "success": true,
      "found": false,
      "data": null
    }
  },
  "consumption": {
    "plateQueries": 1,
    "moduleQueries": 0
  }
}

• Campos de los datos del vehículo

Consultá multas, VTV, deuda o GNC#

Usá consultar_modulos para iniciar una consulta asíncrona. Requiere mcp:query; recuperar el resultado requiere también mcp:read. Una operación nueva consume una consulta por módulo solicitado.

Módulos disponibles#

Podés solicitar de uno a cuatro módulos distintos. La disponibilidad para tu cuenta depende de tu plan.

Ejemplo de argumentos#

{
  "patente": "AB123CD",
  "modulos": [
    "vtv"
  ],
  "confirmar_consumo": true
}

Respuesta#

Devuelve operation, reused y consumption. Guardá operation.id y seguí con consultar_operacion. Extracto ficticio de una operación nueva:

{
  "operation": {
    "id": "op_92cff723-014a-4b1a-aa26-82bb5287e6aa",
    "kind": "modules",
    "status": "queued",
    "plate": "AB123CD",
    "modules": {
      "vtv": {
        "status": "queued",
        "data": null,
        "error": null
      }
    }
  },
  "reused": false,
  "consumption": {
    "plateQueries": 0,
    "moduleQueries": 1
  }
}

Una solicitud idéntica en curso se reutiliza sin unidades adicionales, incluso entre API y MCP de la misma cuenta. Volver a solicitarla después de que terminó crea una consulta nueva y vuelve a consumir cupo.

• Seguir operaciones sin repetir la consulta

Recuperá el resultado de una operación#

Usá consultar_operacion para recuperar el estado y los resultados de una operación de tu cuenta. Requiere mcp:read; no consume unidades de consulta.

{
  "id": "op_92cff723-014a-4b1a-aa26-82bb5287e6aa"
}

El argumento id es el operation.id devuelto al iniciar la consulta, con formato op_<uuid>. La respuesta es la operación directamente, sin otro campo operation que la envuelva.

Respuesta#

Extracto ficticio de la misma operación anterior, ahora completada sin registros de VTV. No implica que el vehículo carezca de revisiones.

{
  "id": "op_92cff723-014a-4b1a-aa26-82bb5287e6aa",
  "kind": "modules",
  "status": "completed",
  "plate": "AB123CD",
  "modules": {
    "vtv": {
      "status": "completed",
      "data": {
        "total": 0,
        "items": []
      },
      "error": null
    }
  }
}

• Estructura y estados de las operaciones

Consultá el consumo de tu cuenta#

Usá consultar_consumo para revisar el plan, permisos, cupos y consumo de la cuenta que autorizaste. Requiere mcp:read; no consume unidades de consulta. Enviá un objeto vacío:

{}

Devuelve entitlements, los cupos plateQueries, moduleQueries, uniquePlates y requests, y el desglose byChannel entre API y MCP. Los cupos incluyen límite, uso, unidades restantes y período; no son una cotización monetaria.

• Campos y ejemplo de consumo
• Ver tus consumos

Cuándo se consume cupo#

MCP utiliza los mismos cupos y reglas comerciales que tu API. No tiene una suscripción ni un saldo separado. Consultá el precio y las condiciones de tu plan; las unidades disponibles no son una cotización monetaria.

Por ejemplo, pedir multas y VTV en una nueva operación utiliza 2 consultas de módulos. Consultar además los datos básicos del vehículo utiliza 1 consulta de patente. Listar herramientas, consultar el estado de una operación y revisar el consumo no descuentan esas unidades.

Todas las solicitudes autenticadas al servidor MCP, incluidas inicialización, listado, ping, estado y consumo, cuentan para el límite de solicitudes por minuto compartido. Los endpoints OAuth tienen limitadores propios.

• Cupos y reglas de consumo de la API
• Planes y precios

Alcance de los resultados#

Los datos dependen de las fuentes consultadas y su cobertura. Un resultado vacío indica que no se devolvieron registros; no garantiza ausencia de multas, deudas o antecedentes.

En VTV/RTO, una revisión aprobada, su fecha y el vencimiento informado son datos distintos. No deduzcas vigencia únicamente de una revisión aprobada.

MCP no ofrece información de titulares. Esa información corresponde al Informe de Dominio, un producto con un flujo independiente.

• Consultar fuentes y cobertura