Skip to content
MCP server

mapcast

Render animated map videos, globe dives and data maps from a prompt

Runs locallyStatus and history
Install
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 mapcast

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

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.

How AIPoweredBot checks servers