GuiaFlow

Adicionar passo

add_step

Adiciona um passo ao tour: a captura (image), o destaque (highlight) no elemento a clicar e o ponto do clique (click), em frações 0..1 da imagem, mais título e texto do balão. Para um passo com vídeo, envie video com o link do YouTube ou do Vimeo (a capa vira a imagem; image é opcional). Responde com avisos quando ajusta algo (ex.: clique movido para dentro do destaque).

Input Schema

Name	Required	Description
`alt`	No	Texto alternativo da captura para leitor de tela (WCAG 1.1.1). Vazio: o player usa título + texto do balão.
`text`	No	Texto do balão (curto, 1–2 frases; no slide, o corpo do cartão). Aceita formatação leve: negrito, itálico, ++sublinhado++ e linhas começando com "- " (lista de 1 nível); nada de HTML nem links. Um "*" solto fica literal.
`type`	No	screen = captura com destaque (padrão); slide = cartão de texto sem imagem.
`click`	No	Ponto do clique em fração da imagem (0..1). Fica sempre dentro do destaque (é ajustado se cair fora). Só com click (sem highlight) o destaque vira 14%×8% em volta.
`image`	No	A captura de tela: exatamente um de mediaId (de upload_media), url (https pública) ou base64 (PNG/JPEG/WebP/GIF, até 15 MB). Prefira upload_media + mediaId para arquivos locais.
`label`	No	Nome do passo na lista do editor (padrão: o título).
`scene`	No	Cena (agrupa passos no editor).
`title`	No	Título do balão.
`video`	No	Link de um vídeo do YouTube ou do Vimeo (watch, youtu.be, shorts, embed, vimeo.com/ID, player.vimeo.com). Só o link fica no tour: nada é enviado. Sem image, a capa do vídeo é baixada e vira a imagem do passo (com image, ela é a capa). O passo ocupa a tela toda (highlight e click são ignorados) e o player só carrega o YouTube/Vimeo quando o visitante clica no play. null tira o vídeo.
`tourId`	Yes	id do tour (de create_tour ou list_tours).
`position`	No	Índice onde inserir/mover (0 = primeiro). Padrão: no fim.
`highlight`	No	Retângulo do destaque em fração da imagem (0..1): x,y = canto superior esquerdo; width,height = tamanho. Ex.: botão em (0.62, 0.08) com 0.12×0.05.
`popoverSide`	No	Lado do balão em relação ao destaque.
`popoverAlign`	No
`altDecorative`	No	true = captura decorativa (alt vazio). Use só quando a imagem não traz informação.
`simulateClick`	No	Mostra a animação de clique no player (padrão true).
`narrationScript`	No	Roteiro da narração/legenda deste passo (opcional).

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 30, 2026

changedInput schema / properties / text / description

Previous value: -"Texto do balão (curto, 1–2 frases)."New value: +"Texto do balão (curto, 1–2 frases; no slide, o corpo do cartão). Aceita formatação leve: **negrito**, *itálico*, ++sublinhado++ e linhas começando com \"- \" (lista de 1 nível); nada de HTML nem links. Um \"*\" solto fica literal."

Changed1 schema field changedOct 30, 2026

addedInput schema / properties / video

Added value: +{
+  "description": "Link de um vídeo do YouTube ou do Vimeo (watch, youtu.be, shorts, embed, vimeo.com/ID, player.vimeo.com). Só o link fica no tour: nada é enviado. Sem image, a capa do vídeo é baixada e vira a imagem do passo (com image, ela é a capa). O passo ocupa a tela toda (highlight e click são ignorados) e o player só carrega o YouTube/Vimeo quando o visitante clica no play. null tira o vídeo.",
+  "maxLength": 500,
+  "type": [
+    "string",
+    "null"
+  ]
+}

Changed2 schema fields changedOct 12, 2026

addedInput schema / properties / alt

Added value: +{
+  "description": "Texto alternativo da captura para leitor de tela (WCAG 1.1.1). Vazio: o player usa título + texto do balão.",
+  "maxLength": 300,
+  "type": "string"
+}

addedInput schema / properties / altDecorative

Added value: +{
+  "description": "true = captura decorativa (alt vazio). Use só quando a imagem não traz informação.",
+  "type": "boolean"
+}

First observedOct 12, 2026

TDQS

A3.9/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Adds real behavior beyond the annotations: it responds with warnings when it adjusts input (e.g., the click point is moved inside the highlight), only the video link is stored (nothing is uploaded), and the YouTube/Vimeo player loads only on play. Annotations already declare non-read-only, non-destructive, non-idempotent, so the bar is lower, but the description pays it with concrete side-effect disclosure.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three front-loaded sentences: the core definition first, the video variant second, the warning behavior third. Dense but every clause (fractions, optional image, adjustment warnings) carries information the agent needs.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 17-parameter write tool with no output schema, it covers the primary paths (image step, video step, adjustments) and the warning response. It does not say what is returned (e.g., the new step's id) and only lightly touches ordering/scene behavior, which the schema handles.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 94%, so the baseline is 3; the description still adds meaning by framing image/highlight/click as fractions 0..1 of the image and by clarifying that with a video the cover becomes the image and image is optional. It does not restate the remaining 14 parameters, which the schema already documents.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb+resource ('Adiciona um passo ao tour') and enumerates the constituent parts of a step (captura, destaque, ponto do clique, título/texto), so the agent knows exactly what is being created. It does not explicitly differentiate from update_step or delete_step, so sibling routing is left to inference.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives conditional guidance for one variant – use video for a video step (image becomes optional) – and implies screen vs slide behavior. It never says when to use this instead of update_step or reorder_steps, nor any precondition such as the tour having to exist or being unpublished.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All GuiaFlow tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?