# mapcast MCP server

> Generates animated map videos and data visualizations from text prompts or JSON descriptions for use in explainers and documentaries.

- Repository: https://github.com/21prnv/mapcast
- Page: https://hostedmcp.org/servers/21prnv/mapcast
- Transport: stdio
- Stars: 6
- License: MIT
- Latest version: 0.1.1

## Install

### Claude Code

```sh
claude mcp add mapcast -- npx -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"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"mapcast","type":"stdio","command":"npx","args":["-y","mapcast"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

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

### Codex

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

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.mapcast]
command = "npx"
args = ["-y", "mapcast"]
```

### Gemini CLI

```sh
gemini mcp add -s user mapcast npx -- -y mapcast
```

### Gemini settings.json (`~/.gemini/settings.json`)

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

## FAQ

### How can I use mapcast with an AI agent?

You can add it to MCP clients like Claude Desktop, Cursor, or Windsurf by adding the server to your MCP configuration.

### What kind of map styles are available?

Available styles include color tints, spotlights that grey out the rest of the world, outlines, and overlaying a country's flag onto its land.

### Can I create data-driven maps?

Yes, you can color countries by numerical values using various color schemes and include a legend with titles and units.

### What file formats does it support?

The tool supports rendering videos and images in MP4, GIF, PNG, and JPG formats.