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

| 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)

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