io.github.AmanMakesStuff/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