Las 117 tools del MCP de CognitionDesk, por área: qué puede hacer tu agente con tu cuenta

Conectaste el MCP de CognitionDesk a tu agente. ¿Y ahora qué le podés pedir?

claude mcp add cognitiondesk -e COGNITIONDESK_API_KEY=tu_key -- npx -y @cognitiondesk/mcp

Actualización (5 de octubre): ya salió @cognitiondesk/mcp 0.10.0, con 122 tools. Las cinco nuevas son de YouTube y redes: list_social_connections y list_youtube_videos consultan; connect_youtube_channel, upload_youtube_video y update_youtube_video escriben. Ninguna borra, así que las diez destructivas de abajo siguen siendo las mismas. El resto de esta guía describe la 0.9.0.

La 0.9.0 registra 117 tools, 8 guías y 5 playbooks. Corre con tu API key, así que tu agente puede hacer exactamente lo que esa key puede hacer: ni más ni menos.

La primera llamada conviene que sea get_connection_status. Te dice a qué cuenta apunta la key (enmascarada), qué plan tiene y qué asistentes puede manejar. Casi todo "no anda nada" es una key que falta o que se revocó, y esta tool lo dice de entrada.

Las 117, por área

Cuatro áreas suman 46 de las 117: conocimiento (13), asistentes (12), skills (12) y audiencia (9).

• Asistentes (12). Crear, editar, probar y publicar. try_assistant le habla al asistente y te devuelve lo que contesta de verdad. publish_assistant congela el borrador como una versión y apunta el bot en vivo a esa versión; rollback_assistant vuelve a una anterior sin tocar el borrador.
• Conocimiento (13). Lo que el asistente sabe para contestar: texto, URLs, documentos, imágenes y repos de GitHub. estimate_knowledge_ingest te da el precio de una ingesta antes de hacerla. search_knowledge busca lo mismo que va a encontrar el asistente.
• Skills (12) y custom tools (5). Un comportamiento reutilizable va en una skill; una acción contra un sistema externo, en una custom tool. resolve_skills traduce una lista de skills a las tools concretas que agregan y al texto que suman al prompt.
• Audiencia y derivación (9). A quién reconoce el asistente, por qué canales, y a qué persona del equipo le pasa la conversación cuando la suelta. get_identity_audit muestra quién probó ser quien dice, quién lo intentó y falló, y cuándo.
• Workflows (9), tareas programadas (7) y squads (5). Grafos de LangGraph con borrador y versiones, tareas que corren solas con su historial de corridas, y equipos de asistentes armados desde un objetivo de una línea.
• Canales y widget (6). create_web_widget le da al asistente un chat para embeber; update_web_widget edita su allowedDomains, la lista que decide si el chat contesta en tu sitio.
• El resto: agenda (4), inventario (7), tareas (7), memoria y archivos (3), campañas de email (2), imágenes (1), cobros (1), uso y planes (4), API keys (6) y conexión (4). Esta última incluye use_account, que cambia de cuenta cuando un mismo server maneja varias.

Cuáles leen y cuáles borran

53 de las 117 son de solo lectura. Listan, buscan y miden: las podés dejar libres en tu cliente.

10 son destructivas, y ninguna se esconde detrás de un nombre amable:

delete_assistant, delete_assistant_contact, delete_assistant_person, delete_handoff_contact, delete_knowledge_entry, delete_skill, delete_custom_tool, delete_task, delete_api_key y revoke_api_key.

Cada tool viaja con esas dos marcas (readOnlyHint y destructiveHint en el protocolo), así que un cliente MCP puede pedirte confirmación sólo para esas diez y dejar pasar el resto. Las otras 54 escriben: crean, editan, publican. Muchas trabajan sobre un borrador que no llega al bot en vivo hasta que lo publicás.

La tabla no la escribe nadie

La referencia completa está en docs.cognitiondesk.com/docs/mcp, y no la mantiene una persona.

Antes la tabla del README se escribía a mano y listaba unas 90 tools cuando el server ya registraba 117. Ahora un script construye el server, lo conecta a un cliente MCP en memoria, sin red y sin API key, y lista lo que el server expone de verdad. El área de cada tool sale del comentario que la precede en el código. La página de la doc lee ese JSON.

Y hay un chequeo: si alguien agrega una tool al server y no regenera la doc, npm run tools:al-dia sale con 1 y nombra la diferencia. La doc no puede quedar atrás del código sin que algo se ponga en rojo.

Para arrancar

1. Instalalo con el comando de arriba y llamá a get_connection_status.
2. Pedile a tu agente list_scopes antes de adivinar un permiso: devuelve los tres catálogos de permisos de la plataforma en una sola llamada.
3. Abrí la tabla completa en docs.cognitiondesk.com/docs/mcp, con la descripción de cada tool tal como la lee tu agente.

Si te falta una tool para lo que querés hacer, escribinos por el chat de esta página.