{
  "markdown": "# mcp-mapmyindia\n\n<!-- mcp-name: io.github.bhuvnsh/mcp-mapmyindia -->\n\n**MCP Server for Mappls / MapMyIndia APIs**\n\n[![CI](https://github.com/bhuvnsh/mcp-mappls/actions/workflows/ci.yml/badge.svg)](https://github.com/bhuvnsh/mcp-mappls/actions/workflows/ci.yml)\n[![npm version](https://img.shields.io/npm/v/mcp-mapmyindia.svg)](https://www.npmjs.com/package/mcp-mapmyindia)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n\nAn [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.\n\n---\n\n## Tools\n\n| Tool | Description |\n|---|---|\n| `geocode` | Convert an address or place name to coordinates |\n| `reverse_geocode` | Convert coordinates (lat/lng) to a human-readable address |\n| `places_search` | Autocomplete and search for places by query string |\n| `nearby` | Discover nearby places by keyword around a reference location |\n| `directions` | Get turn-by-turn directions between two points (supports waypoints) |\n| `distance_matrix` | Compute travel distance and time between multiple origins and destinations |\n| `place_detail` | Fetch detailed information for a place using its eLoc (Mappls place ID) |\n\n---\n\n## Setup\n\n### Get API credentials\n\nRegister at [https://apis.mappls.com](https://apis.mappls.com) to get either:\n- An **API key** (simpler, for personal/testing use)\n- **OAuth client credentials** (recommended for production)\n\n### Authentication\n\nSet one of the following in your environment:\n\n**Option A — OAuth (Client Credentials):**\nRECOMMENDED\n```bash\nexport MAPPLS_CLIENT_ID=your_client_id\nexport MAPPLS_CLIENT_SECRET=your_client_secret\n```\n\n**Option B — API Key:**\n```bash\nexport MAPPLS_API_KEY=your_api_key_here\n```\n\n---\n\n## Usage with Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```OAuth\n{\n  \"mcpServers\": {\n    \"mapmyindia\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@bhuvsh/mcp-mapmyindia\"],\n      \"env\": {\n        \"MAPPLS_CLIENT_ID\": \"your_client_id\",\n        \"MAPPLS_CLIENT_SECRET\": \"your_client_secret\"\n      }\n    }\n  }\n}\n```\n\nOr with API key:\n\n```json\n{\n  \"mcpServers\": {\n    \"mapmyindia\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@bhuvnsh/mcp-mapmyindia\"],\n      \"env\": {\n        \"MAPPLS_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\nConfig file location:\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n---\n\n## Development\n\n```bash\n# Clone and install\ngit clone https://github.com/bhuvnsh/mcp-mappls.git\ncd mcp-mappls\nnpm install\n\n# Build\nnpm run build\n\n# Run tests\nnpm test\n\n# Watch mode (dev)\nnpm run dev\n```\n\n### Requirements\n\n- Node.js >= 18\n- A Mappls API key or OAuth client credentials\n\n---\n\n## Contributing\n\nContributions are welcome. Please open an issue first to discuss what you'd like to change. Pull requests should include tests.\n\n---\n\n## License\n\n[MIT](LICENSE)\n",
  "bytes": 3128,
  "sha": "988dfb705202716accbeacdc6d1e6ff53e1b673c50a51b62957d0443e425b0c2",
  "repo_slug": "bhuvnsh/mcp-mapmyindia",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_bhuvnsh_mcp_mapmyindia_98581039/readme"
}