Herramientas
El servidor MCP de Platica ofrece un catálogo completo en /mcp y un perfil reducido para plugins en /mcp/apps. Usa tools/list sobre el perfil conectado para consultar sus herramientas, descripciones, esquemas y anotaciones actualizados. Una herramienta excluida del perfil tampoco se puede ejecutar por esa ruta.
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. |
search_* | Buscar por texto. |
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 | Lee datos sin efectos secundarios. No se deduce solo del nombre list_* o get_*. |
destructiveHint: true | Elimina o modifica masivamente (delete_*, clear_campaign_audience). |
openWorldHint: true | Interactúa con sistemas externos, incluida la lectura de una URL o el envío a un canal. |
idempotentHint: true | Llamar varias veces con los mismos argumentos produce el mismo resultado. |
Las anotaciones son hints, no controles de seguridad ni autorizaciones para actuar. La seguridad real viene de la credencial (OAuth o API Key) y de la validación que hace cada endpoint REST. Las solicitudes y confirmaciones del usuario se gestionan en el cliente y la skill del plugin.
Catálogo de plugins
La siguiente selección corresponde al perfil reducido. Las páginas enlazadas describen cada operación; sigue el esquema de entrada que devuelve tools/list en el servidor conectado. Comprueba que la herramienta solicitada esté disponible antes de prometer o intentar una acción.
| Recurso | Herramientas disponibles en /mcp/apps |
|---|---|
| Workspaces | list_workspaces |
| Documentación | search_product_docs, get_product_doc |
| Chats | list_chats, get_chat |
| Mensajes y programación | send_template_message, list_scheduled_messages, get_scheduled_message, reschedule_scheduled_message, cancel_scheduled_message |
| Conversaciones | list_conversations, get_conversation, update_conversation |
| Publicaciones y comentarios | list_posts, get_post, list_comment_threads, get_comment_thread, publish_comment, reply_to_comment |
| Clientes | list_clients, get_client, list_client_conversations, create_client, update_client, delete_client, block_client, unblock_client, reset_client_strikes |
| Agentes | list_agents, get_agent, create_agent, update_agent, delete_agent |
| Configuración y conocimiento de agentes | get_agent_prompt, write_agent_prompt, edit_agent_prompt, list_agent_prompt_versions, get_agent_guardrails, update_agent_guardrails, get_agent_assist_rules, update_agent_assist_rules, get_agent_schedule, update_agent_schedule, list_agent_knowledge, create_agent_knowledge_from_url, ingest_agent_knowledge_from_web, delete_agent_knowledge |
| Canales | list_channels, get_channel |
| Uso | get_usage_period, get_usage_summary, get_usage_messages, get_usage_conversations, get_usage_actors |
| Campañas | list_campaigns, get_campaign, create_campaign, update_campaign, delete_campaign, get_campaign_audience, add_campaign_audience, remove_campaign_audience_client, clear_campaign_audience, send_campaign |
| Plantillas | list_templates, get_template |
| Eventos de webhooks | list_webhook_events |
| Campos personalizados | list_custom_fields, create_custom_field, update_custom_field, delete_custom_field |
| Etiquetas | list_tags, create_tag, update_tag, delete_tag |
Se excluyen las API tools personalizadas, administración de otros MCP, ejecución y delegación de agentes, administración de webhooks, moderación, respuestas privadas, actualización/reprocesamiento de conocimiento y búsqueda/exportación de conversaciones. Esas funciones quedan fuera del alcance del plugin aunque estén disponibles en el catálogo completo. Platica no admite operaciones financieras.
Efectos y confirmación
Para la revisión de las plataformas, distingue estos tipos de operación:
| Tipo | Efecto y ejemplos | Autorización del usuario |
|---|---|---|
| Read | Consultas de solo lectura, como list_workspaces, get_client o get_conversation. | Una conexión autorizada y una solicitud admitida del usuario. |
| Write | Cambios en registros del workspace, como create_client o crear una campaña sin enviarla con create_campaign. | Una solicitud explícita del cambio. Crear una campaña no la envía. |
| Sensitive write | Acciones externas o cambios destructivos: send_template_message, send_campaign, publish_comment, reply_to_comment, eliminaciones o cambios en las instrucciones de un agente. | Confirmar los destinatarios/datos/efecto concretos antes de ejecutar. Muse exige aprobación en cada uso de una escritura sensible. |
list_templates y get_template tienen readOnlyHint: false: consultarlas puede refrescar la caché de plantillas de Meta en el servidor de Platica. No crean, editan ni eliminan plantillas en Meta. Los efectos de las demás operaciones se describen en las páginas de recursos y en las definiciones de las herramientas.
La skill del plugin no permite borrados masivos: solo registros identificados individualmente por el usuario. Las herramientas aquí listadas no anulan esa restricción, los permisos del workspace ni los controles de aprobación del cliente. Pedir confirmación no sustituye un permiso que falta.
Catálogo completo por recurso
Estas páginas documentan el catálogo completo. Pueden incluir herramientas no disponibles en /mcp/apps; consulta la selección de plugins más abajo.
| Recurso | Página |
|---|---|
| Workspaces | Workspaces |
| Documentación | Documentación |
| Chat | Chat |
| Mensajes | Mensajes |
| Conversaciones | Conversaciones |
| Publicaciones (comentarios) | Publicaciones |
| 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/apps \
-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. Para descubrir el catálogo completo, usa /mcp en lugar de /mcp/apps.