Integraciones públicas · v1.1

Consulta, publica y coordina ayuda desde cualquier aplicación.

La API y el MCP comparten el panorama actual de Corag: emergencias, ubicaciones, cantidades, cobertura, logística y línea de tiempo pública. Los registros nuevos aparecen en el mapa y el listado.

OpenAPI 3.1 Ver panorama JSON

REST API

GET y POST /api/public/v1/help

Consulta panorama, busca ayudas, abre su trazabilidad o publica. Usa el mismosource y externalId al reintentar: Corag no duplicará el registro.

MCP remoto

https://ayuda.corag.app/mcp

Agrega esta URL como servidor MCP. Permite consultar el panorama, buscar y abrir ayudas con trazabilidad, además de publicar solicitudes y ofrecimientos.

Protocolo Cabuya · 0.1

/.well-known/cabuya.json

Corag publica sus centros de acopio en el Protocolo Cabuya, el formato abierto con el que las aplicaciones de ayuda leen los datos unas de otras. El manifiesto declara además esta API y este MCP. El feed de lugares está en /api/cabuya/places.

Objetivo declarado: L1. El nivel real lo mide el validador del protocolo, no nosotros, y hoy ese validador todavía no se publica: hasta que se pueda medir, no declaramos más de lo comprobable.

Reglas del contrato público

El feed no lleva personasLa exclusión §7.1 del protocolo es una prohibición de cruce: se federan lugares, y desde una ruta que no sirve a la vez solicitudes con nombre y WhatsApp. Del contacto viaja el hecho, nunca el número.

Idempotenciasource + externalIdidentifican cada publicación.

Privacidad explícitapublishContact autoriza el contacto público; ningún documento del solicitante se expone.

Datos operativosLas solicitudes incluyen ubicación y cantidad; logística admite vehículo, capacidad, zonas y vigencia.

Lectura pública

Consultar el panorama

curl "https://ayuda.corag.app/api/public/v1/help?view=panorama"

Filtros combinados

Buscar necesidades urgentes y cercanas

curl "https://ayuda.corag.app/api/public/v1/help?view=list&type=request&category=alimentos&priority=urgent&latitude=4.8133&longitude=-75.6961&radiusKm=25"

Consulta 3

Qué tienen y qué les falta los acopios

Cantidades declaradas por cada centro. Concategoria responde quién ya tiene algo en la ciudad; cada línea trae hoursSinceUpdate y stale, porque pasadas 24 horas la cantidad puede ya no estar.

curl "https://ayuda.corag.app/api/public/v1/inventario?categoria=panales"

Publicación 1

Publicar una solicitud con cantidad

curl -X POST https://ayuda.corag.app/api/public/v1/help \
  -H "Content-Type: application/json" \
  -d '{
    "type": "request",
    "source": "mi-app",
    "externalId": "caso-1842",
    "emergencySlug": "eje-cafetero",
    "title": "Se necesitan alimentos",
    "description": "Para 12 familias",
    "category": "alimentos",
    "urgency": "urgent",
    "resourceLabel": "Mercados familiares",
    "quantityRequired": 12,
    "unit": "mercados",
    "address": "Vereda La Esperanza",
    "latitude": 4.8133,
    "longitude": -75.6961,
    "contactName": "Ana Gómez",
    "contactWhatsapp": "+573001234567",
    "publishContact": true
  }'

Publicación 2

Publicar una capacidad logística

curl -X POST https://ayuda.corag.app/api/public/v1/help \
  -H "Content-Type: application/json" \
  -d '{
    "type": "offer",
    "source": "mi-app",
    "externalId": "oferta-207",
    "emergencySlug": "eje-cafetero",
    "title": "Camioneta disponible",
    "description": "Disponible durante la tarde",
    "category": "transporte",
    "vehicle": "Camioneta",
    "capacityKg": 500,
    "capacityBoxes": 30,
    "passengerCapacity": 3,
    "zones": "Pereira, Dosquebradas y Santa Rosa",
    "availableUntil": "2026-08-20",
    "address": "Centro de Pereira",
    "latitude": 4.8133,
    "longitude": -75.6961,
    "contactName": "Luis Pérez",
    "contactWhatsapp": "+573101234567",
    "publishContact": true
  }'

Herramientas MCP disponibles11

Entender la emergenciaPor dónde empieza un agente que no sabe nada del territorio.

listar_emergenciasListar emergencias activasLos identificadores de las emergencias abiertas. Casi todo lo demás recibe uno.

consultar_panoramaConsultar panorama públicoCuántas solicitudes activas, urgentes y en proceso hay, y cuánta cobertura.

Encontrar y verificarBuscar necesidades y ayudas, y leer su trazabilidad antes de mover a nadie.

buscar_ayudasBuscar solicitudes y ayudas ofrecidasPor categoría, prioridad, estado, texto, cercanía o capacidad logística.

ver_ayudaVer detalle y línea de tiempoCobertura, contacto público y qué ha pasado con una ayuda concreta.

buscar_operaciones_logisticasBuscar operaciones logísticasTraslados con origen y destino confirmados que esperan quién los haga.

consultar_inventario_acopiosQué tienen y qué les falta los acopiosCantidades por centro. Filtra por categoría para saber quién ya tiene algo en la ciudad antes de salir a comprarlo.

Contexto del terrenoLo que no es una necesidad pero cambia lo que se puede recomendar.

consultar_reportes_de_terrenoVías y edificaciones reportadasReportes de Pereira Responde de las últimas 72 horas. Para no mandar un vehículo por donde no se pasa.

consultar_mascotas_perdidasMascotas perdidas y encontradasAnuncios de encuentratumascota.co en Pereira y Dosquebradas. Publicar uno nuevo se hace allá.

consultar_ecosistemaDirectorio de apps del ecosistemaQué hace cada aplicación de la respuesta, su enlace y si tiene API o MCP propios. Para derivar cuando Corag no es la herramienta.

PublicarIdempotentes por source y externalId. Un líder revisa antes de que aparezca en el mapa.

publicar_solicitudEnviar una necesidad a revisiónGeorreferenciada y con contacto publicable. Responde con el identificador de la bandeja.