Public integrations · v1.1

Query, publish and coordinate aid from any application.

The API and the MCP share Corag's current overview: emergencies, locations, quantities, coverage, logistics and the public timeline. New records appear on the map and in the list.

OpenAPI 3.1 View the JSON overview

REST API

GET and POST /api/public/v1/help

Query the overview, search for help, open its traceability or publish. Use the samesource y externalId when retrying: Corag will not duplicate the record.

Remote MCP

https://ayuda.corag.app/mcp

Add this URL as an MCP server. It lets you query the overview, search and open help with traceability, and publish requests and offers.

Cabuya Protocol · 0.1

/.well-known/cabuya.json

Corag publishes its collection centers in the Cabuya Protocol, the open format aid applications use to read each other's data. The manifest also declares this API and this MCP. The places feed is at /api/cabuya/places.

Declared target: L1. The real level is measured by the protocol's validator, not by us, and that validator is not published yet: until it can be measured, we declare no more than what can be checked.

Rules of the public contract

The feed carries no peopleThe protocol's §7.1 exclusion is a prohibition on crossing: places are federated, and from a route that does not also serve requests carrying names and WhatsApp numbers. Of the contact, the fact travels — never the number.

Idempotencysource + externalIdidentify each publication.

Explicit privacypublishContact authorizes public contact; no document belonging to the requester is exposed.

Operational dataRequests include location and quantity; logistics accepts vehicle, capacity, areas and validity.

Public reads

Query the overview

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

Combined filters

Search urgent needs nearby

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"

Query 3

What the collection centers have and what they lack

Quantities declared by each center. Withcategoria responde quién ya tiene algo en la ciudad; cada línea trae hoursSinceUpdate y stale, because after 24 hours the quantity may no longer hold.

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

Publish 1

Publish a request with a quantity

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
  }'

Publish 2

Publish a logistics capacity

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
  }'

MCP tools available11

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.