Mappls MCP

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.

Tools (18)

Search & Geocoding

Routing & Navigation

Utilities

Getting Started

1. Get a Mappls API key (free)

1. Sign up at about.mappls.com/api — free account, no credit card
2. After login, click Create New Project → choose Cloud as the platform
3. Open the project → go to the Credentials tab → copy the Static Key
4. 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:

npx mappls-mcp

Or clone and build locally:

git clone https://github.com/AmanMakesStuff/mappls-mcp

cd mappls-mcp npm install && npm run build

3. Configure

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 automatically
• poi_along_route requires the encoded polyline from the geometry field of a get_directions response
• still_map_image returns a URL — the image is a PNG map tile

License

MIT — built by AmanMakesStuff