Herramientas
El servidor MCP de Platica publica 62 herramientas, una por cada endpoint productivo de la API REST.
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. |
delete_* | Eliminar un elemento. |
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. |
Invalid note type. Should be either "note", "tip", "important", "warning", "caution"
Catálogo por recurso
| Recurso | # tools | Página |
|---|---|---|
| Mensajes | 2 | Mensajes |
| Conversaciones | 3 | Conversaciones |
| Clientes | 5 | Clientes |
| Agentes | 26 | Agentes |
| Campañas | 10 | Campañas |
| Plantillas WhatsApp | 2 | Plantillas |
| Webhooks | 6 | Webhooks |
| Campos personalizados | 4 | Campos personalizados |
| Etiquetas | 4 | Etiquetas |
| Total | 62 | — |
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_key_..." \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}'La respuesta incluye name, title, description, inputSchema (JSON Schema) y annotations para cada herramienta.