woku_guide, que entrega el método de woku y playbooks (de una intención a la secuencia de herramientas), y a design_voc_program, que propone un programa de escucha para tu viaje de cliente.
Herramientas por familia
El servidor organiza sus herramientas por familia. La lista viva de la conexión (tools/list) indica cuáles están disponibles:
Con esto, un agente puede diseñar un programa de escucha, resumir las reseñas de la última semana, comparar el NPS entre sucursales, aprobar un plan de acción o crear un tracker, todo desde la conversación.
Crear un Woku o viaje con media
upload_woku_media importa una imagen o video MP4 desde una URL HTTPS pública y devuelve el fileId de woku. También acepta un archivo autorizado por ChatGPT mediante su parámetro file, cuando esa capacidad está disponible en la conexión. create_woku puede usar ese fileId o importar la media en la misma llamada. Para un momento Woku de un viaje, usa set_journey_moment_media con el fileId; el viaje crea su propia herramienta al evaluar ese momento.
Si el archivo está en el computador donde corre Codex o Claude Code, su terminal puede subirlo por multipart sin poner los bytes en la conversación:
fileId, filename y type. La clave de empresa debe venir de una variable de entorno o gestor de secretos del usuario, nunca del texto del prompt. Las imágenes se convierten a WebP con un máximo de 10 MB de entrada; el video debe ser MP4 y no superar 25 MB. Se verifica el formato real, no solo el nombre o Content-Type.
Un MCP remoto no puede leer ./foto-del-producto.jpg en el computador del usuario. ChatGPT puede pasar un archivo autorizado a una herramienta que declara un parámetro de archivo, según su documentación de plugins. Claude web conecta el MCP remoto desde la nube de Anthropic y no documenta ese mismo pase automático de adjuntos; en esa superficie usa una URL HTTPS accesible para woku. Claude: conectores remotos.
Para crear un viaje sin armar a mano su definición, llama a woku_guide con topic=customer_journeys. propose_journey interpreta tres textos libres: experiencia, momentos ordenados y objetivos. Con aprobación, create_journey_from_brief guarda la propuesta apagada. Después sube las imágenes necesarias, conecta los webhooks de cada momento, revisa los destinatarios y activa el viaje con update_journey. Ninguna de estas herramientas de creación envía evaluaciones por sí sola.
Para conservar una propuesta revisada, pasa el draft que devuelve propose_journey como proposal a create_journey_from_brief, junto con las respuestas originales y confirm: true. Así se guarda sin otra llamada al modelo. Si omites proposal, genera una propuesta nueva. toolSpec.descriptionEn conserva el nombre en inglés del woku; los campos no admitidos en los momentos dan error en vez de descartarse silenciosamente.
Toolsets
El catálogo es amplio, así que una conexión puede acotarlo. Agregando?toolsets=nps,clients (separados por coma) a la URL del endpoint MCP se exponen solo esas familias; sin el parámetro, o con ?toolsets=all, se expone todo. Las familias guide, company y search están siempre disponibles.
Búsqueda universal
Las herramientassearch y fetch siguen el contrato de investigación profunda de ChatGPT: search busca en todos los datos de la empresa y fetch trae el detalle de un resultado.
Lectura y escritura
Las conexiones manejan dos permisos:mcp:read para consultar datos y mcp:write para las herramientas que crean, editan o borran. Las herramientas de lectura funcionan solo con mcp:read; las de escritura requieren además mcp:write, y las destructivas (por ejemplo delete_woku) o de envío (por ejemplo send_nps_invitations) exigen también confirm: true en la llamada, para que nada se borre ni se envíe sin una confirmación explícita.
Si la conexión no tiene el permiso mcp:write, las herramientas de escritura responden con un error que lo indica y el resto sigue funcionando con normalidad.
La lista de herramientas que anuncia el servidor en una conexión viva (tools/list) es siempre la respuesta autoritativa sobre lo que está disponible.
Contenido de webhook por momento
create_journey, update_journey y la proposal aprobada admiten la configuración completa del momento. El origen del contenido (webhook.contentMode) es independiente del disparador. Para contenido dinámico usa webhook.schema con raíz objeto y toolScope: "per_enrollment".
webhook.payload.clientFields mapea datos adicionales del cliente mediante {key, path}. En webhook.content, description, descriptionEn, las variables localizadas subject y audience, y las claves y nombres de carpetas aceptan {mode: "literal" | "javascript", value}. JavaScript recibe payload y devuelve un string; no admite imports, red ni archivos. Woku puede leer su imagen desde imageUrlPath y sus trackers desde una lista de {name, path}. Un padre requiere una carpeta hija; los nombres omitidos usan su clave y deben respetar los límites de nombres de carpeta.
MCP conserva cadence para los envíos y ventanas; HTTP usa sequence. Al reemplazar momentos, envía la lista completa. preview_journey_moment usa el momento guardado, sin verificar firmas ni enviar. Las lecturas no devuelven secretos; configúralos por momento con las herramientas de credenciales. Los campos desconocidos y los secretos dentro de la definición producen error.