Amap fully integrates the MCP protocol: the first year of seamless collaboration between AI agents and geographic services begins!

Written by
Jasper Cole
Updated on:July-09th-2025
Recommendation

Core content:
1. Amap supports the MCP protocol to promote the integration of AI and geographic services
2. MCP Server integrates Amap services to simplify the developer calling process
3. Analysis of the technical architecture and core capabilities of Amap MCP adaptation

Amap fully embraces the MCP protocol, opening a new era of seamless collaboration between AI agents and geographic services. Developers will be able to easily build an intelligent, cross-modal map application ecosystem.

Yang Fangxian
Founder of 53AI/Most Valuable Expert of Tencent Cloud (TVP)

Recently, Amap officially announced its support for Model Context Protocol (MCP) , which marks the deep integration of location-based services (LBS) and AI intelligent agent development in the map industry.

Developers can use MCP's unified interface to quickly call on Amap's core capabilities such as positioning, navigation, and POI retrieval to build a smarter and more dynamic cross-modal application ecosystem.


Introduction to Amap MCP Server

Amap MCP Server is a standardized map service capability platform built based on the MCP protocol (Model Context Protocol).

It integrates the map services and intelligent algorithms of Amap's open platform, condenses them into a simple and easy-to-use map service interface, and provides full-scenario map service solutions for enterprises and developers.

The addition of Amap has injected the key dimension of location intelligence into the MCP ecosystem . Developers can use the MCP interface to implement the following functions without having to deeply understand the technical details of the map API:

  • Real-time path planning and traffic status analysis;

  • Geofence-triggered incident response;

  • Fusion processing of multimodal data (such as speech, images) and spatial information .



MCP Adaptation of Amap: Technical Architecture and Core Capabilities


1. API lightweight packaging

Amap has deeply adapted the MCP protocol based on its mature JavaScript API (versions 1.3 to 2.0):

  • Interface standardization : encapsulate high-frequency functions such as map initialization, marker drawing, and path planning into MCP-compatible RESTful endpoints;

  • Dynamic layer management : support real-time adding/removing 3D map controls (such as eagle eye, scale) through MCP commands ;

  • Event penetration mechanism : solve common problems in web frameworks (such as React)AMap is undefinedThe problem is to ensure the stable calling of the intelligent agent in a multi-platform environment .


2. Enhanced multimodal interaction

Through the context synchronization capability of MCP, Amap can achieve:

  • Voice + map collaboration : User voice commands (such as "navigate to the nearest hospital") directly trigger map path calculation, and feedback results through TTS;

  • Enhanced visual positioning : Combined with the image recognition model, the intelligent agent can parse the POI information in street view pictures and call the Amap API to obtain detailed data .


3. Performance optimization and security control
  • Massive point rendering : Supports dynamic loading of millions of data points (throughAMap.MassMarksClass), ensuring efficient visualization of large-scale geographic data ;

  • Permission classification : Based on the permission strategy of Huawei Cloud IAM system, fine-grained control of different agents' access to map data is achieved (such as only opening POI query permissions in specific areas) .



Typical application scenarios and developer practices


1. Smart travel assistant
  • Dynamic route planning : Based on real-time traffic data (MCP toolBraveProvide) and user preferences (such as avoiding toll booths), automatically generate the optimal route;

  • Multi-tool collaboration example :

javascript copy // MCP call chain example: traffic analysis + map rendering const trafficData = await MCP.callTool('Brave', {query: 'Beijing real-time congested roads'}); const route = await MCP.callTool('AMap', {action: 'path-planning', params: trafficData}); map.add(new AMap.Polyline({path: route.path, strokeColor: '#2489e9'})); // Amap API drawing path: cite[8]

2. Business Intelligence Analysis

  • Geographic heat map generation: Combine sales data with Amap population density layers and dynamically adjust visualization strategies through MCP;

  • Competitive product distribution monitoring : callAMap.PolygonDraw the scope of the business district and integrate third-party public opinion analysis tools .

3. IoT device linkage
  • Smart home scenario : When the user is more than 5 kilometers away from home (throughAMap.GeolocationPositioning), automatically trigger the air conditioner shutdown command;

  • Logistics route optimization : Combine truck load (sensor data) with Amap’s terrain data to dynamically plan energy-saving routes .



 Developer Quick Start Guide

1. Environment Configuration
  • Key application : Register a developer account on the Amap Open Platform and obtain the JS API Key ;

  • MCP service registration : bind the Amap API endpoint to the MCP server (such as OpenAI Agent SDK) .

2. Basic function calls
javascript copy // MCP command calls Amap to initialize const mapConfig = { center: [116.39, 39.9], zoom: 10, viewMode: '3D', pitch: 45 // 3D top view: cite[2]}; const map = await MCP.callTool('AMap', {action: 'init-map', params: mapConfig}); // Add dynamic marker points const markerParams = { position: [116.480983, 39.989628], icon: 'https://webapi.amap.com/images/car.png', content: '<div class="custom-info">Custom pop-up content</div>' :cite[8]}; await MCP.callTool('AMap', {action: 'add-marker', params: markerParams});
3. Tool Extensions


    maps_regeocode

    Convert a Gaode longitude and latitude coordinate into administrative division address information;


    maps_geo

    Convert detailed structured addresses into longitude and latitude coordinates. Support parsing landmark scenic spots and building names into longitude and latitude coordinates;


    maps_ip_location

    IP location locates the location of the IP according to the IP address entered by the user;


    maps_weather

    Query the weather of a specified city based on the city name or standard adcode;


    maps_search_detail

    Query the detailed information of POI ID obtained by keyword search or surrounding search;


    maps_bicycling

    Cycling route planning is used to plan cycling commuting plans, taking into account flyovers, one-way streets, road closures, etc. The maximum supported cycling route planning is 500km;


    maps_direction_walking

    The walking route planning API can plan a walking commuting plan within 100km based on the latitude and longitude coordinates of the input starting point and end point, and return the commuting plan data;


    maps_direction_driving

    The driving route planning API can plan commuting plans by car or sedan based on the user's starting and ending latitude and longitude coordinates, and return the commuting plan data;


    maps_direction_transit_integrated

    The bus route planning API can plan a commuting plan based on the user's starting and ending latitude and longitude coordinates of various public transportation modes (train, bus, subway), and return the commuting plan data. In the cross-city scenario, the starting city and the ending city must be passed;


    maps_distance

    The distance measurement API can measure the distance between two longitude and latitude coordinates, supporting driving, walking, and spherical distance measurement;


    maps_text_search

    Keyword search: search for relevant POIs based on the keywords entered by the user;


    maps_around_search

    Surrounding search: search for POIs within a radius based on the keywords and location entered by the user.


    Geographic intelligence evolution under MCP ecology


    The integration of Amap and MCP will promote the evolution of multiple technology trends, including: multi-modal output, supporting map data to directly generate voice navigation or AR guidance;

    Edge computing optimization, 7B parameter-level lightweight model adapts to vehicle terminals to achieve offline path planning ; decentralized services, through Web3 protocols (such as UXLINK) to achieve on-chain confirmation and sharing of geographic location data .

    The release of Amap MCP Server not only lowers the threshold for developing geographic intelligence, but also opens a new era of "spatial computing + AI".


    Whether individual developers or corporate users, they can use this to build smart geographic information application scenarios that are more scenario-aware and creative.