Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 14 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# MapControl <sup>(MC²)</sup>

**Map Control × Model Context Protocol** — a live, shareable web map that AI agents (and humans) drive from code.
**Map Control × Model Context Protocol** — a live, shareable web map that AI agents and humans drive from code or conversation.

[![Discord](https://img.shields.io/badge/Discord-join%20the%20chat-5865F2?logo=discord&logoColor=white)](https://discord.gg/Q4BB4uF68B)
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
Expand All @@ -10,13 +10,21 @@
[![MapLibre](https://img.shields.io/badge/MapLibre-GL-396CB2?logo=maplibre&logoColor=white)](https://maplibre.org/)
[![ESIP](https://img.shields.io/badge/ESIP-Federation-1B6CA8)](https://www.esipfed.org/)

---
![Demo: Flyover to Matterhorn](docs/output2.gif)
---
https://github.com/user-attachments/assets/d0adcfcd-61bb-419c-8b85-3a405d4a5453

Ask your AI assistant to *"draw the burn scar over Los Alamos and fly the camera to it"* — and watch it happen live in a browser tab. MapControl is a headless map server with a real-time MapLibre frontend: create maps, add GeoJSON and GeoTIFF overlays, animate the camera, switch basemaps and themes, take screenshots — over a **Python SDK**, a **REST API**, or the **Model Context Protocol** for Claude, Cline, and any other MCP client.
**MapControl is a controllable map for AI agents.**

Think of it as the Star Trek computer's map console. You say the words; the map moves.
Agents can create maps, add and style geospatial data, move the camera, switch basemaps, render 3D terrain, capture screenshots, and update the map incrementally as they work. Humans open the same map in a browser, watch those changes happen live, interact with the result, and share it with a link.

Control it through:

- **MCP** — give an AI agent direct map tools (Claude, Cline, any MCP client)
- **Python** — drive the map from scripts, notebooks, or generated code
- **REST** — integrate MapControl into any application

All three interfaces operate on the same live map sessions.

Ask an agent: *"Show the burn scar near Los Alamos, switch to satellite imagery, and zoom to it."* — MapControl gives the agent a map it can actually operate, not just coordinates to describe or a static image to return.

## Why MapControl?

Expand Down
Binary file removed docs/output2.gif
Binary file not shown.
Loading