@quantaroute/mcp-server 1.0.0

package/dist/api/[...path].js

@@ -0,0 +1,368 @@
+import { QuantaRouteClient } from '../src/client.js';
+// CORS headers
+const corsHeaders = {
+    'Access-Control-Allow-Origin': '*',
+    'Access-Control-Allow-Methods': 'GET, POST, OPTIONS',
+    'Access-Control-Allow-Headers': 'Content-Type, Authorization, x-api-key',
+    'Content-Type': 'application/json',
+};
+// Helper to send JSON response
+function sendJson(res, status, data) {
+    Object.entries(corsHeaders).forEach(([key, value]) => {
+        res.setHeader(key, value);
+    });
+    res.status(status).json(data);
+}
+// Helper to handle errors
+function handleError(res, error, status = 500) {
+    console.error('API Error:', error);
+    // Determine status code from error message
+    if (error.message?.includes('Authentication failed')) {
+        status = 401;
+    }
+    else if (error.message?.includes('Rate limit exceeded')) {
+        status = 429;
+    }
+    else if (error.message?.includes('required') || error.message?.includes('must be')) {
+        status = 400;
+    }
+    sendJson(res, status, {
+        error: error.message || 'Internal server error',
+        success: false,
+    });
+}
+// Get API key from request headers or environment
+function getApiKey(req) {
+    // Priority: Request header > Environment variable
+    const headerKey = req.headers['x-api-key'];
+    const envKey = process.env.QUANTAROUTE_API_KEY;
+    if (headerKey) {
+        return headerKey;
+    }
+    if (envKey) {
+        return envKey;
+    }
+    throw new Error('API key is required. Set QUANTAROUTE_API_KEY environment variable or provide x-api-key header');
+}
+// Create client instance with API key
+function createClient(req) {
+    const apiKey = getApiKey(req);
+    return new QuantaRouteClient(apiKey);
+}
+// Handle CORS preflight
+function handleCors(req, res) {
+    if (req.method === 'OPTIONS') {
+        Object.entries(corsHeaders).forEach(([key, value]) => {
+            res.setHeader(key, value);
+        });
+        res.status(200).end();
+        return true;
+    }
+    return false;
+}
+export default async function handler(req, res) {
+    // Handle CORS preflight
+    if (handleCors(req, res)) {
+        return;
+    }
+    const { method, query, body } = req;
+    const path = query.path || [];
+    const endpoint = path[0] || '';
+    try {
+        // Create client instance with API key from request or environment
+        const client = createClient(req);
+        // Health check
+        if (endpoint === 'health' && method === 'GET') {
+            const result = await client.getHealth();
+            return sendJson(res, 200, { success: true, data: result });
+        }
+        // Get usage statistics
+        if (endpoint === 'usage' && method === 'GET') {
+            const result = await client.getUsage();
+            return sendJson(res, 200, { success: true, data: result });
+        }
+        // Get location statistics
+        if (endpoint === 'location-statistics' && method === 'GET') {
+            const result = await client.getLocationStatistics();
+            return sendJson(res, 200, { success: true, data: result });
+        }
+        // Geocode
+        if (endpoint === 'geocode' && method === 'POST') {
+            if (!body || !body.address) {
+                return sendJson(res, 400, {
+                    success: false,
+                    error: 'Address is required',
+                });
+            }
+            const result = await client.geocode(body);
+            return sendJson(res, 200, { success: true, data: result });
+        }
+        // Reverse geocode
+        if (endpoint === 'reverse-geocode' && method === 'POST') {
+            if (!body || !body.digipin) {
+                return sendJson(res, 400, {
+                    success: false,
+                    error: 'DigiPin is required',
+                });
+            }
+            const result = await client.reverseGeocode(body.digipin);
+            return sendJson(res, 200, { success: true, data: result });
+        }
+        // Coordinates to DigiPin
+        if (endpoint === 'coordinates-to-digipin' && method === 'POST') {
+            if (typeof body?.latitude !== 'number' || typeof body?.longitude !== 'number') {
+                return sendJson(res, 400, {
+                    success: false,
+                    error: 'Latitude and longitude are required and must be numbers',
+                });
+            }
+            if (body.latitude < -90 || body.latitude > 90) {
+                return sendJson(res, 400, {
+                    success: false,
+                    error: 'Latitude must be between -90 and 90',
+                });
+            }
+            if (body.longitude < -180 || body.longitude > 180) {
+                return sendJson(res, 400, {
+                    success: false,
+                    error: 'Longitude must be between -180 and 180',
+                });
+            }
+            const result = await client.coordinatesToDigiPin(body.latitude, body.longitude);
+            return sendJson(res, 200, { success: true, data: result });
+        }
+        // Validate DigiPin (GET method with query parameter)
+        if (endpoint === 'validate-digipin') {
+            if (method === 'GET') {
+                const digipin = query.digipin;
+                if (!digipin) {
+                    return sendJson(res, 400, {
+                        success: false,
+                        error: 'DigiPin query parameter is required',
+                    });
+                }
+                const result = await client.validateDigiPin(digipin);
+                return sendJson(res, 200, { success: true, data: result });
+            }
+            // Also support POST for consistency
+            if (method === 'POST') {
+                if (!body || !body.digipin) {
+                    return sendJson(res, 400, {
+                        success: false,
+                        error: 'DigiPin is required',
+                    });
+                }
+                const result = await client.validateDigiPin(body.digipin);
+                return sendJson(res, 200, { success: true, data: result });
+            }
+        }
+        // Batch geocode
+        if (endpoint === 'batch-geocode' && method === 'POST') {
+            if (!body || !Array.isArray(body.addresses) || body.addresses.length === 0) {
+                return sendJson(res, 400, {
+                    success: false,
+                    error: 'Addresses must be a non-empty array',
+                });
+            }
+            if (body.addresses.length > 100) {
+                return sendJson(res, 400, {
+                    success: false,
+                    error: 'Maximum 100 addresses allowed per batch',
+                });
+            }
+            const result = await client.batchGeocode(body.addresses);
+            return sendJson(res, 200, { success: true, data: result });
+        }
+        // Autocomplete
+        if (endpoint === 'autocomplete' && method === 'GET') {
+            const queryParam = req.query.q;
+            const limit = req.query.limit ? parseInt(req.query.limit, 10) : 5;
+            if (!queryParam || queryParam.length < 3) {
+                return sendJson(res, 400, {
+                    success: false,
+                    error: 'Query parameter "q" must be at least 3 characters long',
+                });
+            }
+            if (limit > 10) {
+                return sendJson(res, 400, {
+                    success: false,
+                    error: 'Limit cannot exceed 10',
+                });
+            }
+            const result = await client.autocomplete(queryParam, limit);
+            return sendJson(res, 200, { success: true, data: result });
+        }
+        // Lookup location from coordinates
+        if (endpoint === 'lookup-location-from-coordinates' && method === 'POST') {
+            if (typeof body?.latitude !== 'number' || typeof body?.longitude !== 'number') {
+                return sendJson(res, 400, {
+                    success: false,
+                    error: 'Latitude and longitude are required and must be numbers',
+                });
+            }
+            if (body.latitude < -90 || body.latitude > 90) {
+                return sendJson(res, 400, {
+                    success: false,
+                    error: 'Latitude must be between -90 and 90',
+                });
+            }
+            if (body.longitude < -180 || body.longitude > 180) {
+                return sendJson(res, 400, {
+                    success: false,
+                    error: 'Longitude must be between -180 and 180',
+                });
+            }
+            const result = await client.lookupLocationFromCoordinates(body.latitude, body.longitude);
+            return sendJson(res, 200, { success: true, data: result });
+        }
+        // Lookup location from DigiPin
+        if (endpoint === 'lookup-location-from-digipin' && method === 'POST') {
+            if (!body || !body.digipin) {
+                return sendJson(res, 400, {
+                    success: false,
+                    error: 'DigiPin is required',
+                });
+            }
+            const result = await client.lookupLocationFromDigiPin(body.digipin);
+            return sendJson(res, 200, { success: true, data: result });
+        }
+        // Batch location lookup
+        if (endpoint === 'batch-location-lookup' && method === 'POST') {
+            if (!body || !Array.isArray(body.locations) || body.locations.length === 0) {
+                return sendJson(res, 400, {
+                    success: false,
+                    error: 'Locations must be a non-empty array',
+                });
+            }
+            if (body.locations.length > 100) {
+                return sendJson(res, 400, {
+                    success: false,
+                    error: 'Maximum 100 locations allowed per batch',
+                });
+            }
+            const result = await client.batchLocationLookup(body.locations);
+            return sendJson(res, 200, { success: true, data: result });
+        }
+        // Find nearby boundaries
+        if (endpoint === 'find-nearby-boundaries' && method === 'POST') {
+            if (typeof body?.latitude !== 'number' || typeof body?.longitude !== 'number') {
+                return sendJson(res, 400, {
+                    success: false,
+                    error: 'Latitude and longitude are required and must be numbers',
+                });
+            }
+            if (body.latitude < -90 || body.latitude > 90) {
+                return sendJson(res, 400, {
+                    success: false,
+                    error: 'Latitude must be between -90 and 90',
+                });
+            }
+            if (body.longitude < -180 || body.longitude > 180) {
+                return sendJson(res, 400, {
+                    success: false,
+                    error: 'Longitude must be between -180 and 180',
+                });
+            }
+            const radius_km = typeof body.radius_km === 'number' ? body.radius_km : 5.0;
+            const limit = typeof body.limit === 'number' ? body.limit : 10;
+            if (radius_km > 100) {
+                return sendJson(res, 400, {
+                    success: false,
+                    error: 'Radius cannot exceed 100 km',
+                });
+            }
+            if (limit > 50) {
+                return sendJson(res, 400, {
+                    success: false,
+                    error: 'Limit cannot exceed 50',
+                });
+            }
+            const result = await client.findNearbyBoundaries(body.latitude, body.longitude, radius_km, limit);
+            return sendJson(res, 200, { success: true, data: result });
+        }
+        // Root endpoint - show API documentation
+        if (endpoint === '' && method === 'GET') {
+            return sendJson(res, 200, {
+                success: true,
+                message: 'QuantaRoute Geocoder REST API',
+                version: '1.0.0',
+                documentation: 'https://github.com/mapdevsaikat/quantaroute-geocoder',
+                authentication: {
+                    method: 'API Key',
+                    header: 'x-api-key',
+                    env: 'QUANTAROUTE_API_KEY',
+                    note: 'API key can be provided via x-api-key header or QUANTAROUTE_API_KEY environment variable',
+                },
+                endpoints: {
+                    'GET /api': 'Get API information (this endpoint)',
+                    'GET /api/health': 'Check API health status',
+                    'GET /api/usage': 'Get API usage statistics',
+                    'GET /api/location-statistics': 'Get location service statistics',
+                    'GET /api/autocomplete?q=query&limit=5': 'Get address autocomplete suggestions (min 3 chars)',
+                    'GET /api/validate-digipin?digipin=XXX-XXX-XXXX': 'Validate a DigiPin code',
+                    'POST /api/geocode': 'Geocode an address to get DigiPin and coordinates',
+                    'POST /api/reverse-geocode': 'Reverse geocode a DigiPin to get address',
+                    'POST /api/coordinates-to-digipin': 'Convert coordinates to DigiPin',
+                    'POST /api/validate-digipin': 'Validate a DigiPin code (alternative to GET)',
+                    'POST /api/batch-geocode': 'Geocode multiple addresses (up to 100)',
+                    'POST /api/lookup-location-from-coordinates': 'Get administrative boundaries from coordinates',
+                    'POST /api/lookup-location-from-digipin': 'Get administrative boundaries from DigiPin',
+                    'POST /api/batch-location-lookup': 'Batch lookup for multiple locations (up to 100)',
+                    'POST /api/find-nearby-boundaries': 'Find nearby postal boundaries within a radius',
+                },
+                examples: {
+                    geocode: {
+                        method: 'POST',
+                        url: '/api/geocode',
+                        headers: { 'Content-Type': 'application/json', 'x-api-key': 'your-api-key' },
+                        body: {
+                            address: '123 Main Street, New Delhi',
+                            city: 'New Delhi',
+                            state: 'Delhi',
+                            pincode: '110001',
+                        },
+                    },
+                    reverseGeocode: {
+                        method: 'POST',
+                        url: '/api/reverse-geocode',
+                        headers: { 'Content-Type': 'application/json', 'x-api-key': 'your-api-key' },
+                        body: { digipin: 'ABC-DEF-1234' },
+                    },
+                    autocomplete: {
+                        method: 'GET',
+                        url: '/api/autocomplete?q=New Delhi&limit=5',
+                        headers: { 'x-api-key': 'your-api-key' },
+                    },
+                },
+            });
+        }
+        // 404 for unknown endpoints
+        return sendJson(res, 404, {
+            success: false,
+            error: 'Endpoint not found',
+            endpoint: endpoint || '(root)',
+            method: method,
+            availableEndpoints: [
+                'GET /api',
+                'GET /api/health',
+                'GET /api/usage',
+                'GET /api/location-statistics',
+                'GET /api/autocomplete?q=query&limit=5',
+                'GET /api/validate-digipin?digipin=XXX-XXX-XXXX',
+                'POST /api/geocode',
+                'POST /api/reverse-geocode',
+                'POST /api/coordinates-to-digipin',
+                'POST /api/validate-digipin',
+                'POST /api/batch-geocode',
+                'POST /api/lookup-location-from-coordinates',
+                'POST /api/lookup-location-from-digipin',
+                'POST /api/batch-location-lookup',
+                'POST /api/find-nearby-boundaries',
+            ],
+        });
+    }
+    catch (error) {
+        handleError(res, error);
+    }
+}
+//# sourceMappingURL=%5B...path%5D.js.map

