Mappls MCP server

by AmanMakesStuff·io.github.AmanMakesStuff/mappls-mcp·v2.0.0·3 stars

No reviews yet

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

B72/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B72/100

full report

Adoption

New

3 stars38 downloads/wk

Reviews

Write one

Nobody has reviewed Mappls yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Mappls tools (17)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

address_analytics
Analyze and standardize an Indian address — breaks it into structured components (house number, street, locality, district, state, pincode).
aerial_distance
Get the straight-line (crow-fly) distance between two geographic points. Faster than routing for simple distance checks.
autosuggest
Get autocomplete suggestions for an address or place as the user types. Returns a list of matching places with their eLoc codes.
distance_matrix
Calculate distances and travel times between multiple points. First coordinate is the origin; all others are destinations. Returns a matrix of distances and durations.
distance_matrix_with_traffic
Calculate distances and traffic-aware ETAs between multiple points using real-time traffic data.
elevation
Get the elevation (altitude above sea level in metres) for one or more lat/lng points.
geocode
Convert an Indian address or place name into latitude/longitude coordinates. Works with full addresses, landmarks, cities, and pincodes.
get_directions
Get turn-by-turn driving/biking/walking directions between two points in India, including distance, duration, and step-by-step instructions.
get_directions_with_traffic
Get directions with real-time traffic-aware ETA. Returns predictive travel time based on current traffic conditions.
nearby_search
Find points of interest near a location in India — hospitals, ATMs, restaurants, petrol pumps, schools, etc.
place_details
Get full details (name, address, category, contact, hours) for a place using its Mappls eLoc code. eLoc codes are returned by autosuggest, nearby_search, and text_search.
poi_along_route
Find points of interest along a route — useful for finding fuel stations, restaurants, or ATMs on the way from A to B. Requires the encoded polyline from get_directions.
reverse_geocode
Convert latitude/longitude coordinates into a human-readable Indian address.
snap_to_road
Snap a series of GPS coordinates to the nearest road. Useful for cleaning up raw GPS traces from a device.
still_map_image
Generate a static map image URL centered on a location. Returns a URL to a PNG map image — useful for embedding maps in reports or sending via WhatsApp/email.
text_search
Search for places in India by keyword, category, or brand name (e.g. 'Starbucks Delhi', 'petrol pump Mumbai').
validate_pincode
Validate an Indian 6-digit pincode and get the associated district, city, and state information.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings

Code scan4 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitystatic API keys via environment variables6/15
Maintenancelast push 146 days ago8/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Overall 72/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Mappls compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 72/100; higher than 38% of 48,255 servers
Tools: 17; the typical server has 7
Tools that change things: 0%; typical: 0%. Fewer write tools means less an agent can break
GitHub stars: 3; more than 80% of 28,688 servers
Downloads a week: 38; more than 29% of 12,191 servers with a package

What its tools let an agent do: 16 read · 1 create

Install Mappls in Claude Code, Cursor or VS Code

Runs npx -y mappls-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add mappls-mcp -- npx -y mappls-mcp

Add to Cursor

What the publisher says

From the Mappls repository's README, as published. We do not edit it. Read it on GitHub

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)

Sign up at about.mappls.com/api — free account, no credit card
After login, click Create New Project → choose Cloud as the platform
Open the project → go to the Credentials tab → copy the Static Key
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/claudedesktopconfig.json (macOS) or %APPDATA%\Claude\claudedesktopconfig.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:

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Mappls: common questions

Is Mappls MCP server safe?: Mostly: it is graded B (72/100). Read the Mappls safety report
How do I install Mappls?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Mappls need an API key?: Yes. The registry entry asks for MAPPLS_API_KEY.
Is Mappls maintained?: The last commit was 183 days ago (2026-05-05). The latest release is v2.0.0.
How does Mappls compare with other MCP servers?: safety score 72/100 (higher than 38% of 48,255 servers); tools 17 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.