Skip to main content
Glama
algolayertechnologies

mapsi-mcp

by algolayertechnologies
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Remote

mapsi-mcp

MCP server for Mapsi — 18 geospatial tools for AI coding assistants. Connect Claude Code, Cursor, Windsurf, or any MCP-compatible IDE directly to Mapsi APIs.

OpenStreetMap-based · Self-hosted infrastructure · No Google Maps vendor lock-in

Quick Start

1. Get your API key at mapsi.dev/console/api-keys (free tier: 1,000 calls/day, no credit card)

2. Add the config to your IDE:

Claude Code / Claude Desktop

Add to ~/.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

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "mapsi": {
      "command": "npx",
      "args": ["-y", "mapsi-mcp"],
      "env": { "MAPSI_API_KEY": "msk_your_key_here" }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json — same JSON format as Cursor above.

VS Code + Cline

Open Cline settings → MCP Servers → Add server → paste:

{
  "mapsi": {
    "command": "npx",
    "args": ["-y", "mapsi-mcp"],
    "env": { "MAPSI_API_KEY": "msk_your_key_here" }
  }
}

Zed

Add to your Zed settings under "context_servers":

{
  "mapsi-mcp": {
    "command": { "path": "npx", "args": ["-y", "mapsi-mcp"] },
    "env": { "MAPSI_API_KEY": "msk_your_key_here" }
  }
}

3. Restart your IDE — then ask your AI in plain English.

Related MCP server: Mapbox MCP Server

What You Can Ask Your AI

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
Find the 5 nearest hospitals to this coordinate
Migrate this Google Maps geocoding call to Mapsi
Add a MapLibre map with Mapsi light tiles and drop markers from this array
Calculate a distance matrix between 10 warehouses and 50 delivery stops
Snap this GPS trace to the road network and calculate total distance

Available Tools (18)

Geocoding

Tool

Description

geocode

Address or place name → lat/lon. Returns confidence score (0–1); treat scores below 0.6 as ambiguous.

reverse_geocode

lat/lon → formatted address, street, city, postcode, country.

autocomplete

Real-time address suggestions as user types (min 2 chars). For UI input fields.

normalize_address

Standardize messy/inconsistent addresses. Returns structured fields + coordinates.

timezone

IANA timezone name + UTC offset + DST status for any coordinate.

elevation

Altitude in metres for any coordinate (~30m resolution globally).

Routing

Tool

Description

route

Turn-by-turn directions. Modes: auto, truck, bicycle, pedestrian, motor_scooter.

isochrone

Reachability polygon within N minutes or N metres. Returns GeoJSON for MapLibre/Leaflet.

matrix

Travel time + distance matrix for up to 50×50 origin-destination pairs in one call.

map_match

Snap a GPS trace to the road network. Coordinates are [lon, lat] order (GeoJSON).

nearest_road

Find nearest routable road point. Call this if route returns "no route found".

Places

Tool

Description

places_search

Find nearby POIs by category (restaurant, hospital, pharmacy, ATM…). Returns name, coords, categories.

Spatial

Tool

Description

point_in_polygon

Admin hierarchy for a coordinate: country, region, city, neighbourhood.

h3_index

Convert coordinate to H3 hexagonal grid cell at resolution 0–15.

Batch

Tool

Description

batch_geocode

Geocode up to 30,000 addresses in a single call. Never loop geocode for bulk data.

batch_reverse_geocode

Reverse geocode multiple coordinates in one call.

Tiles

Tool

Description

get_tile_style_url

MapLibre GL style URL. Styles: light, dark, streets, topo, grayscale, black, white, liberty.

get_static_map_url

Static PNG map URL for use in <img> tags, emails, and PDFs.

Auth

  • API calls: X-API-Key header (handled automatically by the MCP server)

  • Tile URLs: ?key= query param (browser-safe; returned by get_tile_style_url)

Common Patterns for Agents

Geocode once, reuse the result:

Don't re-geocode the same address twice within a session. Cache the lat/lon and pass it directly to route, isochrone, and places_search.

Bulk data → batch tools:

For more than 1 address or coordinate pair, always use batch_geocode / batch_reverse_geocode.

Route fails → nearest_road first:

If route returns an error near the origin or destination, call nearest_road to snap the point to a routable road, then retry route with the snapped coordinates.

Isochrone — time vs distance:

Use contours_minutes for time-based reachability (delivery ETAs, commute zones).
Use contours_meters for fixed-radius circles on the road network.
Provide only one, not both.

Pricing

Plan

Calls/day

Batch size

Free

1,000

10

Growth

50,000

5,000

Business

Unlimited

30,000

Full pricing at mapsi.dev/pricing

Links

License

MIT — algolayer.com

Install Server
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • acuris-mcp

    Address validation & geocoding for AI agents: 240+ countries, UK PAF, free US/CA enrichment

  • mcp-server

    Geospatial intelligence with Mapbox APIs like geocoding, POI search, directions, isochrones, etc.

  • gisgp

    GIS tools for AI agents: 65 free tools + 8 paid (hazard/site-scouting/GeoJSON export)

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/algolayertechnologies/mapsi-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server