Solicitar descarga de adjuntos de una licitación

Encola la descarga de los adjuntos PDF, Word (.docx, .doc), Excel (.xlsx, .xls) e imágenes (.png, .jpg, .jpeg) desde el portal de Mercado Público, sin utilizar su API y sin seleccionar por nombre o descripción.


Tool ID	`mercadopublico.adjuntos.solicitar`
Nombre MCP	`mercadopublico__adjuntos__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, campo connectionId en el execute_write de MCP y en las opciones del SDK. 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

Conserva los archivos originales y sus metadatos, sin clasificar su contenido. Devuelve el estado del trabajo; consulta luego mercadopublico.adjuntos.consultar. Reutiliza solicitudes en curso y resultados de las últimas 24 horas.

Entrada

Campo	Tipo	Requerido	Descripción
`codigoLicitacion`	string `^\d+-\d+-[A-Z0-9]+$`	sí	ID público de la licitación, por ejemplo 803-6-LE26. No acepta URLs.

JSON Schema de entrada

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "codigoLicitacion": {
      "type": "string",
      "maxLength": 50,
      "pattern": "^\\d+-\\d+-[A-Z0-9]+$",
      "description": "ID público de la licitación, por ejemplo 803-6-LE26. No acepta URLs."
    }
  },
  "required": [
    "codigoLicitacion"
  ]
}

Salida

Campo	Tipo	Requerido	Descripción
`codigoLicitacion`	string	sí	ID público de la licitación consultada.
`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": {
    "codigoLicitacion": {
      "type": "string",
      "description": "ID público de la licitación consultada."
    },
    "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 volver a llamar a mercadopublico.adjuntos.consultar. null cuando ya terminó o no hay solicitud."
    }
  },
  "required": [
    "codigoLicitacion",
    "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.

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 descarga de adjuntos de una licitación

Qué hace

Entrada

Salida

Errores de esta tool

En esta página