Why static diagrams fail (and hurt your message)
- Complex flows overwhelm readers — cognitive overload kills comprehension.
- Maintaining step-by-step visuals is slow and brittle across versions.
- Docs get ignored: “I just don’t get it” is common feedback for important systems.
Benefits that move the needle
Progressive animation breaks complexity into digestible steps. No more wall-of-arrows.
Direct URLs for images and GIFs — paste into markdown, wikis, or chat. No downloads.
Use the MCP server to ask an LLM to visualize flows. Get a shareable link back.
Loved by writers, engineers, and educators
“Finally, my team actually reads the docs! The animated diagrams cut onboarding time massively.”
“I used to spend hours crafting GIFs. Now it’s one click. My students love the step‑through.”
“Best tool for complex flows. The MCP integration means our agents build diagrams on demand.”
How it works (3 steps)
- Paste Mermaid or describe your flow in plain English.
- Click “Animate” — get a step‑through GIF or interactive view URL.
- Paste the URL in your docs, wiki, or chat. Done.
Features that matter
- Headless rendering — reliable, fast, no browser needed.
- Direct URLs for PNG/GIF: paste in markdown; skip manual copy‑paste.
- Completely stateless, get your diagram back from url
- MCP + LLM: ask in natural language; get diagrams and animations back.
- Exports: GIF, MP4/WebM, SVG, or interactive HTML (GIF/PNG available today).
- API‑first with clear endpoints; integrate into CI/CD or bots.
About the Web App
- Live editor with Mermaid code.
- One-click preview to static image (https://flowgif.com/img/pako:<code>).
- Auto-animate flowcharts into GIFs (https://flowgif.com/gif/pako:<compressed>).
- Encode/Decode helpers for pako strings.
MCP Server Overview
The MCP endpoint is available at https://flowgif.com/mcp-server/mcp
. It exposes tools that agents can call:
mermaid_generator
— generate static or animated diagramsmermaid_from_conversation
— extract flows from transcriptsanimate_mermaid_code
— animate existing Mermaidauto_animate_mermaid_code
— deterministic animation (no LLM)
Quick Start — Agent Integration
from pydantic_ai import Agent
from pydantic_ai.mcp import MCPServerStreamableHTTP
server = MCPServerStreamableHTTP("https://flowgif.com/mcp-server/mcp")
agent = Agent("openai:gpt-4o", toolsets=[server])
async def main():
async with agent:
res = await agent.run("Create an animated signup flow and return a view URL.")
print(res.output)
Open the full documentation on the MCP Docs page.
FAQs
- Do I need to install anything? No — the web app works in your browser; MCP endpoints are ready for agents.
- Can I paste outputs directly in docs? Yes. Use our view URLs for PNG/GIF in markdown or wikis.
- Is data secure? Diagrams are processed server‑side; remove links anytime.
- Don’t know Mermaid? Ask via MCP in plain English; we’ll generate and animate for you.
Ready to make your documentation unforgettable?
Get your first animated diagram in under a minute. No credit card required.