Skip to main content
Glama
Sign In
mappls-mcp

mappls-mcp

by AmanMakesStuff
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

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

Related MCP server: Mapbox MCP Server

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

Available Tools

17 tools
address_analyticsA

Analyze and standardize an Indian address — breaks it into structured components (house number, street, locality, district, state, pincode).

Inputs: address (required).

aerial_distanceA

Get the straight-line (crow-fly) distance between two geographic points. Faster than routing for simple distance checks.

Inputs: to (required), from (required), unit.

autosuggestA

Get autocomplete suggestions for an address or place as the user types. Returns a list of matching places with their eLoc codes.

Inputs: query (required), lat, lng, region.

distance_matrixA

Calculate distances and travel times between multiple points. First coordinate is the origin; all others are destinations. Returns a matrix of distances and durations.

Inputs: coordinates (required), profile.

distance_matrix_with_trafficB

Calculate distances and traffic-aware ETAs between multiple points using real-time traffic data.

Inputs: coordinates (required), profile.

elevationA

Get the elevation (altitude above sea level in metres) for one or more lat/lng points.

Inputs: locations (required).

geocodeA

Convert an Indian address or place name into latitude/longitude coordinates. Works with full addresses, landmarks, cities, and pincodes.

Inputs: address (required), itemCount.

get_directionsA

Get turn-by-turn driving/biking/walking directions between two points in India, including distance, duration, and step-by-step instructions.

Inputs: origin (required), destination (required), profile.

get_directions_with_trafficA

Get directions with real-time traffic-aware ETA. Returns predictive travel time based on current traffic conditions.

Inputs: origin (required), destination (required), profile.

nearby_searchA

Find points of interest near a location in India — hospitals, ATMs, restaurants, petrol pumps, schools, etc.

Inputs: lat (required), lng (required), keywords (required), radius, +1 more.

place_detailsA

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.

Inputs: eLoc (required).

poi_along_routeA

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.

Inputs: path (required), category (required), buffer.

reverse_geocodeA

Convert latitude/longitude coordinates into a human-readable Indian address.

Inputs: lat (required), lng (required).

snap_to_roadA

Snap a series of GPS coordinates to the nearest road. Useful for cleaning up raw GPS traces from a device.

Inputs: points (required).

still_map_imageA

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.

Inputs: lat (required), lng (required), zoom, width, +2 more.

text_searchC

Search for places in India by keyword, category, or brand name (e.g. 'Starbucks Delhi', 'petrol pump Mumbai').

Inputs: query (required), filter, region.

validate_pincodeA

Validate an Indian 6-digit pincode and get the associated district, city, and state information.

Inputs: pincode (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.7/5.0

    Scored across 17 tools

    Disambiguation5/5

    Each tool has a distinct purpose: geocoding, search, directions, traffic, elevation, static maps, etc. No two tools overlap in functionality.

    Naming Consistency4/5

    All tool names use snake_case and are mostly descriptive, but some are verb_noun (get_directions) while others are single words (geocode, elevation). 'still_map_image' is slightly awkward but still clear.

    Tool Count5/5

    17 tools cover a comprehensive set of location-based services without being excessive. Each tool earns its place.

    Completeness4/5

    Covers core location needs: geocoding, search, routing, traffic, elevation, maps, pincode validation. Missing features like isochrones or place reviews are minor gaps.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Google Maps MCP Server

      iceener
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables location-aware AI agents to search for nearby places, get detailed place information including hours and ratings, and calculate routes with turn-by-turn directions using Google Maps APIs.
      22
      MIT
    • Magic Lane MCP Server

      Magic Lane MCP Serverofficial

      magiclane
      A
      license
      B
      quality
      C
      maintenance
      Enables AI agents to become geospatially intelligent assistants with tools for location search, smart routing, round trip planning, reverse geocoding, isochrone analysis, route visualization, geofence management, and interactive map display.
      8
      17 npm
      7
      Apache 2.0