package/dist/api/[...path].js.map

@@ -0,0 +1 @@
+{"version":3,"file":"[...path].js","sourceRoot":"","sources":["../../api/[...path].ts"],"names":[],"mappings":"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"}

package/dist/client.d.ts

@@ -0,0 +1,45 @@
+interface GeocodeParams {
+    address: string;
+    city?: string;
+    state?: string;
+    pincode?: string;
+    country?: string;
+}
+interface BatchGeocodeParams {
+    addresses: Array<{
+        address: string;
+        city?: string;
+        state?: string;
+        pincode?: string;
+        country?: string;
+    }>;
+}
+interface BatchLocationParams {
+    locations: Array<{
+        latitude?: number;
+        longitude?: number;
+        digipin?: string;
+    }>;
+}
+export declare class QuantaRouteClient {
+    private client;
+    private apiKey;
+    private baseUrl;
+    constructor(apiKey?: string, baseUrl?: string);
+    private makeRequest;
+    geocode(params: GeocodeParams): Promise<any>;
+    reverseGeocode(digipin: string): Promise<any>;
+    coordinatesToDigiPin(latitude: number, longitude: number): Promise<any>;
+    validateDigiPin(digipin: string): Promise<any>;
+    batchGeocode(addresses: BatchGeocodeParams['addresses']): Promise<any>;
+    autocomplete(query: string, limit?: number): Promise<any>;
+    lookupLocationFromCoordinates(latitude: number, longitude: number): Promise<any>;
+    lookupLocationFromDigiPin(digipin: string): Promise<any>;
+    batchLocationLookup(locations: BatchLocationParams['locations']): Promise<any>;
+    findNearbyBoundaries(latitude: number, longitude: number, radius_km?: number, limit?: number): Promise<any>;
+    getUsage(): Promise<any>;
+    getLocationStatistics(): Promise<any>;
+    getHealth(): Promise<any>;
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,kBAAkB;IAC1B,SAAS,EAAE,KAAK,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ;AAED,UAAU,mBAAmB;IAC3B,SAAS,EAAE,KAAK,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,MAAsC;YAsB9D,WAAW;IA0BnB,OAAO,CAAC,MAAM,EAAE,aAAa;IAa7B,cAAc,CAAC,OAAO,EAAE,MAAM;IAK9B,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAQxD,eAAe,CAAC,OAAO,EAAE,MAAM;IAK/B,YAAY,CAAC,SAAS,EAAE,kBAAkB,CAAC,WAAW,CAAC;IAKvD,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU;IAQ7C,6BAA6B,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAQjE,yBAAyB,CAAC,OAAO,EAAE,MAAM;IAKzC,mBAAmB,CAAC,SAAS,EAAE,mBAAmB,CAAC,WAAW,CAAC;IAK/D,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,EAAE,KAAK,GAAE,MAAW;IAUrG,QAAQ;IAKR,qBAAqB;IAKrB,SAAS;CAIhB"}

package/dist/client.js

@@ -0,0 +1,127 @@
+import axios from 'axios';
+export class QuantaRouteClient {
+    client;
+    apiKey;
+    baseUrl;
+    constructor(apiKey, baseUrl = 'https://api.quantaroute.com') {
+        this.apiKey = apiKey || process.env.QUANTAROUTE_API_KEY || '';
+        this.baseUrl = baseUrl;
+        this.client = axios.create({
+            baseURL: this.baseUrl,
+            timeout: 30000,
+            headers: {
+                'Content-Type': 'application/json',
+                'User-Agent': '@quantaroute/mcp-server/1.0.0',
+            },
+        });
+        // Set API key interceptor if provided
+        if (this.apiKey) {
+            this.client.interceptors.request.use((config) => {
+                config.headers['x-api-key'] = this.apiKey;
+                return config;
+            });
+        }
+    }
+    async makeRequest(method, endpoint, data, params) {
+        try {
+            const response = await this.client.request({
+                method,
+                url: endpoint,
+                data,
+                params,
+            });
+            return response.data;
+        }
+        catch (error) {
+            if (error.response) {
+                const status = error.response.status;
+                const message = error.response.data?.message || error.message;
+                if (status === 401) {
+                    throw new Error(`Authentication failed: ${message}`);
+                }
+                if (status === 429) {
+                    throw new Error(`Rate limit exceeded: ${message}`);
+                }
+                throw new Error(`API error (${status}): ${message}`);
+            }
+            throw new Error(`Request failed: ${error.message}`);
+        }
+    }
+    async geocode(params) {
+        const data = {
+            address: params.address,
+            country: params.country || 'India',
+        };
+        if (params.city)
+            data.city = params.city;
+        if (params.state)
+            data.state = params.state;
+        if (params.pincode)
+            data.pincode = params.pincode;
+        const response = await this.makeRequest('POST', '/v1/digipin/geocode', data);
+        return response.data || response;
+    }
+    async reverseGeocode(digipin) {
+        const response = await this.makeRequest('POST', '/v1/digipin/reverse', { digipin });
+        return response.data || response;
+    }
+    async coordinatesToDigiPin(latitude, longitude) {
+        const response = await this.makeRequest('POST', '/v1/digipin/coordinates-to-digipin', {
+            latitude,
+            longitude,
+        });
+        return response.data || response;
+    }
+    async validateDigiPin(digipin) {
+        const response = await this.makeRequest('GET', `/v1/digipin/validate/${digipin}`);
+        return response.data || response;
+    }
+    async batchGeocode(addresses) {
+        const response = await this.makeRequest('POST', '/v1/digipin/batch', { addresses });
+        return response.data || response;
+    }
+    async autocomplete(query, limit = 5) {
+        const response = await this.makeRequest('GET', '/v1/digipin/autocomplete', undefined, {
+            q: query,
+            limit: Math.min(limit, 10),
+        });
+        return response.data || response;
+    }
+    async lookupLocationFromCoordinates(latitude, longitude) {
+        const response = await this.makeRequest('POST', '/v1/location/lookup', {
+            latitude,
+            longitude,
+        });
+        return response.data || response;
+    }
+    async lookupLocationFromDigiPin(digipin) {
+        const response = await this.makeRequest('POST', '/v1/location/lookup', { digipin });
+        return response.data || response;
+    }
+    async batchLocationLookup(locations) {
+        const response = await this.makeRequest('POST', '/v1/location/batch-lookup', { locations });
+        return response.data || response;
+    }
+    async findNearbyBoundaries(latitude, longitude, radius_km = 5.0, limit = 10) {
+        const response = await this.makeRequest('GET', '/v1/location/nearby', undefined, {
+            lat: latitude,
+            lng: longitude,
+            radius: radius_km,
+            limit: Math.min(limit, 50),
+        });
+        return response.data || response;
+    }
+    async getUsage() {
+        const response = await this.makeRequest('GET', '/v1/digipin/usage');
+        return response.data || response;
+    }
+    async getLocationStatistics() {
+        const response = await this.makeRequest('GET', '/v1/location/stats');
+        return response.data || response;
+    }
+    async getHealth() {
+        const response = await this.makeRequest('GET', '/health');
+        return response.data || response;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * QuantaRoute Geocoder MCP Server
+ *
+ * Provides MCP tools for geocoding addresses, location lookups, and DigiPin processing
+ * using the QuantaRoute Geocoding API.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG"}