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:

VerboSignificado
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ónCuándo se usa
readOnlyHint: trueSólo lee datos (list_*, get_*). El cliente puede ejecutarla sin pedir confirmación.
destructiveHint: trueElimina o modifica masivamente (delete_*, clear_campaign_audience).
idempotentHint: trueLlamar varias veces con los mismos argumentos produce el mismo resultado.

Catálogo por recurso

RecursoPágina
MensajesMensajes
ConversacionesConversaciones
ClientesClientes
AgentesAgentes
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 \
  -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.

Anterior Autenticación Siguiente Mensajes