# mapcast

> mapcast is an open-source MCP server for maps and travel. Render animated map videos, globe dives and data maps from a prompt. It runs locally on your machine and is started by your AI client.

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

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add mapcast -- npx -y mapcast
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mapcast": {
      "command": "npx",
      "args": [
        "-y",
        "mapcast"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mapcast": {
      "command": "npx",
      "args": [
        "-y",
        "mapcast"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "mapcast": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mapcast"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mapcast": {
      "command": "npx",
      "args": [
        "-y",
        "mapcast"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mapcast": {
      "command": "npx",
      "args": [
        "-y",
        "mapcast"
      ]
    }
  }
}
```

## Tools

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

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

## 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.
- [Atli](https://ai-powered.com/mcp/atli): Atli is a free MCP server for maps and travel.
- [CAD2GIS](https://ai-powered.com/mcp/cad2gis): CAD2GIS is an open-source MCP server for engineering simulation.
- [Design Feeds](https://ai-powered.com/mcp/design-feeds): Design Feeds is a freemium MCP server for design and media.

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