mapcast — Claude Code MCP server: maps and setup
The mapcast MCP server for Claude Code creates animated map videos and still images from a scene request. An agent can use it to highlight places, animate a route or colour countries by data.
MIT ★ 9 updated 2026-11-02
claude mcp add mapcast -- npx -y mapcastWhat mapcast does
mapcast turns a scene description into a map image or animation. An agent can call preview_map to inspect a single frame, or render_map to save a video or image and receive a preview of its last frame.
Scenes can show countries or regions on satellite imagery or a parchment-style map, with labels, flags, data-based colours and camera movement. Video rendering requires ffmpeg. On its first run, mapcast downloads Chromium and map data, then caches them. Start the server with claude mcp add mapcast -- npx -y mapcast.
What it helps with
- create an animated zoom to a chosen country
- highlight regions and place labels on a map
- colour countries by values and show a legend
- animate a camera journey between countries
Example prompts for the agent
- Make a globe animation that zooms into Brazil and displays its flag.
- Create an old-style map of Turkey that zooms toward Istanbul.
- Colour countries by unemployment figures and add a legend.
How to install mapcast
Platform CLI
claude mcp add mapcast -- npx -y mapcastPlatform CLI
codex mcp add mapcast -- npx -y mapcastConfig file
{
"mcpServers": {
"mapcast": {
"command": "npx",
"args": [
"-y",
"mapcast"
]
}
}
}Config file
{
"servers": {
"mapcast": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mapcast"
]
}
}
}Platform CLI
gemini mcp add mapcast npx -y mapcastStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mapcast
How do I install mapcast in Claude Code?
Run claude mcp add mapcast -- npx -y mapcast. Video rendering also requires ffmpeg.
What does mapcast do?
It creates still maps and animated videos from scene descriptions. Its MCP tools let an agent preview a frame or save the rendered result.
What does mapcast need to run?
Video rendering needs ffmpeg. On the first run, mapcast downloads Chromium and map data.