Solicitar adjuntos de Compra Ágil


Tool ID	`mercadopublico.compra_agil.solicitar`
Nombre MCP	`mercadopublico__compra_agil__solicitar`
Conector	`mercadopublico`
Plano	`action`
Scope (permiso)	`mercadopublico:write`
Auth	`none`
Versión	`1`
Sensible	no
Deprecado	no
Comportamiento	readOnly=false, destructive=false, idempotent=true, openWorld=false

Requiere conexión. Indica cuál en cada llamada: header X-Connect-Connection en REST y campo connectionId en el execute_write de MCP. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale de conexiones.estado.consultar.

Qué hace

Lee su listado en Mercado Público y descarga los PDF, Word, Excel e imágenes PNG/JPEG, sin clasificar su contenido. Devuelve el estado del trabajo; consulta luego mercadopublico.compra_agil.consultar. Reutiliza solicitudes en curso y resultados completos de las últimas 24 horas; un resultado parcial se puede volver a solicitar a los 15 minutos para continuar lo pendiente sin volver a bajar lo ya conservado.

Entrada

Campo	Tipo	Requerido	Descripción
`codigo`	string `^\d{1,10}-\d{1,10}-COT\d{2}$`	sí	Código público de la Compra Ágil, por ejemplo 1057539-228-COT26. No acepta URLs.

JSON Schema de entrada

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "codigo": {
      "type": "string",
      "maxLength": 40,
      "pattern": "^\\d{1,10}-\\d{1,10}-COT\\d{2}$",
      "description": "Código público de la Compra Ágil, por ejemplo 1057539-228-COT26. No acepta URLs."
    }
  },
  "required": [
    "codigo"
  ]
}

Salida

Campo	Tipo	Requerido	Descripción
`codigo`	string	sí	Código o ID público consultado, canonizado en mayúsculas.
`estado`	`"no_solicitada"` · `"pendiente"` · `"procesando"` · `"disponible"` · `"parcial"` · `"fallido"`	sí	Estado de la descarga solicitada a Connect.
`solicitadoEn`	string	null	sí
`finalizadoEn`	string	null	sí
`errorCodigo`	string	null	sí
`consultarEnSegundos`	entero	null	sí

JSON Schema de salida

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "codigo": {
      "type": "string",
      "description": "Código o ID público consultado, canonizado en mayúsculas."
    },
    "estado": {
      "type": "string",
      "enum": [
        "no_solicitada",
        "pendiente",
        "procesando",
        "disponible",
        "parcial",
        "fallido"
      ],
      "description": "Estado de la descarga solicitada a Connect."
    },
    "solicitadoEn": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Instante ISO 8601 de la última solicitud, o null si no existe."
    },
    "finalizadoEn": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Instante ISO 8601 en que terminó la descarga, si corresponde."
    },
    "errorCodigo": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Código acotado de fallo, sin datos de sesión ni URLs del portal."
    },
    "consultarEnSegundos": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ],
      "description": "Mientras la descarga está pendiente o en proceso, cuántos segundos esperar antes de consultar de nuevo. null cuando ya terminó o no hay solicitud."
    }
  },
  "required": [
    "codigo",
    "estado",
    "solicitadoEn",
    "finalizadoEn",
    "errorCodigo",
    "consultarEnSegundos"
  ],
  "additionalProperties": false
}

Errores de esta tool

Código	HTTP	Reintentable	Qué hacer
`connection_disabled`	403	no	Reactívala en /connections o usa otra conexión del mismo sistema.
`connection_not_found`	404	no	Usa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada.

Toda llamada puede devolver además los códigos transversales (validation_error, unauthorized, scope_not_granted, rate_limited, entre otros): el detalle vive en el catálogo de errores.

Solicitar adjuntos de Compra Ágil

Qué hace

Entrada

Salida

Errores de esta tool

En esta página