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:

VerboSignificado
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ónCuándo se usa
readOnlyHint: trueLee datos sin efectos secundarios. No se deduce solo del nombre list_* o get_*.
destructiveHint: trueElimina o modifica masivamente (delete_*, clear_campaign_audience).
openWorldHint: trueInteractúa con sistemas externos, incluida la lectura de una URL o el envío a un canal.
idempotentHint: trueLlamar varias veces con los mismos argumentos produce el mismo resultado.

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.

RecursoHerramientas 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:

TipoEfecto y ejemplosAutorización del usuario
ReadConsultas de solo lectura, como list_workspaces, get_client o get_conversation.Una conexión autorizada y una solicitud admitida del usuario.
WriteCambios 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 writeAcciones 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.

RecursoPágina
WorkspacesWorkspaces
DocumentaciónDocumentación
ChatChat
MensajesMensajes
ConversacionesConversaciones
Publicaciones (comentarios)Publicaciones
ClientesClientes
AgentesAgentes
HerramientasHerramientas
CanalesCanales
EstadísticasEstadísticas
CampañasCampañas
Plantillas WhatsAppPlantillas
WebhooksWebhooks
Campos personalizadosCampos personalizados
EtiquetasEtiquetas

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.