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

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