Skip to content
MCP server

Chalkcast

Author, render and check Manim math animations from natural language with an agent

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.1.0
Listing updated
today

Similar MCP servers

About Chalkcast

Chalkcast is an open-source MCP server for education and exams. It runs locally on your machine and is started by your AI client.

Where other Manim servers hand an agent one run-this-code tool, Chalkcast adds a verification loop. An agent builds a scene step by step, then inspect_render measures real Manim objects in a second or two without encoding video: bounding boxes, curve and axis ink, drawn-versus-true error for graphs, and a strict LaTeX compile. Problems become obligations that block GIF export until fixed, and fix_scene repairs mechanical ones like moves, rescales and resampling.

Expressions are validated when written against an AST whitelist, so bad colours, ranges or step targets are rejected with a message. Plots are sampled densely and split at jumps and poles. Continuous animation is done by declaring a parameter and tweening it.

It runs locally over stdio, installed from PyPI (Python 3.11 or newer; equations need a LaTeX distribution), with a doctor command to check dependencies. The README labels it alpha and publishes benchmark results on held-out labelled scenes.

Install

Run in a terminal

claude mcp add chalkcast -- uvx chalkcast

Add to claude_desktop_config.json

{
  "mcpServers": {
    "chalkcast": {
      "command": "uvx",
      "args": [
        "chalkcast"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "chalkcast": {
      "command": "uvx",
      "args": [
        "chalkcast"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "chalkcast": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "chalkcast"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "chalkcast": {
      "command": "uvx",
      "args": [
        "chalkcast"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "chalkcast": {
      "command": "uvx",
      "args": [
        "chalkcast"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (21)

Taken from the project documentation; the running server may differ.

open_project
Open a project session.
inspect_project
Inspect the current project.
close_project
Close the session.
add_scene
Add a scene.
add_equation
Add an equation.
add_plot
Add a plot.
add_area
Add an area.
add_riemann
Add a Riemann sum.
add_text
Add text.
add_shape
Add a shape.
add_parameter
Declare an animation parameter.
add_step
Add an animation step.
update_object
Update an object.
remove_object
Remove an object with cascade.
remove_step
Remove a step.
inspect_render
Measure the scene without rendering video.
fix_scene
Auto-repair mechanical problems.
render_scene
Render the scene.
render_frame
Render a single frame.
export_gif
Export a GIF, blocked while error obligations remain.
inspect_environment
Discover the environment setup.

What it does

Verification lanes
Checks framing, collision, legibility, timing, compile, fidelity and range.
Obligations
Detected problems block export until resolved.
Auto-repair
fix_scene fixes mechanical issues and leaves the rest to the agent.
Scene authoring tools
Add text, equations, plots, areas, Riemann sums, shapes, parameters and steps.
Continuous tweens
Animate plots and anchored dots by tweening a parameter.
Doctor command
Checks Manim, LaTeX, dvisvgm, physics.sty and ffmpeg and prints fixes.

Good for

  • Turn a concept like the Fourier series into an animated explainer
  • Produce math visuals for teaching without writing Manim by hand
  • Let an agent iterate on an animation until its checks pass
  • Export a verified GIF to share

Pricing

Open source

Chalkcast FAQ

What do I need installed?

Python 3.11 or newer; the render extra brings Manim and ffmpeg, and equations need LaTeX.

How is it installed?

With uvx or pip, then added to Claude Code with claude mcp add.

Is it production-ready?

The README labels it alpha.

When does GIF export get blocked?

While error obligations remain or if the render predates the latest edit.

Is Chalkcast free?

Yes. Chalkcast is open source, so you can use and self-host it for free.

How do I add Chalkcast to Claude Code?

Run this command in your terminal: claude mcp add chalkcast -- uvx chalkcast

What are the best alternatives to Chalkcast?

The closest alternatives to Chalkcast are HyperFrames by HeyGen, next-ai-draw-io, mcp-for-blender, ffmpeg-skill and cursor-talk-to-figma-mcp.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers