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
- 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.
- Add the hosted server to your MCP client (recommended):
{
"mcpServers": {
"amap-maps-streamableHTTP": {
"url": "https://mcp.amap.com/mcp?key=YOUR_AMAP_KEY"
}
}
}
- 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" }
}
}
}
- 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.
Comments