Mappls Maps

MCP Server for Mappls / MapMyIndia APIs

CI npm version License: MIT

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

Register at https://apis.mappls.com to get either:

• 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

export MAPPLS_CLIENT_ID=your_client_id
export MAPPLS_CLIENT_SECRET=your_client_secret

Option B — API Key:

export MAPPLS_API_KEY=your_api_key_here

---

Usage with Claude Desktop

Add to your claude_desktop_config.json:

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

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

# 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