mcp-mapmyindia

mcp-mapmyindia

<!-- mcp-name: io.github.bhuvnsh/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

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 ``bash export MAPPLS_CLIENT_ID=your_client_id export MAPPLS_CLIENT_SECRET=your_client_secret ``

Option B — API Key: ``bash 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