mappls-mcp
An MCP (Model Context Protocol) server for Mappls — India's own maps platform (MapMyIndia). Gives AI agents accurate geocoding, routing, nearby search, and more for Indian addresses and locations.
Built because Google Maps MCP exists, but nothing existed for India-first location data.
Search & Geocoding
| Tool | Description |
|---|
geocode | Address or place name → lat/lng |
reverse_geocode | lat/lng → human-readable Indian address |
autosuggest | Autocomplete suggestions as user types |
text_search | Search by keyword or brand (e.g. "Starbucks Delhi") |
nearby_search | Find hospitals, ATMs, petrol pumps, restaurants near a point |
place_details | Full details for a place using its eLoc code |
address_analytics | Standardize a raw address into structured components |
validate_pincode | Validate a 6-digit pincode, get district + state |
Routing & Navigation
| Tool | Description |
|---|
get_directions | Turn-by-turn directions (driving/biking/walking) |
get_directions_with_traffic | Traffic-aware ETA using real-time conditions |
distance_matrix | Distances + durations between multiple points |
distance_matrix_with_traffic | Traffic-aware distance matrix |
poi_along_route | Find fuel stations, restaurants, ATMs along a route |
snap_to_road | Snap raw GPS coordinates to nearest road |
Utilities
| Tool | Description |
|---|
elevation | Altitude above sea level for any lat/lng point |
aerial_distance | Straight-line (crow-fly) distance between two points |
still_map_image | Generate a static map image URL for any location |
Getting Started
1. Get a Mappls API key (free)
- Sign up at about.mappls.com/api — free account, no credit card
- After login, click Create New Project → choose Cloud as the platform
- Open the project → go to the Credentials tab → copy the Static Key
- Go to the Whitelisting tab → leave the IP field blank for unrestricted access
The free tier includes generous API limits suitable for development and small projects.
2. Install
npm install -g mappls-mcp
Or run directly without installing:
Or clone and build locally:
git clone https://github.com/AmanMakesStuff/mappls-mcp
cd mappls-mcp
npm install && npm run build
Set your API key as an environment variable:
export MAPPLS_API_KEY=your_static_key_here
Integration
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"mappls": {
"command": "npx",
"args": ["mappls-mcp"],
"env": {
"MAPPLS_API_KEY": "your_static_key_here"
}
}
}
}
Cursor / Windsurf
Add to your MCP settings:
{
"mappls": {
"command": "npx",
"args": ["mappls-mcp"],
"env": {
"MAPPLS_API_KEY": "your_static_key_here"
}
}
}
Local build (alternative)
If you cloned the repo:
{
"mcpServers": {
"mappls": {
"command": "node",
"args": ["/absolute/path/to/mappls-mcp/build/index.js"],
"env": {
"MAPPLS_API_KEY": "your_static_key_here"
}
}
}
}
Example Prompts
Once connected, ask your AI agent:
- "Find the nearest hospital to Connaught Place, New Delhi"
- "What's the address at 28.6139, 77.2090?"
- "Get driving directions from Bandra to Andheri"
- "Is pincode 400001 valid? What area is it?"
- "How far is Delhi from Mumbai in a straight line?"
- "What is the elevation of Shimla?"
- "Find ATMs along the route from India Gate to Qutub Minar"
- "Standardize this address: 237 Okhla Industrial Phase 3 ND 110020"
- "Search for Domino's near Koramangala Bangalore"
Notes
- All tools accept lat/lng in decimal degrees (e.g.
28.6139, 77.2090)
- Routing tools use lat,lng format for input (the server handles coordinate conversion internally)
nearby_search uses plain keywords like "hospital", "atm", "restaurant" — Mappls maps these to category codes automaticallypoi_along_route requires the encoded polyline from the geometry field of a get_directions responsestill_map_image returns a URL — the image is a PNG map tile
License
MIT — built by AmanMakesStuff