QuantaRoute

You can run the QuantaRoute MCP Server to empower AI assistants with fast geocoding, location lookup, and DigiPin processing using the QuantaRoute Geocoding API. This MCP server exposes powerful tools via HTTP endpoints and a local MCP runtime that you can run from your development machine or integrate into clients that support MCP.

How to use

You will configure an MCP client to communicate with both the HTTP REST API wrapper and the local MCP runtime. Use the HTTP endpoint for remote, serverless or hosted usage, and run the local MCP server for development or private deployments. Your client can geocode addresses, reverse geocode DigiPin codes, convert coordinates to DigiPin codes, perform batch lookups, autocomplete addresses, validate DigiPins, and query usage or health status. Where available, you can also look up administrative boundaries from coordinates or DigiPin codes.

How to install

Prerequisites to run the MCP server locally: install Node.js 18+ and npm. You will also need a QuantaRoute API key for full functionality.

# Install the MCP server package and its dependencies
npm install

# Build the project for production or local use
npm run build

# Run in development mode (final start command for local MCP)
npm run dev

Configuration and usage notes

Two primary ways to access the MCP server are through the hosted REST API and the local MCP SDK. Use the hosted REST API at the provided base URL to perform geocoding, lookups, and health checks. When running locally, configure your client to point at the local MCP runtime using the same tool names and endpoints you normally use for MCP interactions.

Security and authentication

All requests to the hosted REST API require authentication via the API key header x-api-key. For local development, you supply the API key in your requests or configure the environment variable QUANTAROUTE_API_KEY when appropriate.

Troubleshooting tips

If you encounter server not appearing in the client, verify the configuration files and that the MCP server is running. Check environment variables for correctness and ensure Node.js is installed at a compatible version. For REST API access, ensure your API key is valid and included in the x-api-key header for every request.

Notes

The REST API wrapper is designed for both mobile and web applications, exposing all MCP tools via HTTP endpoints with authentication and CORS support. The hosted endpoint is intended for quick start and testing, while the local MCP runtime provides a complete development and deployment pathway.

Available tools

geocode

Geocode an address to get a DigiPin code and coordinates.

reverse_geocode

Reverse geocode a DigiPin to obtain coordinates and the corresponding address.

coordinates_to_digipin

Convert latitude and longitude into a DigiPin code.

lookup_location_from_coordinates

Retrieve administrative boundaries and related data from coordinates.

lookup_location_from_digipin

Retrieve administrative boundaries from a DigiPin code.

batch_location_lookup

Perform batch location lookups for multiple locations (up to 100 per request).

batch_geocode

Geocode multiple addresses in a single request (up to 100).

autocomplete

Get address autocomplete suggestions based on a query.

find_nearby_boundaries

Find nearby postal boundaries within a radius (COMING SOON)

validate_digipin

Validate the DigiPin format and verify if it maps to a real location.

get_usage

Get API usage statistics and quota information.

get_location_statistics

Get live statistics about the Location Lookup service.

get_health

Check API health status.