Model Context Protocol
Mapsi inside your
AI IDE
Connect Claude Code, Cursor, or Windsurf directly to all 18 Mapsi APIs. Your AI generates working geocoding, routing, and map code on the first try — no Googling, no copy-pasting wrong field names.
Claude Code Cursor Windsurf VS Code + Cline Zed
What is MCP? The Model Context Protocol is an open standard that lets your AI coding assistant call external APIs directly. Instead of copy-pasting examples and hoping field names match, your AI geocodes addresses, calculates routes, and checks polygons in real time — while you code.
Setup — 2 minutes
1
Get your API key at mapsi.dev/console/api-keys Free tier: 1,000 calls/day. No credit card required.
2
Add the config to your IDE (pick your IDE below)
3
Restart your IDE — then ask your AI in plain English
~/.claude.json · or .mcp.json in your project root
{
"mcpServers": {
"mapsi": {
"command": "npx",
"args": ["-y", "mapsi-mcp"],
"env": {
"MAPSI_API_KEY": "msk_your_key_here"
}
}
}
}~/.cursor/mcp.json
{
"mcpServers": {
"mapsi": {
"command": "npx",
"args": ["-y", "mapsi-mcp"],
"env": {
"MAPSI_API_KEY": "msk_your_key_here"
}
}
}
}~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mapsi": {
"command": "npx",
"args": ["-y", "mapsi-mcp"],
"env": {
"MAPSI_API_KEY": "msk_your_key_here"
}
}
}
}VS Code → Cline settings → MCP Servers → Add server (paste JSON)
{
"mcpServers": {
"mapsi": {
"command": "npx",
"args": ["-y", "mapsi-mcp"],
"env": {
"MAPSI_API_KEY": "msk_your_key_here"
}
}
}
}Ask your AI things like
Geocode all addresses in my CSV and add lat/lon columns
Build an address autocomplete input for this React form using Mapsi
Draw a 20-minute drive isochrone from our warehouse at this coordinate
Migrate this Google Maps geocoding call to Mapsi — same logic, new endpoints
Add a MapLibre map with Mapsi light tiles and drop markers from this array
Find the 5 nearest hospitals to this coordinate using the Places API
Available tools — 18
| geocode | Convert an address or place name into lat/lon coordinates |
| reverse_geocode | Convert coordinates into a human-readable address |
| autocomplete | Real-time address suggestions as a user types |
| normalize_address | Standardize messy or inconsistently formatted addresses |
| route | Turn-by-turn directions — car, truck, bike, pedestrian |
| isochrone | Reachability polygon — the area reachable within N minutes |
| matrix | Distance and time matrix between multiple origins and destinations |
| map_match | Snap a GPS trace to the road network |
| nearest_road | Find the closest road point to a coordinate |
| places_search | Find POIs, restaurants, and businesses near a location |
| point_in_polygon | Check which country/region/city a coordinate falls within |
| h3_index | Convert a coordinate to an H3 hexagonal grid cell |
| batch_geocode | Geocode thousands of addresses in a single call |
| batch_reverse_geocode | Reverse geocode multiple coordinates at once |
| get_tile_style_url | MapLibre style URL — light, dark, streets, topo, liberty… |
| get_static_map_url | Build a static PNG map URL for any location |
| timezone | Get IANA timezone and UTC offset for any coordinate |
| elevation | Get altitude in metres for any coordinate |