snapmcp

Overview Schema Source Related Servers Discussions Admin

capture_sequence

Capture each step of a process as individual images and optional GIF. Supports terminal, code, files, browser, markdown, HTML, and diff captures for CI/CD pipelines, deployments, and tutorials.

Instructions

Capture each step of a process as individual image files + optional compiled GIF. Each step has full type-specific parameters plus stepNumber and label for documentation. Use for CI/CD pipeline visualization, deployment steps, tutorial sequences. Maximum 60 steps.

Input Schema

TableJSON Schema

Name	Required	Description
`loop`	No	Whether the GIF loops infinitely
`steps`	Yes	Array of steps to capture. Each step specifies its capture type, type-specific parameters, plus optional stepNumber and label.
`output`	No	Output directory (default: SNAPMCP_DIR). Steps saved as individual files, GIF as sequence-<timestamp>.gif
`compileGif`	No	Compile frames into an animated GIF (requires at least 2 steps)
`frameDelay`	No	Frame delay in milliseconds for GIF (10-5000). Default 800ms.

Schema Changelog

Changes observed during successful MCP inspections.

Changed9 schema fields changedv2.3.4Sep 18, 2026

changedInput schema / properties / compileGif / description

Previous value: -"Compile frames into an animated GIF"New value: +"Compile frames into an animated GIF (requires at least 2 steps)"

changedInput schema / properties / frameDelay / description

Previous value: -"Frame delay in ms"New value: +"Frame delay in milliseconds for GIF (10-5000). Default 800ms."

changedInput schema / properties / loop / description

Previous value: -"Whether the GIF loops"New value: +"Whether the GIF loops infinitely"

changedInput schema / properties / output / description

Previous value: -"Output directory (default: SNAPMCP_DIR)"New value: +"Output directory (default: SNAPMCP_DIR). Steps saved as individual files, GIF as sequence-<timestamp>.gif"

addedInput schema / properties / steps / description

Added value: +"Array of steps to capture. Each step specifies its capture type, type-specific parameters, plus optional stepNumber and label."

addedInput schema / properties / steps / items / oneOf

