fluyo-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| FLUYO_MCP_LOG | No | 'off' to silence logging completely. | enabled |
| MAX_BODY_BYTES | No | Request body limit. Above: 413. | 1048576 |
| ALLOWED_ORIGINS | No | Comma-separated whitelist of 'Origin'. Replaces the default list, does not extend it. '*' disables the check. | the Claude, ChatGPT and Fluyo ones |
| RATE_LIMIT_PER_MIN | No | Requests per IP per window in /mcp. | 30 |
| RATE_LIMIT_WINDOW_MS | No | Size of the sliding window. | 60000 |
| MAX_TOOL_RESULT_BYTES | No | Tool result limit. Above it is replaced by an error. | 204800 |
| OPENAI_APPS_CHALLENGE | No | Value served by /.well-known/openai-apps-challenge. Without it that route returns 404. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| create_diagramA | Crea un diagrama de arquitectura completo (formato .fluyo.json) a partir de una lista de nodos y aristas. Si un nodo no trae x/y, se posiciona automáticamente en capas de izquierda a derecha según las aristas (auto-layout). El JSON resultante se puede abrir directo en fluyo (botón Abrir) o seguir editando con edit_diagram / exportando con export_diagram. Usa list_icons para ver íconos válidos y list_templates si el patrón ya existe como plantilla. |
| edit_diagramA | Aplica una lista de operaciones (add_node, update_node, remove_node, add_edge, update_edge, remove_edge, set_theme, rename_page, relayout) sobre un documento Fluyo existente (el JSON completo devuelto por create_diagram o cargado desde un .fluyo.json). Las operaciones se aplican en orden; add_node puede definir un 'key' temporal que add_edge referencia en la misma llamada. Para editar nodos/aristas ya existentes en el documento, usa su 'id' numérico (visible en el JSON del documento). |
| export_diagramA | Renderiza una página de un documento Fluyo a SVG estático, con las mismas formas, colores, íconos, rellenos, bordes y tipografías que produce 'Exportar → SVG' dentro de la app. Útil para pegar el diagrama en Notion/Confluence/Markdown o previsualizarlo sin abrir Fluyo. No incluye animación (puntos de flujo ni aparición escalonada), igual que el SVG que exporta la app; para el GIF animado hay que abrir el documento en Fluyo. PNG y GIF no están disponibles aquí: necesitan un renderer de canvas. |
| list_iconsA | Devuelve las claves de ícono válidas para nodos shape='icon', agrupadas (General, GCP, AWS, Azure, Estados, Varios). Son los mismos íconos que ofrece el cajón de la aplicación. |
| list_colorsA | Devuelve los nombres de color semántico aceptados en 'color', 'lineColor' y 'dotColor' (también se acepta cualquier hex #rrggbb). |
| list_animsA | Devuelve las claves válidas para nodos shape='anim'. Son pequeñas animaciones que Fluyo dibuja fotograma a fotograma en el lienzo y en el GIF exportado (un spinner girando, una barra de progreso avanzando, un tick que se traza). En un SVG estático se ve su fotograma de referencia. Sirven para señalar estados —cargando, procesando, error— dentro de un diagrama. |
| list_fontsA | Devuelve las familias tipográficas que ofrece Fluyo, para el campo 'font' de nodos y aristas. El valor que se guarda en el documento es la familia CSS completa, no el nombre corto. Un nodo sin 'font' hereda la tipografía global del documento. |
| list_templatesA | Devuelve los patrones de arquitectura predefinidos disponibles para instanciar con create_from_template. |
| create_from_templateC | Instancia uno de los templates de list_templates como un documento Fluyo completo, con auto-layout aplicado. Se pueden personalizar los labels de los nodos vía 'labelOverrides' (mapa key -> nuevo texto). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 9 tools
The tools are mostly distinct: create/edit/export handle the document lifecycle, list_* tools are metadata queries, and create_from_template is a special creation path. There's slight overlap between create_diagram and create_from_template (both create documents), but their inputs are sufficiently different that confusion is unlikely. Overall clear separation.
The naming follows a mostly consistent verb_noun pattern: create_diagram, edit_diagram, export_diagram, list_icons, list_colors, list_anims, list_fonts, list_templates, create_from_template. The minor inconsistency is 'create_from_template' vs 'create_diagram' — template creation isn't prefixed with 'diagram' — and 'list_anims' uses an abbreviation instead of 'animations'. Otherwise very consistent.
9 tools is well within the ideal 3-15 range. The set breaks into three coherent groups: document creation (create_diagram, create_from_template), document editing (edit_diagram, export_diagram), and metadata lookup (list_icons, list_colors, list_anims, list_fonts, list_templates). Each tool earns its place with no obvious bloat.
The tool surface covers the full document lifecycle: create a diagram from scratch (create_diagram), create from a template (create_from_template), edit it (edit_diagram), and export it (export_diagram). All the lookup needs for valid enum values (icons, colors, anims, fonts, templates) are covered. There's no obvious gap — loading/reading an existing .fluyo.json is handled via edit_diagram which accepts the full JSON document.