Skip to main content
Glama
quanta-route-geocoder

quanta-route-geocoder

by mapdevsaikat
README.md
# @quantaroute/mcp-server

MCP server and REST wrapper for the [QuantaRoute](https://quantaroute.com) geocoding API (India). Geocode addresses, reverse-geocode DigiPin, and look up administrative boundaries.

## First step: Get an `API key` at [developers.quantaroute.com](https://developers.quantaroute.com).

| | |
|---|---|
| npm | [`@quantaroute/mcp-server`](https://www.npmjs.com/package/@quantaroute/mcp-server) **1.2.0** |
| MCP Registry | [`io.github.mapdevsaikat/quantaroute-geocoder`](https://registry.modelcontextprotocol.io/?q=quantaroute) |


## MCP (Claude Desktop, Cursor)

Add to Claude Desktop (`claude_desktop_config.json`) or Cursor (`~/.cursor/mcp.json`), then restart. Requires Node.js 18+ and `npx`.

**Local process** (MCP stdio):

```json
{
  "mcpServers": {
    "quantaroute": {
      "command": "npx",
      "args": ["-y", "@quantaroute/mcp-server"],
      "env": {
        "QUANTAROUTE_API_KEY": "your-api-key"
      }
    }
  }
}
```

### Tools

| Tool | What it does |
|---|---|
| `geocode` | Address → DigiPin + coordinates. Optional `latitude` + `longitude` bias local results and enable “near me” queries (`hospital near me`). |
| `autocomplete` | Address suggestions (`query` ≥ 3 chars). Same optional point as `lat`/`lng` on REST. |
| `reverse_geocode` | DigiPin → address + coordinates |
| `coordinates_to_digipin` | Lat/lng → DigiPin |
| `validate_digipin` | Check DigiPin format / existence |
| `batch_geocode` | Up to 100 addresses |
| `lookup_location_from_coordinates` | Lat/lng → pincode, state, division, locality |
| `lookup_location_from_digipin` | DigiPin → the same |
| `batch_location_lookup` | Up to 100 locations (each coords **or** DigiPin) |
| `get_usage` / `get_location_statistics` / `get_health` | Quota, coverage stats, health |

`find_nearby_boundaries` is listed but **not implemented**. Use `geocode` or `autocomplete` with a point for category nearby.

## REST

Same host: `https://mcp-gc.quantaroute.com/api`. Header `x-api-key`, or `QUANTAROUTE_API_KEY` on the server. Paths match the tools (`POST /api/geocode`, `GET /api/autocomplete?q=…&lat=&lng=`, …). Missing key → **401**. Full list: [docs/API.md](docs/API.md).

## Develop

```bash
npm install
npm run build
QUANTAROUTE_API_KEY=your-key npm start
```

Upstream API: [api.quantaroute.com](https://api.quantaroute.com/v1/digipin/docs) · Issues: [GitHub](https://github.com/mapdevsaikat/quantaroute-geocoder/issues) · License: MIT

TDQS

B3.3/5.0

Scored across 13 tools

Disambiguation4/5

Most tools have distinct purposes: geocode handles addresses, reverse_geocode handles DigiPins, and lookup_location_* handles administrative boundaries. Some pairs share inputs (e.g., coordinates_to_digipin vs lookup_location_from_coordinates) and could be confused, but descriptions clarify the different outputs.

Naming Consistency3/5

The naming mixes verb-first patterns (geocode, validate_digipin, get_usage) with noun-first phrases (coordinates_to_digipin, batch_location_lookup) and varied verbs (get, lookup, find). While readable, the lack of a uniform convention makes the set feel inconsistent.

Tool Count4/5

13 tools is reasonable for a geocoding service covering geocoding, reverse geocoding, batch operations, autocomplete, validation, and administrative boundaries. The count is slightly inflated by the unimplemented find_nearby_boundaries tool and multiple meta endpoints, but overall well-scoped.

Completeness4/5

The core geocoding/reverse geocoding lifecycle is covered, including batch and autocomplete operations, plus administrative boundary lookups. Minor gaps include the missing nearby-boundaries functionality and no batch reverse geocoding from DigiPins to addresses, but these are workable or explicitly marked.

Maintenance

ActivityNo data
ResponsivenessOutdated data