Added value: +[
+  {
+    "properties": {
+      "label": {
+        "description": "Optional label for this step",
+        "maxLength": 100,
+        "type": "string"
+      },
+      "lines": {
+        "description": "Lines to render. Prefix with '$ ' for prompts.",
+        "items": {
+          "type": "string"
+        },
+        "maxItems": 1000,
+        "minItems": 1,
+        "type": "array"
+      },
+      "stepNumber": {
+        "description": "Step number label (auto-assigned if omitted)",
+        "maximum": 9007199254740991,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "title": {
+        "description": "Window title (default: 'step')",
+        "maxLength": 100,
+        "type": "string"
+      },
+      "type": {
+        "const": "terminal",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "lines"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "code": {
+        "description": "Source code to render",
+        "maxLength": 200000,
+        "minLength": 1,
+        "type": "string"
+      },
+      "endLine": {
+        "description": "Last line number (1-indexed, inclusive)",
+        "maximum": 9007199254740991,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "label": {
+        "description": "Optional label for this step",
+        "maxLength": 100,
+        "type": "string"
+      },
+      "language": {
+        "default": "text",
+        "description": "Programming language (typescript, python, rust, go, etc.)",
+        "type": "string"
+      },
+      "startLine": {
+        "description": "First line number (1-indexed)",
+        "maximum": 9007199254740991,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "stepNumber": {
+        "description": "Step number label (auto-assigned if omitted)",
+        "maximum": 9007199254740991,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "title": {
+        "description": "Window title (default: 'step')",
+        "maxLength": 100,
+        "type": "string"
+      },
+      "type": {
+        "const": "code",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "code"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "endLine": {
+        "description": "Last line number (1-indexed, inclusive)",
+        "maximum": 9007199254740991,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "filePath": {
+        "description": "Absolute path to file (must be in SNAPMCP_ALLOWED_PATHS)",
+        "minLength": 1,
+        "type": "string"
+      },
+      "label": {
+        "description": "Optional label for this step",
+        "maxLength": 100,
+        "type": "string"
+      },
+      "startLine": {
+        "description": "First line number (1-indexed)",
+        "maximum": 9007199254740991,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "stepNumber": {
+        "description": "Step number label (auto-assigned if omitted)",
+        "maximum": 9007199254740991,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "type": {
+        "const": "file",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "filePath"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "fullPage": {
+        "default": false,
+        "description": "Capture full scrollable page",
+        "type": "boolean"
+      },
+      "height": {
+        "default": 800,
+        "description": "Viewport height (px)",
+        "maximum": 4096,
+        "minimum": 240,
+        "type": "integer"
+      },
+      "label": {
+        "description": "Optional label for this step",
+        "maxLength": 100,
+        "type": "string"
+      },
+      "stepNumber": {
+        "description": "Step number label (auto-assigned if omitted)",
+        "maximum": 9007199254740991,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "type": {
+        "const": "browser",
+        "type": "string"
+      },
+      "url": {
+        "description": "URL to capture (http/https, SSRF protected)",
+        "format": "uri",
+        "type": "string"
+      },
+      "width": {
+        "default": 1280,
+        "description": "Viewport width (px)",
+        "maximum": 3840,
+        "minimum": 320,
+        "type": "integer"
+      }
+    },
+    "required": [
+      "type",
+      "url"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "label": {
+        "description": "Optional label for this step",
+        "maxLength": 100,
+        "type": "string"
+      },
+      "markdown": {
+        "description": "Markdown content (GFM supported)",
+        "maxLength": 200000,
+        "minLength": 1,
+        "type": "string"
+      },
+      "stepNumber": {
+        "description": "Step number label (auto-assigned if omitted)",
+        "maximum": 9007199254740991,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "title": {
+        "description": "Document title (default: 'step')",
+        "maxLength": 100,
+        "type": "string"
+      },
+      "type": {
+        "const": "markdown",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "markdown"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "html": {
+        "description": "HTML content (external resources blocked)",
+        "maxLength": 200000,
+        "minLength": 1,
+        "type": "string"
+      },
+      "label": {
+        "description": "Optional label for this step",
+        "maxLength": 100,
+        "type": "string"
+      },
+      "stepNumber": {
+        "description": "Step number label (auto-assigned if omitted)",
+        "maximum": 9007199254740991,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "title": {
+        "description": "Description for logging (default: 'step')",
+        "maxLength": 100,
+        "type": "string"
+      },
+      "type": {
+        "const": "html",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "html"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "diff": {
+        "description": "Unified diff content (git diff format)",
+        "maxLength": 500000,
+        "minLength": 1,
+        "type": "string"
+      },
+      "label": {
+        "description": "Optional label for this step",
+        "maxLength": 100,
+        "type": "string"
+      },
+      "stepNumber": {
+        "description": "Step number label (auto-assigned if omitted)",
+        "maximum": 9007199254740991,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "type": {
+        "const": "diff",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "diff"
+    ],
+    "type": "object"
+  }
+]

removedInput schema / properties / steps / items / properties

Removed value: -{
-  "label": {
-    "description": "Label for this step",
-    "type": "string"
-  },
-  "params": {
-    "additionalProperties": {},
-    "description": "Parameters for the capture type",
-    "propertyNames": {
-      "type": "string"
-    },
-    "type": "object"
-  },
-  "stepNumber": {
-    "description": "Step number label",
-    "maximum": 9007199254740991,
-    "minimum": 1,
-    "type": "integer"
-  },
-  "type": {
-    "enum": [
-      "terminal",
-      "code",
-      "file",
-      "browser",
-      "markdown",
-      "diff",
-      "html"
-    ],
-    "type": "string"
-  }
-}

removedInput schema / properties / steps / items / required
```
Removed value: -[
-  "type",
-  "params"
-]
```
removedInput schema / properties / steps / items / type
```
Removed value: -"object"
```

First observedv2.3.2Sep 18, 2026

TDQS

A4/5.0

Behavior3/5

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

With no annotations, the description carries the full burden. It discloses the 60-step limit and optional GIF generation, adding useful behavioral context. However, it does not mention file system effects, output directory behavior, overwriting, or execution time, which are important for a multi-file creation tool.

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?

Two sentences, front-loaded with the core purpose, then use cases, then the key 60-step constraint. Every sentence earns its place; no waste.

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?

The description gives the essentials for a complex tool with many nested parameters Gang, but does not enumerate supported step types (terminal, code, file, etc.) nor mention output directory defaults. Given the extremely rich schema, this is a minor gap; the agent can rely on schema details.

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

Parameters3/5

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

Schema coverage is 100% with detailed descriptions for all top-level parameters and each nested step object. The description only generically references 'type-specific parameters' without adding semantics beyond the schema; the baseline 3 applies because the schema carries the load.

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

Purpose5/5

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

Description clearly states a specific verb ('Capture'), resource ('each step of a process as individual image files + optional compiled GIF'), and scope ('sequence'). The mention of stepNumber/label and 'Maximum 60 steps' distinguishes it from the single-step sibling capture tools.

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

Usage Guidelines4/5

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

The description provides explicit use cases ('CI/CD pipeline visualization, deployment steps, tutorial sequences'), which makes the intended context clear. It does not explicitly name alternative single-step tools or say when not to use this tool, but that is implied by the contrast with sibling names.

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

Deploy Server

capture_sequence

Instructions

Input Schema

Schema Changelog

TDQS

Other Tools