Saltar al contenido principal

MCP · Tool Calls

WhatsUY expone un endpoint estilo Model Context Protocol para que agentes IA externos invoquen funciones predefinidas sobre el modelo de datos.

Internamente, McpOrchestratorService valida los argumentos, aplica rate-limit y audita cada invocación.

Listar funciones disponibles​

GET /whats-uy-mcp/functions
Authorization: Bearer <jwt>

Respuesta:

{
  "version": "1.0.0",
  "count": 12,
  "functions": [
    {
      "name": "toggle_bot",
      "description": "Activa o desactiva el bot en un chat",
      "arguments": {
        "reference": { "type": "number", "required": true },
        "chatId": { "type": "string", "required": true },
        "active": { "type": "boolean", "required": true }
      },
      "returns": {
        "type": "object",
        "properties": {
          "chatId": { "type": "string" },
          "reference": { "type": "number" },
          "botActive": { "type": "number" },
          "previousState": { "type": "number" }
        }
      }
    }
  ]
}

Ejecutar una función​

POST /whats-uy-mcp/execute
Authorization: Bearer <jwt>
{
  "function": "toggle_bot",
  "arguments": {
    "reference": 12345,
    "chatId": "59891234567@s.whatsapp.net",
    "active": false
  }
}

Respuesta:

{
  "success": true,
  "function": "toggle_bot",
  "result": {
    "chatId": "59891234567@s.whatsapp.net",
    "reference": 12345,
    "botActive": 0,
    "previousState": 1
  },
  "error": null,
  "executionTime": 42,
  "timestamp": "2026-07-26T18:30:00.000Z"
}

Ejecución en batch​

POST /whats-uy-mcp/batch

Permite ejecutar múltiples funciones en paralelo. Cada item devuelve su propio resultado o error.

Funciones típicas disponibles​

  • toggle_bot
  • send_message
  • mark_read
  • set_variable
  • get_chat_history
  • set_bot_active
  • get_reference_status
  • ...

Detalle: api-documentation/10-mcp.mdx.