{
  "markdown": "# Mographr MCP Server\n\n[![smithery badge](https://smithery.ai/badge/kossik/mographr)](https://smithery.ai/servers/kossik/mographr)\n\nRender real motion-graphics overlays — animated lower thirds, titles, callouts — from an AI assistant, and get back a finished MP4. Free, anonymous, no API key.\n\n```\nEndpoint   https://mcp.mographr.com/mcp\nTransport  Streamable HTTP (stateless, JSON responses)\nAuth       None\nCost       Free — watermarked MP4\n```\n\nFull documentation: **https://www.mographr.com/mcp** · Machine-readable: [`/mcp.md`](https://www.mographr.com/mcp.md)\n\n---\n\n## What this is — and what it isn't\n\nThis is **not** a text-to-video model. It does not invent footage.\n\nIt renders a small catalogue of hand-built motion-graphics templates with *your* text, *your* colour scheme and *your* choice of design, and returns a real MP4 you composite over your own video.\n\nThat distinction is the point. A diffusion model asked for \"a lower third that says Dr. Maya Chen\" produces something that looks like a lower third and spells the name wrong. This renders actual text in an actual font on an actual keyframed animation — legible at 1080p, identical on every run, safe to put in front of a client.\n\n| | Mographr MCP | Text-to-video MCP servers |\n|---|---|---|\n| Output | Designed overlay, exact text | Generated footage, approximate text |\n| Determinism | Same input → same file | Different every run |\n| Typography | Real fonts, real kerning | Hallucinated letterforms |\n| Auth | None | Account + credits |\n| Use | Composite over your footage | Standalone clip |\n\n---\n\n## Install\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http mographr https://mcp.mographr.com/mcp\n```\n\n### Claude Desktop\n\nSettings → Connectors → Add custom connector → `https://mcp.mographr.com/mcp`\n\nOlder builds without that UI, in `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"mographr\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote@latest\", \"https://mcp.mographr.com/mcp\"]\n    }\n  }\n}\n```\n\n### Cursor\n\n`~/.cursor/mcp.json`, or `.cursor/mcp.json` in a project:\n\n```json\n{\n  \"mcpServers\": {\n    \"mographr\": { \"type\": \"http\", \"url\": \"https://mcp.mographr.com/mcp\" }\n  }\n}\n```\n\n### VS Code\n\n`.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"mographr\": { \"type\": \"http\", \"url\": \"https://mcp.mographr.com/mcp\" }\n  }\n}\n```\n\n### Anything else\n\nPlain HTTP POST — no SDK required:\n\n```bash\ncurl -sS https://mcp.mographr.com/mcp \\\n  -H 'Content-Type: application/json' \\\n  -H 'Accept: application/json, text/event-stream' \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}'\n```\n\n> **Gotcha:** the `Accept` header must list **both** `application/json` and `text/event-stream`. The Streamable HTTP transport rejects the request otherwise. This trips up almost every hand-rolled client.\n\n---\n\n## Tools\n\n| Tool | What it does |\n|---|---|\n| `list_motion_tools` | The catalogue. No arguments. Start here. |\n| `get_motion_tool` | One tool's schema: field keys with max lengths and examples, design variants (each with its own canvas — some are vertical 9:16), colour schemes, and a ready-to-copy example call. |\n| `render_motion_tool` | Queues a render, returns a `renderId` immediately. Repeating a call with identical parameters returns the cached result instead of re-rendering. |\n| `get_motion_render` | Poll the `renderId` until `status` is `completed`, then read `downloadUrl`. |\n\n### Worked example\n\n```jsonc\n// 1. what is available\n{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\n \"params\":{\"name\":\"list_motion_tools\",\"arguments\":{}}}\n\n// 2. render one\n{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\n \"params\":{\"name\":\"render_motion_tool\",\"arguments\":{\n   \"slug\":\"lower-thirds\",\n   \"fields\":{\"title\":\"Dr. Maya Chen\",\"subtitle\":\"Marine Biologist\"}}}}\n// → { \"renderId\": \"…\", \"status\": \"queued\", \"etaSeconds\": 68 }\n\n// 3. poll until completed\n{\"jsonrpc\":\"2.0\",\"id\":3,\"method\":\"tools/call\",\n \"params\":{\"name\":\"get_motion_render\",\"arguments\":{\"renderId\":\"…\"}}}\n// → { \"status\": \"completed\", \"downloadUrl\": \"https://…/tool-….mp4\" }\n```\n\nA render takes roughly 30–70 seconds on the CPU lane.\n\n---\n\n## Limits\n\n- About **8 renders per hour per IP**, and at most 6 queued at once across all MCP callers.\n- Hitting a limit is **not** an error response. The tool returns a normal result with `status: \"rate_limited\"`, how many seconds to wait, and a link to the interactive page, which has no limit.\n- Free renders carry a small mographr.com watermark.\n- Image upload (avatars) is only available on the interactive page, not over MCP.\n- Paid exports in the Mographr studio always take priority on the render lane, so free traffic never slows a paying customer down — and never gets starved out either, it just queues.\n\n---\n\n## Notes\n\n- **Stateless.** No sessions, no session-id header, nothing to clean up. Every POST is independent, so a redeploy can never strand your connection. `GET` and `DELETE` on the endpoint return `405` by design. CORS is open.\n- **Legacy host.** The endpoint is also reachable at `https://bff.mographr.com/mcp` — same server, and it will keep working.\n- **REST too.** `GET https://bff.mographr.com/tools` lists the catalogue and `POST /tools/<slug>/render` starts a render. REST additionally supports image upload, which MCP does not.\n\n## Links\n\n- [Documentation](https://www.mographr.com/mcp)\n- [Free tools with an interactive editor](https://www.mographr.com/tools)\n- [Free motion graphics templates](https://www.mographr.com/motion-graphics-templates)\n- [Pricing](https://www.mographr.com/pricing)\n- [Site guide for agents (llms.txt)](https://www.mographr.com/llms.txt)\n\n## Listed on\n\n- [Official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=com.mographr) — `com.mographr/motion-tools`\n- [Smithery](https://smithery.ai/servers/kossik/mographr)\n\n## License\n\nDocumentation in this repository is MIT. The service itself is operated by Mographr under its [Terms of Use](https://www.mographr.com/terms); rendered output is subject to those terms.\n",
  "bytes": 6004,
  "sha": "29fbfee8da401324410f987639fb459e9da2b5ac7ae733a3ab3264f0b6af36d6",
  "repo_slug": "kossik/mographr-mcp-docs",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_mographr_motion_tools_f8d4d17d/readme"
}