{
  "markdown": "# mappls-mcp\n\nAn MCP (Model Context Protocol) server for [Mappls](https://maps.mappls.com) — India's own maps platform (MapMyIndia). Gives AI agents accurate geocoding, routing, nearby search, and more for Indian addresses and locations.\n\n> Built because Google Maps MCP exists, but nothing existed for India-first location data.\n\n## Tools (18)\n\n### Search & Geocoding\n| Tool | Description |\n|------|-------------|\n| `geocode` | Address or place name → lat/lng |\n| `reverse_geocode` | lat/lng → human-readable Indian address |\n| `autosuggest` | Autocomplete suggestions as user types |\n| `text_search` | Search by keyword or brand (e.g. \"Starbucks Delhi\") |\n| `nearby_search` | Find hospitals, ATMs, petrol pumps, restaurants near a point |\n| `place_details` | Full details for a place using its eLoc code |\n| `address_analytics` | Standardize a raw address into structured components |\n| `validate_pincode` | Validate a 6-digit pincode, get district + state |\n\n### Routing & Navigation\n| Tool | Description |\n|------|-------------|\n| `get_directions` | Turn-by-turn directions (driving/biking/walking) |\n| `get_directions_with_traffic` | Traffic-aware ETA using real-time conditions |\n| `distance_matrix` | Distances + durations between multiple points |\n| `distance_matrix_with_traffic` | Traffic-aware distance matrix |\n| `poi_along_route` | Find fuel stations, restaurants, ATMs along a route |\n| `snap_to_road` | Snap raw GPS coordinates to nearest road |\n\n### Utilities\n| Tool | Description |\n|------|-------------|\n| `elevation` | Altitude above sea level for any lat/lng point |\n| `aerial_distance` | Straight-line (crow-fly) distance between two points |\n| `still_map_image` | Generate a static map image URL for any location |\n\n## Getting Started\n\n### 1. Get a Mappls API key (free)\n\n1. Sign up at [about.mappls.com/api](https://about.mappls.com/api) — free account, no credit card\n2. After login, click **Create New Project** → choose **Cloud** as the platform\n3. Open the project → go to the **Credentials** tab → copy the **Static Key**\n4. Go to the **Whitelisting** tab → **leave the IP field blank** for unrestricted access\n\n> The free tier includes generous API limits suitable for development and small projects.\n\n### 2. Install\n\n```bash\nnpm install -g mappls-mcp\n```\n\nOr run directly without installing:\n\n```bash\nnpx mappls-mcp\n```\n\nOr clone and build locally:\n\n```bash\ngit clone https://github.com/AmanMakesStuff/mappls-mcp\ncd mappls-mcp\nnpm install && npm run build\n```\n\n### 3. Configure\n\nSet your API key as an environment variable:\n\n```bash\nexport MAPPLS_API_KEY=your_static_key_here\n```\n\n---\n\n## Integration\n\n### Claude Desktop\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"mappls\": {\n      \"command\": \"npx\",\n      \"args\": [\"mappls-mcp\"],\n      \"env\": {\n        \"MAPPLS_API_KEY\": \"your_static_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Cursor / Windsurf\n\nAdd to your MCP settings:\n\n```json\n{\n  \"mappls\": {\n    \"command\": \"npx\",\n    \"args\": [\"mappls-mcp\"],\n    \"env\": {\n      \"MAPPLS_API_KEY\": \"your_static_key_here\"\n    }\n  }\n}\n```\n\n### Local build (alternative)\n\nIf you cloned the repo:\n\n```json\n{\n  \"mcpServers\": {\n    \"mappls\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/mappls-mcp/build/index.js\"],\n      \"env\": {\n        \"MAPPLS_API_KEY\": \"your_static_key_here\"\n      }\n    }\n  }\n}\n```\n\n---\n\n## Example Prompts\n\nOnce connected, ask your AI agent:\n\n- *\"Find the nearest hospital to Connaught Place, New Delhi\"*\n- *\"What's the address at 28.6139, 77.2090?\"*\n- *\"Get driving directions from Bandra to Andheri\"*\n- *\"Is pincode 400001 valid? What area is it?\"*\n- *\"How far is Delhi from Mumbai in a straight line?\"*\n- *\"What is the elevation of Shimla?\"*\n- *\"Find ATMs along the route from India Gate to Qutub Minar\"*\n- *\"Standardize this address: 237 Okhla Industrial Phase 3 ND 110020\"*\n- *\"Search for Domino's near Koramangala Bangalore\"*\n\n---\n\n## Notes\n\n- All tools accept **lat/lng in decimal degrees** (e.g. `28.6139, 77.2090`)\n- Routing tools use **lat,lng format** for input (the server handles coordinate conversion internally)\n- `nearby_search` uses plain keywords like `\"hospital\"`, `\"atm\"`, `\"restaurant\"` — Mappls maps these to category codes automatically\n- `poi_along_route` requires the encoded polyline from the `geometry` field of a `get_directions` response\n- `still_map_image` returns a URL — the image is a PNG map tile\n\n## License\n\nMIT — built by [AmanMakesStuff](https://github.com/AmanMakesStuff)\n",
  "bytes": 4586,
  "sha": "035b150f4c86a2c22248e23ca4dafa987f5e476c94bf6f6d41f5b8045daf67df",
  "repo_slug": "amanmakesstuff/mappls-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_amanmakesstuff_mappls_mcp_aa622c7f/readme"
}