Skip to main content

Transform Your AI into a Geospatial Copilot

|



The Magic Lane MCP Server enables any AI agent to become a geospatially intelligent assistant for pedestrians, cyclists, and drivers. Built on Magic Lane's advanced mapping technology, it empowers AI agents to understand geospatial data, interpret spatial context, and deliver accurate navigation guidance.

Magic Lane MCP Server Demo

Core Capabilities​

The server provides four integrated tools:

  • Intelligent Search - Find addresses, POIs, or coordinates with category filtering
  • Smart Routing - Generate optimized routes with support for various transport modes and preferences
  • Route Visualization - Create visual map images of calculated routes
  • Isochrone Analysis - Calculate reachability polygons within time or distance constraints

Getting Started​

Prerequisites​

Installation​

Run the server directly without installation:

export MAGICLANE_API_KEY="your_api_key"
npx @magiclane/mcp-server

Running the Server​

For MCP-native clients like Claude Desktop:

# Using .env file
cp .env.example .env
npm start

# Or with environment variable
MAGICLANE_API_KEY=your_api_key npm start

Client Configuration​

Configure your MCP client using our setup guides:

Available Tools​

Find coordinates, addresses, or POIs using the Magic Lane Search API.

Example Prompts:

  • "Search for Italian restaurants near Millennium Park, Chicago"
  • "Find parking garages near Amsterdam Central Station"
  • "Locate pharmacies near Baker Street 221B, London"

2. Route Planner​

Generate optimized routes using the Magic Lane Routing API.

Example Prompts:

  • "Plan a scenic bike route from Vienna to Bratislava"
  • "Find public transport from JFK Airport to Manhattan with minimal transfers"
  • "Create a walking tour from the Colosseum to Trevi Fountain, stopping at the Pantheon"

3. Isochrone Calculator​

Analyze reachability using the Magic Lane Isochrones API.

Example Prompts:

  • "Where can I cycle to in 45 minutes from Amsterdam Central?"
  • "Display all areas within a 10-minute walk from Barclays Center Station"
  • "Show the 1-hour driving catchment from our Frankfurt warehouse"

4. Renderer​

Generate visual map images of routes and isochrones as PNG, JPEG, or WebP. Uses the same parameters as Route Planner and Isochrone Calculator.

Example Prompts:

  • Route representation
    • I'm at 10 Downing Street, London - please show a driving route to St Paul's Cathedral.
Route visualization example
  • Isochrone representation
    • Please display a map of Paris with a 15-minute walking isochrone.
Isochrone visualization example

Troubleshooting​

ErrorSolution
401 UnauthorizedCheck your API key in the Dashboard
404 Not FoundLocation could not be found - try a different query
429 Too Many RequestsRate limit exceeded - check your usage
400 Bad RequestInvalid parameters - verify input format

For detailed troubleshooting and complete parameter documentation, visit the GitHub repository.

Data Usage & Privacy​

Magic Lane is committed to protecting your privacy:

  • No Request Logging - Routing requests and location queries are not stored
  • Transient Processing - Requests processed in real-time and immediately discarded
  • No User Profiling - No usage pattern tracking or cross-session correlation
  • Encrypted Transmission - All communications use TLS/SSL

For details, review our Terms of Service and Privacy Policy.

Resources​

Last updated on