MCP.so
Sign In
A

AMap Maps (高德地图) MCP ServerVerified

@AMap Open Platform

Basic information

Transport

streamable-http

Authentication

API Key

Last updated

Author

AMap Open Platform

About AMap Maps (高德地图) MCP Server

Official AMap (高德地图) MCP server from the AMap Open Platform. Hosted Streamable HTTP endpoint (https://mcp.amap.com/mcp?key=...) or the npm stdio package @amap/amap-maps-mcp-server. Tools: geocoding, reverse geocoding, IP location, weather, cycling/walking/driving/transit routes, distance, keyword/nearby/detail POI search; the hosted endpoint adds custom trip maps, navigation and ride-hailing deep links into the AMap app. Requires an AMap Web Service key.

Connection details

https://mcp.amap.com/mcp?key=YOUR_AMAP_KEY

Setup

claude mcp add amap-maps-streamableHTTP --transport http https://mcp.amap.com/mcp?key=YOUR_AMAP_KEY

AMap Maps (高德地图) MCP Server tools

12

Geocoding: convert a structured address (optionally with a city) into AMap coordinates.

Reverse geocoding: convert AMap coordinates into province, city, district and address details.

Locate an IP address to its province, city and adcode.

Current and forecast weather for a city name or adcode.

Cycling route planning up to 500 km, accounting for overpasses, one-way streets and closures.

Walking route planning within 100 km.

Driving route planning for passenger cars.

Public transit route planning across trains, buses and metro; cross-city trips need origin and destination cities.

Measure distance and travel time between two coordinates.

Keyword POI search, optionally within a city.

POI search by keyword around a coordinate within a radius.

Details for a POI ID from a keyword or nearby search: location, address, business area, city, type.

Overview

What the AMap MCP Server is

AMap (高德地图, Gaode Maps) publishes an official MCP server through the AMap Open Platform. It gives Claude, Cursor, Cline and any other MCP client fresh location data for China: geocoding and reverse geocoding, IP location, weather, cycling, walking, driving and public-transit route planning, distance measurement, and keyword, nearby and detail POI search.

It is aimed at developers building travel assistants and trip planners. Since the May 2025 upgrade the hosted server also connects to the AMap mobile app: a trip plan written by the model can be turned into a private "custom map" in the app, and the server returns deep links that start navigation or a ride-hailing request. AMap recommends the hosted Streamable HTTP endpoint; the npm package @amap/amap-maps-mcp-server (stdio) remains available.

What it does

  • Geocoding (maps_geo), reverse geocoding (maps_regeocode) and IP location (maps_ip_location)
  • Weather by city name or adcode (maps_weather)
  • Route planning: cycling up to 500 km, walking up to 100 km, driving, and integrated public transit (maps_bicycling, maps_direction_walking, maps_direction_driving, maps_direction_transit_integrated), plus maps_distance
  • POI search by keyword, around a point, and POI details (maps_text_search, maps_around_search, maps_search_detail)
  • Hosted endpoint only: generate a custom trip map in the AMap app, a navigation deep link to a destination, and a ride-hailing deep link between two points

Setup

  1. Sign in to the AMap Open Platform console (register as a developer if needed), open App management, create an app, then Add Key with the service platform set to Web Service.
  2. Add the hosted server to your MCP client (recommended):
{
  "mcpServers": {
    "amap-maps-streamableHTTP": {
      "url": "https://mcp.amap.com/mcp?key=YOUR_AMAP_KEY"
    }
  }
}
  1. Or run the stdio package locally (AMap recommends Node.js v22.14.0 or later and the default npm registry):
{
  "mcpServers": {
    "amap-maps": {
      "command": "npx",
      "args": ["-y", "@amap/amap-maps-mcp-server"],
      "env": { "AMAP_MAPS_API_KEY": "YOUR_AMAP_KEY" }
    }
  }
}
  1. Check the tool list in your client's MCP settings, switch the chat to agent mode and ask for something concrete, such as a two-day itinerary with walking routes between stops.

Requirements and limits

  • Needs an AMap Web Service key. Requests run against your key, so its quota and AMap's pricing apply; check them in the console. The key sits in the URL or environment, so keep it out of shared configs and repositories.
  • Coordinates are AMap (GCJ-02) coordinates and the data focuses on China; cross-city transit queries need both city names.
  • The custom map, navigation and ride-hailing tools return deep links into the AMap app; the user still opens the app and confirms. They are not part of the npm package.
  • The npm package was last published as 0.0.8 (April 2025); new capabilities land on the hosted endpoint.

FAQ

Is this the official AMap server? Yes. The docs live on lbs.amap.com and the npm package is published under the @amap scope by AMap Open Platform. Many community AMap servers on MCP.so wrap the same Web Service APIs.

Streamable HTTP or npx? AMap recommends Streamable HTTP: nothing to install, and the app hand-off tools are only available there. Use npx if your client only supports stdio.

Can it book or pay for a ride? No. It returns a deep link that opens AMap's ride-hailing flow; ordering and payment happen in the app.

Sources: AMap MCP Server overview, Quick start, Create an app and key, npm @amap/amap-maps-mcp-server. Checked 2026-11-14.

Frequently asked questions

1

What is the AMap Maps (高德地图) remote MCP server?

The AMap Maps (高德地图) remote MCP server is a hosted Model Context Protocol endpoint at https://mcp.amap.com/mcp?key=YOUR_AMAP_KEY, so AI assistants can connect to it without installing or running anything locally.

2

How do I connect to the AMap Maps (高德地图) MCP server?

Add the endpoint https://mcp.amap.com/mcp?key=YOUR_AMAP_KEY to any MCP-compatible client such as Claude Code, Cursor, or VS Code. The setup snippets on this page configure each client in one step.

3

Does the AMap Maps (高德地图) MCP server require authentication?

Yes. AMap Maps (高德地图) requires an API key — check the official documentation for how to obtain one, then include it in your client's configuration.

4

Which transport does the AMap Maps (高德地图) MCP server use?

AMap Maps (高德地图) exposes a streamable-http endpoint, the transport used by remote MCP servers and supported by all major MCP clients.

Comments