mcp-mapmyindia

MCP Server for Mappls / MapMyIndia APIs

An MCP (Model Context Protocol) server that exposes Mappls / MapMyIndia APIs as tools for AI assistants like Claude. Enables geocoding, reverse geocoding, place search, nearby discovery, routing, and distance calculations — all focused on India's mapping data.

Tools

Tool	Description
`geocode`	Convert an address or place name to coordinates
`reverse_geocode`	Convert coordinates (lat/lng) to a human-readable address
`places_search`	Autocomplete and search for places by query string
`nearby`	Discover nearby places by keyword around a reference location
`directions`	Get turn-by-turn directions between two points (supports waypoints)
`distance_matrix`	Compute travel distance and time between multiple origins and destinations
`place_detail`	Fetch detailed information for a place using its eLoc (Mappls place ID)

Setup

Get API credentials

An API key (simpler, for personal/testing use)
OAuth client credentials (recommended for production)

Authentication

Set one of the following in your environment:

Option A — OAuth (Client Credentials): RECOMMENDED

server.ts

export MAPPLS_CLIENT_ID=your_client_id
export MAPPLS_CLIENT_SECRET=your_client_secret

Option B — API Key:

server.ts

export MAPPLS_API_KEY=your_api_key_here

Usage with Claude Desktop

Add to your claude_desktop_config.json:

JSON Config

{
  "mcpServers": {
    "mapmyindia": {
      "command": "npx",
      "args": ["-y", "@bhuvsh/mcp-mapmyindia"],
      "env": {
        "MAPPLS_CLIENT_ID": "your_client_id",
        "MAPPLS_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

Or with API key:

config.json

{
  "mcpServers": {
    "mapmyindia": {
      "command": "npx",
      "args": ["-y", "@bhuvnsh/mcp-mapmyindia"],
      "env": {
        "MAPPLS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Config file location:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Development

bash

# Clone and install
git clone https://github.com/bhuvnsh/mcp-mappls.git
cd mcp-mappls
npm install

# Build
npm run build

# Run tests
npm test

# Watch mode (dev)
npm run dev

Requirements

Node.js >= 18
A Mappls API key or OAuth client credentials

Contributing

Contributions are welcome. Please open an issue first to discuss what you'd like to change. Pull requests should include tests.

License

MIT