mapcast
Render animated map videos, globe dives and data maps from a prompt
- Pricing
- Open source
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 0.1.1
- Listing updated
- today
Similar MCP servers
About mapcast
mapcast is an open-source MCP server for maps and travel. It runs locally on your machine and is started by your AI client.
mapcast turns a short JSON scene into a finished map clip, and the MCP server lets an assistant write that scene for you. Ask for a YouTube Short that spins the globe and lands on Brazil with its flag, an old parchment map of Turkey with Istanbul marked, or countries coloured by an unemployment figure, and the agent builds the scene and renders it locally.
Two tools run over stdio: render_map saves the video or image and returns a preview of the final frame so the agent can check its work, and preview_map renders one frame to test a scene first. The scene format covers highlight styles (tint, spotlight, outline, flag overlay), satellite or parchment basemaps, camera moves including a 3D globe dive and country-to-country flights, 4,500 states and provinces, and data colouring with a legend. Output goes to MP4, GIF, PNG or JPG in four aspect ratios.
First use downloads Chromium and map data, and video needs ffmpeg installed. A 5 second 1080p clip takes about 15 seconds on a laptop, per the README. It is MIT licensed, and satellite imagery needs a credit line that mapcast prints after each render.
Install
Run in a terminal
claude mcp add mapcast -- npx -y mapcastAdd to claude_desktop_config.json
{
"mcpServers": {
"mapcast": {
"command": "npx",
"args": [
"-y",
"mapcast"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mapcast": {
"command": "npx",
"args": [
"-y",
"mapcast"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mapcast": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mapcast"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mapcast": {
"command": "npx",
"args": [
"-y",
"mapcast"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mapcast": {
"command": "npx",
"args": [
"-y",
"mapcast"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- render_map
- Render the scene to video or image and return a preview of the final frame.
- preview_map
- Render one frame to check a scene before a full render.
What it does
- Highlight styles
- Tint, spotlight, outline or flag overlay for countries, states and provinces.
- Camera moves
- Push-in, zoom-in, 3D globe dive and fly between countries.
- Data maps
- Colour countries by a number with a legend and labels.
- Basemaps
- NASA Blue Marble, Sentinel-2 satellite imagery or an old parchment map.
- Preview before render
- preview_map renders a single frame to check a scene.
Good for
- Make a short explainer clip highlighting a country with its flag
- Create a vertical map video for social media
- Colour a map by GDP or unemployment figures
- Produce a documentary-style fly-through between countries
Pricing
Open source
Free, MIT licensed
mapcast FAQ
What do I need installed?
Node via npx, ffmpeg for video, and a one-time download of Chromium and map data.
What formats can it output?
MP4, GIF, PNG and JPG in 16:9, 9:16, 1:1 or 4:5.
How are disputed borders handled?
Drawn the way the highlighted country officially draws them, or neutral on request.
What licence is it under?
MIT; map data and imagery licences are in the repo's NOTICE file.
Is mapcast free?
Yes. mapcast is open source, so you can use and self-host it for free.
How do I add mapcast to Claude Code?
Run this command in your terminal: claude mcp add mapcast -- npx -y mapcast
What are the best alternatives to mapcast?
The closest alternatives to mapcast 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.



