About io.github.bhuvnsh/mcp-mapmyindia
io.github.bhuvnsh/mcp-mapmyindia is an MCP server in the Search category: mCP server for India maps - place search, nearby discovery, & directions powered by the Mappls API.
Install
claude mcp add io-github-bhuvnsh-mcp-mapmyindia -- npx -y @bhuvnsh/mcp-mapmyindianpx -y @bhuvnsh/mcp-mapmyindiaThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (7)
directionsGet turn-by-turn directions between two points (supports waypoints)
Parameters not published.
distance_matrixCompute travel distance and time between multiple origins and destinations
Parameters not published.
geocodeConvert an address or place name to coordinates
Parameters not published.
nearbyDiscover nearby places by keyword around a reference location
Parameters not published.
place_detailFetch detailed information for a place using its eLoc (Mappls place ID)
Parameters not published.
places_searchAutocomplete and search for places by query string
Parameters not published.
reverse_geocodeConvert coordinates (lat/lng) to a human-readable address
Parameters not published.
Ask AI
Ask AI about io.github.bhuvnsh/mcp-mapmyindia
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
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
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
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.