Saltar al contenido

Tools disponibles

Las tools MCP de LicitaIQ se agrupan por operación. Las respuestas de cuenta, estado y preparación incluyen la matriz de capacidades y los próximos pasos; úsala como autoridad para decidir qué mostrar o ejecutar.

Cuenta y límites

  • get_account_status: devuelve billing, límites MCP, uso mensual, complementos y capacidades disponibles.

Licitaciones

  • search_tenders: busca licitaciones por palabra clave, estado, fechas, orden y paginación. Es catálogo gratuito.
  • get_tender: entrega metadata útil de una licitación. Es catálogo gratuito; no expone estado documental o insights sin la capacidad correspondiente.
  • get_tender_status: muestra el estado agregado, readiness y próximos pasos, incluso para orientar desde el catálogo.
  • activate_tender: carga la ficha general si falta. Si ya está cargada, puede iniciar la preparación documental y debe llamarse solo con consentimiento explícito del usuario.
  • refresh_tender: actualiza metadata desde Mercado Público; no inicia preparación documental ni consume una preparación.

Archivos y procesamiento

  • refresh_tender_preparation: lee el estado agregado y el manifiesto por archivo sin iniciar un workflow nuevo.
  • list_tender_files: lista archivos asociados y sus estados.
  • download_tender_files: inicia o reutiliza el flujo de preparación documental. Consume un cupo una sola vez cuando la preparación se completa con los archivos descubiertos descargados, procesados e indexados para consulta documental. Un estado partial con ready_for_retrieval: true mantiene los documentos disponibles sin crear ni revertir ese consumo.
  • retry_tender_processing: reintenta un único archivo fallido persistido mediante su file_ref opaco. Requiere que el manifiesto lo marque como reintentable; no vuelve a procesar archivos ya disponibles.

Retrieval documental

  • search_tender_documents: busca dentro de documentos procesados y devuelve chunks, fuente, score/cita y metadata.
  • ask_tender: recibe una pregunta y devuelve evidencia documental relevante para que el agente genere la respuesta final.
  • get_tender_summary: devuelve el resumen base ya cacheado cuando existe.

Las tools de retrieval no generan una respuesta final con IA de LicitaIQ. Entregan evidencia para que ChatGPT, Claude u otro agente decida cómo usarla. search_tender_documents y ask_tender consumen búsquedas documentales MCP.

Pipeline

  • list_pipeline_tenders
  • add_tender_to_pipeline
  • update_pipeline_tender
  • remove_tender_from_pipeline
  • get_pipeline_stats

Orquestación

  • prepare_tender_for_agent: tool de alto nivel para cargar metadata o iniciar la preparación explícita solicitada. Si debe cargar metadata primero, vuelve a llamarla cuando el estado sea files_not_started para iniciar la preparación.

Semántica compartida

  • Una preparación nueva valida la capacidad preparation antes de iniciar.
  • refresh_tender_preparation solo actualiza el manifiesto; no inicia ni cobra.
  • El reintento usa file_ref, no IDs internos, claves de almacenamiento ni identificadores de proveedores.
  • Si una preparación ya está en curso, las tools devuelven que el workflow está activo en vez de duplicarlo.
  • partial y failed se resuelven mirando el manifiesto. No asumas que todo archivo fallido es reintentable.

Consulta Preparación documental para la tabla completa de estados y errores.

Consulta también Scopes y seguridad.