magiclane-location_searchLABSCO SUMMARY
The map comes back drawn, not as a list of coordinates.
The static renderer works out the viewport itself and returns the route JSON with the image, so there is no separate calculation call. Where the client supports it, the interactive map draws several overlays at once — a route plus an isochrone plus the geofences — each in its own colour.
What it is
Magic Lane's own TypeScript server over its mapping and routing APIs. Eight tools covering search, routing, isochrones, reverse geocoding, geofences and two kinds of map rendering, over stdio or HTTP.
What you get
- Addresses, cities and points of interest found with category filters around a reference location — magiclane-location_search
- Routes across multiple waypoints with transport modes, POI stops along the way and multi-delivery optimisation — magiclane-route_planner
- Reachability polygons by time or distance for car, lorry, truck, pedestrian, bike or public transport — magiclane-isochrone_calculator
- Circular routes that return to where they started, for a run, a ride or a delivery loop — magiclane-round_trip
- Coordinates turned into addresses with the administrative hierarchy and nearby POIs — magiclane-reverse_geocode
- Geofences created as polygons, circles or rectangles, queried by id, bounding box or proximity, updated, deleted and point-tested — magiclane-geofence_manager
- A static map image of a route, isochrone, round trip or plain view as PNG, JPEG or WebP, with the route JSON alongside it — magiclane-static_map_render
- A pan-and-zoom vector map rendered inside the conversation, with one or many overlays each drawn in its own colour — magiclane-interactive_map
Requirements
Node.js 22 or newer and a Magic Lane API key in MAGICLANE_API_KEY. Run npx @magiclane/mcp-server for stdio, or the HTTP server for web and serverless clients. VERBOSE and HTTP_TIMEOUT_SECONDS, default 30, are optional. A Dockerfile is included.
Setup effort
Add the configuration to your client
USE CASES
01
Planning a trip with stops along the way
Route across several waypoints and let it place a fuel stop or a restaurant on the way, with traffic and restrictions taken into account.
02
Answering how far you can get in twenty minutes
An isochrone returns the reachable area as a polygon for the transport mode you name, which is a different question from a route.
03
Building a loop that ends where it started
Round trips take a length or a duration and a transport mode, with hill-skip preferences for cyclists.
04
Watching whether an asset left an area
Define the boundary as a polygon, circle or rectangle, then test coordinates against it — creation, query and point testing are all tools.
8 tools
Listed in project docs. Your client may show a different list.
magiclane-route_plannermagiclane-static_map_rendermagiclane-round_tripmagiclane-isochrone_calculatormagiclane-reverse_geocodemagiclane-geofence_managermagiclane-interactive_mapBEFORE YOU INSTALL
What to know first
Tools you get
8 tools named in the project's documentation.
Requires
- Node.js 22+
- MAGICLANE_API_KEY in your environment
INSTALLATION
Connect your client
MCP Clients
Claude Desktop, Cursor
JSON
{
"mcpServers": {
"MagicLaneServer": {
"command": "npx",
"args": [
"-y",
"-p",
"@magiclane/mcp-server",
"magiclane-mcp"
],
"env": {
"MAGICLANE_API_KEY": "<YOUR_MAGICLANE_API_KEY>"
}
}
}
}VS Code
VS CODE · JSON
{
"servers": {
"MagicLaneServer": {
"command": "npx",
"args": [
"-y",
"-p",
"@magiclane/mcp-server",
"magiclane-mcp"
],
"env": {
"MAGICLANE_API_KEY": "<YOUR_MAGICLANE_API_KEY>"
}
}
}
}Claude Desktop — Docker
CLAUDE DESKTOP — DOCKER · TERMINAL
git clone https://github.com/magiclane/magiclane-mcp-server.git
cd magiclane-mcp-server
docker build -t magiclane-mcp-server .CLAUDE DESKTOP — DOCKER · JSON
{
"mcpServers": {
"MagicLaneServer": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e",
"MAGICLANE_API_KEY=<YOUR_MAGICLANE_API_KEY>",
"magiclane-mcp-server:latest"
]
}
}
}The image is built locally by the docker build step.
