# Chalkcast

> Chalkcast is an open-source MCP server for education and exams. Author, render and check Manim math animations from natural language with an agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows
- **Repository:** https://github.com/fredmichel/chalkcast
- **MCP Registry name:** io.github.FredMichel/chalkcast
- **Categories:** [education and exams](https://ai-powered.com/categories/education-and-exams), [design and media](https://ai-powered.com/categories/design-and-media)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add chalkcast -- uvx chalkcast
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [next-ai-draw-io](https://ai-powered.com/mcp/next-ai-draw-io-2): next-ai-draw-io is an open-source MCP server for ai models and llm tooling.
- [mcp-for-blender](https://ai-powered.com/mcp/mcp-for-blender): mcp-for-blender is an open-source MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [cursor-talk-to-figma-mcp](https://ai-powered.com/mcp/cursor-talk-to-figma-mcp): cursor-talk-to-figma-mcp is an open-source MCP server for design and media.
- [Design Feeds](https://ai-powered.com/mcp/design-feeds): Design Feeds is a freemium MCP server for design and media.
- [AI Image Editor MCP](https://ai-powered.com/mcp/ai-image-editor-mcp): AI Image Editor MCP is a freemium MCP server for design and media.
- [Muse AI Image MCP](https://ai-powered.com/mcp/muse-ai-image-mcp): Muse AI Image MCP is a paid MCP server for design and media.

---
Source: https://ai-powered.com/mcp/chalkcast
