Herramientas
El servidor MCP de Platica publica una herramienta por cada endpoint productivo de la API REST. Usa tools/list para ver el catálogo actualizado en cualquier momento.
Convenciones de nombre
Todas las herramientas siguen el patrón verbo_recurso en snake_case:
| Verbo | Significado |
|---|---|
list_* | Listar todos los elementos de un recurso (paginado). |
get_* | Obtener un elemento individual por ID o identificador único. |
create_* | Crear un nuevo elemento. |
update_* | Actualizar parcialmente un elemento existente. |
reschedule_* | Cambiar la fecha de ejecución de un elemento programado. |
delete_* | Eliminar un elemento. |
cancel_* | Cancelar una operación pendiente sin eliminar su historial. |
send_* | Enviar/disparar algo (mensajes, campañas). |
Anotaciones (annotations)
Cada herramienta incluye anotaciones MCP que ayudan al cliente a entender su naturaleza:
| Anotación | Cuándo se usa |
|---|---|
readOnlyHint: true | Sólo lee datos (list_*, get_*). El cliente puede ejecutarla sin pedir confirmación. |
destructiveHint: true | Elimina o modifica masivamente (delete_*, clear_campaign_audience). |
idempotentHint: true | Llamar varias veces con los mismos argumentos produce el mismo resultado. |
Las anotaciones son hints, no controles de seguridad. La seguridad real viene de la credencial (OAuth o API Key) y de la validación que hace cada endpoint REST.
Catálogo por recurso
| Recurso | Página |
|---|---|
| Workspaces | Workspaces |
| Chat | Chat |
| Mensajes | Mensajes |
| Conversaciones | Conversaciones |
| Clientes | Clientes |
| Agentes | Agentes |
| Herramientas | Herramientas |
| Canales | Canales |
| Estadísticas | Estadísticas |
| Campañas | Campañas |
| Plantillas WhatsApp | Plantillas |
| Webhooks | Webhooks |
| Campos personalizados | Campos personalizados |
| Etiquetas | Etiquetas |
Cómo descubrirlas en runtime
Cualquier cliente MCP descubre la lista actualizada llamando al método JSON-RPC tools/list:
curl -X POST https://api.platica.mx/mcp \
-H "Authorization: Bearer pl_at_..." \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}'Con OAuth, list_workspaces es la primera tool que debe correr el modelo: es la que le da los IDs que van en el argumento workspace. Ver Autenticación .
La respuesta incluye name, title, description, inputSchema (JSON Schema) y annotations para cada herramienta.