Mappls Mcp

io.github.AmanMakesStuffPublished by GitHub account AmanMakesStuffv2.0.0Updated Oct 24, 2026

MCP server for Mappls (MapMyIndia) — India-first maps API for AI agents

VerifiedSTDIODesktop onlyLocation & LifestyleWeb Search & Scraping

Overview

AI-generated overview

An MCP server that gives an assistant India-focused Mappls (MapMyIndia) geocoding, routing, nearby search, and map utilities.

What you can do
Wraps the Mappls (MapMyIndia) maps API for India-first location data. Search and geocoding tools include geocode, reverse_geocode, autosuggest, text_search, nearby_search, place_details, address_analytics, and validate_pincode. Routing tools cover get_directions, traffic-aware directions and distance matrices, POIs along a route, and snap_to_road. Utilities add elevation, straight-line distance, and a static map image URL.
When to use it
Useful when an assistant needs accurate Indian addresses, pincodes, place search, or driving and walking routes within India. It is a fit for India-focused location questions where a general global maps server is less precise.
Requirements
Runs locally over stdio, typically via npx mappls-mcp or a global npm install, so Node.js is needed. A Mappls static API key is required in the MAPPLS_API_KEY environment variable, obtained from a free Mappls developer account. Network access to the Mappls API is required.
Before you install
The MAPPLS_API_KEY secret is passed in plain text through the client configuration, so keep the config file private. The README suggests leaving the API key's IP whitelisting field blank for unrestricted access, which removes a restriction on where the key can be used. Requests send addresses and coordinates to Mappls, a third-party service, and usage is subject to its free-tier limits.

Installation

In SourceWeft

  1. Open Mappls Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

ToolDescription
geocodeAddress or place name → lat/lng
reverse_geocodelat/lng → human-readable Indian address
autosuggestAutocomplete suggestions as user types
text_searchSearch by keyword or brand (e.g. "Starbucks Delhi")
nearby_searchFind hospitals, ATMs, petrol pumps, restaurants near a point
place_detailsFull details for a place using its eLoc code
address_analyticsStandardize a raw address into structured components
validate_pincodeValidate a 6-digit pincode, get district + state

Routing & Navigation

ToolDescription
get_directionsTurn-by-turn directions (driving/biking/walking)
get_directions_with_trafficTraffic-aware ETA using real-time conditions
distance_matrixDistances + durations between multiple points
distance_matrix_with_trafficTraffic-aware distance matrix
poi_along_routeFind fuel stations, restaurants, ATMs along a route
snap_to_roadSnap raw GPS coordinates to nearest road

Utilities

ToolDescription
elevationAltitude above sea level for any lat/lng point
aerial_distanceStraight-line (crow-fly) distance between two points
still_map_imageGenerate 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

bash
npm install -g mappls-mcp

Or run directly without installing:

bash
npx mappls-mcp

Or clone and build locally:

bash
git clone https://github.com/AmanMakesStuff/mappls-mcpcd mappls-mcpnpm install && npm run build

3. Configure

Set your API key as an environment variable:

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

json
{  "mcpServers": {    "mappls": {      "command": "npx",      "args": ["mappls-mcp"],      "env": {        "MAPPLS_API_KEY": "your_static_key_here"      }    }  }}

Cursor / Windsurf

Add to your MCP settings:

json
{  "mappls": {    "command": "npx",    "args": ["mappls-mcp"],    "env": {      "MAPPLS_API_KEY": "your_static_key_here"    }  }}

Local build (alternative)

If you cloned the repo:

json
{  "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

Source: README.md at commit 37b4980

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v2.0.0LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.