GrabMaps MCP Server provides integration with GrabMaps geocoding, routing, and place search services across eight Southeast Asian countries via AWS Location Service. Key features: - Forward geocoding to find coordinates from place names or addresses - Reverse geocoding to retrieve location details from coordinates - Autocomplete suggestions for place searches as you type - Route calculation between points with support for waypoints - Route matrix calculation for multiple origins and destinations - Detailed place information retrieval - Built-in analytics and monitoring with Firebase integration, local backups, and a real-time dashboard for tracking API usage and MCP tool calls - Coverage limited to Malaysia, Singapore, Thailand, Myanmar, Cambodia, Vietnam, Philippines, and Indonesia Note: Map rendering requires access to the AWS Location Service console; the MCP server provides data and query access only.

GrabMaps MCP Server

A Model Context Protocol (MCP) server for GrabMaps API integration, providing access to GrabMaps services through AWS Location Service.

Do note that this MCP server is NOT officially affiliated with Grab, GrabMaps, or AWS Location Service.

> Important: GrabMaps only supports eight countries in Southeast Asia. > > - 🇲🇾 Malaysia (MYS) > - 🇸🇬 Singapore (SGP) > - 🇹🇭 Thailand (THA) > - 🇲🇲 Myanmar (MMR) > - 🇰🇭 Cambodia (KHM) > - 🇻🇳 Vietnam (VNM) > - 🇵🇭 Philippines (PHL) > - 🇮🇩 Indonesia (IDN) > > Search requests outside these countries will not return accurate results.

Features

This MCP server provides access to GrabMaps functionality through two main categories:

Places Actions (Available via MCP)

Routes Actions (Available via MCP)

Analytics & Monitoring

Maps Functionality (Requires AWS Console)

1. Go to the AWS Location Service console 2. Look for the Maps section and click the "Try it" button 3. Ensure "Grab" is selected as the provider

To explore GrabMaps data coverage and see the maps in action without logging in to AWS, visit: https://grabmaps.grab.com/explore-data-coverage

Installation

From NPM

npm install mcp-grabmaps

From Source

git clone https://github.com/hithereiamaliff/mcp-grabmaps.git
cd mcp-grabmaps
npm install

Configuration

Create a .env file in the root directory with the following variables:

# GrabMaps API credentials
GRABMAPS_API_KEY=your_grabmaps_api_key_here
AWS credentials for AWS Location Service
AWS_ACCESS_KEY_ID=your_aws_access_key_id_here
AWS_SECRET_ACCESS_KEY=your_aws_secret_access_key_here
AWS_REGION=ap-southeast-5  # Default region for Malaysia (ap-southeast-1 for Singapore)
Place Index name (default for GrabMaps)
PLACE_INDEX_NAME=explore.place.Grab
Map name (for rendering maps)
MAP_NAME=explore.map.Grab
Route calculator name
ROUTE_CALCULATOR_NAME=explore.route-calculator.Grab
Server port
PORT=3000

Usage

Method 1: Running Locally

# Development mode
npm run dev
Production mode
npm run build
npm start

Method 2: Using with Smithery

# Run in development mode
npm run smithery:dev
Build for production
npm run smithery:build
Deploy to Smithery
npm run smithery:deploy

#### Testing in Smithery Playground

For the best experience testing Places and Routes APIs, we recommend using the Smithery playground:

1. Start your MCP server locally: npm run dev 2. Open the Smithery playground at: https://smithery.ai/playground 3. Connect to your local MCP server: http://localhost:3000 4. Test Places and Routes API calls using the provided examples in SMITHERY_TESTING.md

Method 3: Self-Hosted VPS Deployment

Deploy the MCP server on your own VPS with Docker and Nginx. This method supports per-user credentials via URL query parameters, allowing multiple users to connect with their own GrabMaps and AWS credentials.

#### VPS URL Format

https://mcp.techmavie.digital/grabmaps/mcp?grabMapsApiKey=YOUR_KEY&awsAccessKeyId=YOUR_AWS_KEY&awsSecretAccessKey=YOUR_AWS_SECRET

Query Parameters:

| Parameter | Required | Description | Example | |-----------|----------|-------------|---------| | grabMapsApiKey | ✅ Yes | Your GrabMaps API key | your-grabmaps-api-key | | awsAccessKeyId | ✅ Yes | Your AWS Access Key ID | AKIAIOSFODNN7EXAMPLE | | awsSecretAccessKey | ✅ Yes | Your AWS Secret Access Key | wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY | | awsRegion | ❌ No | AWS Region (default: ap-southeast-5) | ap-southeast-1 |

#### Client Configuration

Claude Desktop:

{
  "mcpServers": {
    "grabmaps": {
      "transport": "streamable-http",
      "url": "https://mcp.techmavie.digital/grabmaps/mcp?grabMapsApiKey=YOUR_KEY&awsAccessKeyId=YOUR_AWS_KEY&awsSecretAccessKey=YOUR_AWS_SECRET"
    }
  }
}

Cursor/Windsurf: Same format in their MCP configuration files.

#### Live Demo

A