Meta Agent Tools
PT

Back to the catalog

io.github.bhuvnsh/mcp-mapmyindia

MCP server for India maps - place search, nearby discovery, & directions powered by the Mappls API.

Open source Open in the app JSON README (API)

About

MCP server for India maps - place search, nearby discovery, & directions powered by the Mappls API.

Details

Kind
MCP servers
Topic
Maps, weather & travel
Publisher
bhuvnsh
Origin
official
Category
ferramentas
Transport
local
Version
0.1.0
Last push
2026-03-20T16:38:21Z
Repository state
ativo
Language
TypeScript
License
MIT
Added
2026-08-29 03:02:31
Updated
2026-08-29 03:02:31
Origin id
io.github.bhuvnsh/mcp-mapmyindia

README

# mcp-mapmyindia

<!-- mcp-name: io.github.bhuvnsh/mcp-mapmyindia -->

**MCP Server for Mappls / MapMyIndia APIs**

[![CI](https://github.com/bhuvnsh/mcp-mappls/actions/workflows/ci.yml/badge.svg)](https://github.com/bhuvnsh/mcp-mappls/actions/workflows/ci.yml)
[![npm version](https://img.shields.io/npm/v/mcp-mapmyindia.svg)](https://www.npmjs.com/package/mcp-mapmyindia)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

An [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that exposes [Mappls / MapMyIndia](https://mappls.com) 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](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`:

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

```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](LICENSE)

More