# Baidu Map Web Service API MCP for AI Agents MCP

> The Baidu Map Web Service API MCP provides access to China's leading mapping infrastructure. Your AI client can instantly handle complex location tasks, including converting addresses to precise coordinates, planning driving or transit routes, locating businesses by IP address, and finding Points of Interest across Chinese cities.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** lbs, routing, poi-search, geocoding, mapping, location-services

## Description

This connector lets your agent perform deep geographic searches using Baidu Map, China's dominant mapping service. Instead of navigating a technical portal full of forms and required parameters, you just ask your AI client what you need. It handles the complexity behind the scenes—whether it's calculating optimal transit routes between two points or pinpointing coordinates from a physical address.

Need to know where local businesses are clustered? You can search for specific types of Points of Interest (POIs) in any area, and even audit local commercial zones. If you’re running logistics operations, your agent can verify addresses instantly by converting text into exact latitude/longitude points. This capability turns complex mapping work into a simple conversation.

It all works through Vinkius, the #1 MCP Catalog. You connect once to your preferred AI client and get access to this powerful spatial data source for market research or planning across China.

## Tools

### direction_driving
Calculates turn-by-turn instructions for travel by car.

### direction_riding
Calculates directions using two wheels, like a motorcycle or scooter.

### direction_transit
Provides step-by-step instructions for public transportation, including bus and subway transfers.

### direction_walking
Generates an optimal pedestrian path between two points.

### geocoding
Converts a written address into precise latitude and longitude coordinates.

### get_business_area
Retrieves detailed data about the commercial characteristics of a specific neighborhood or business zone.

### get_suggestion
Offers suggested points of interest based on user input or current location context.

### ip_location
Guesses the general geographic coordinates associated with a given IP address.

### poi_search
Searches for specific types of points of interest, like hotels or restaurants, near a location.

### reverse_geocoding
Takes coordinates and finds the nearest readable street address.

## Prompt Examples

**Prompt:** 
```
What are the best directions from Beijing West Railway Station to a high-end restaurant district?
```

**Response:** 
```
**Transit Plan: Beijing West Station $\rightarrow$ Xicheng District** 

*   **Mode:** Subway/Metro (Recommended)
*   **Time Estimate:** 45 minutes (including wait time)
*   **Route Details:** Take Line 10 from Exit A to the Guomao station stop. From there, it's a quick 8-minute walk via the main street.

Would you like me to search for specific POIs near that final location?
```

**Prompt:** 
```
I need coordinates and suggestions of hotels near Shanghai’s Pudong airport.
```

**Response:** 
```
**Location Search Results: Near PVG Airport** 

*   **Geocodes:** 31.1928, 121.7765 (Approximate Center)
*   **Nearby POI Suggestions:**
    *   The Mandarin Oriental (Hotel)
    *   Airport Shuttle Bus Stop
    *   Local Business Park A

We found several options; let me know if you want contact details for any of these.
```

**Prompt:** 
```
Plan a driving route from Tsinghua to Peking University, avoiding major tolls.
```

**Response:** 
```
**🚗 Driving Route Plan (Tsinghua $\rightarrow$ PKU)** 

*   **Distance:** 3.8 km
*   **Estimated Time:** 12 minutes (low traffic)
*   **Key Directions:** Follow Chengfu Road initially, then take the side streets to avoid major toll roads. The route is primarily along local thoroughfares.

I can also check if there are any construction zones reported on this route.
```

## Capabilities

### Calculate multi-modal travel routes
Gets detailed directions for driving, public transit, walking, and riding between any two points in Chinese cities.

### Convert addresses to coordinates
Converts physical street addresses into precise latitude and longitude pairs, or vice versa.

### Find local businesses and POIs
Searches for specific types of locations, like hotels or restaurants, within defined areas or around given coordinates.

### Analyze business zones
Provides detailed information about the nature and layout of local commercial districts in China.

### Determine location via IP address
Guesses a user's general geographic location based only on their IP address.

## Use Cases

### Optimizing a multi-stop delivery route
A logistics manager needs to optimize 15 stops in Beijing. Instead of manually plotting the points, they ask their agent to run multiple `direction_driving` and `geocoding` calls to calculate the shortest path while minimizing time spent between addresses.

### Assessing a new retail location
A market researcher wants to know if a commercial area is viable. They use `get_business_area` and then run `poi_search` for competing businesses (e.g., coffee shops) within a 500-meter radius.

### Coordinating complex international travel
A planner needs to build an itinerary connecting a train station, a hotel, and a client office. The agent uses `direction_transit` for the subway leg and then `direction_walking` for the final approach.

### Investigating user data location
A compliance officer needs to know the general region of several users based on their IP addresses. They use `ip_location` to quickly audit regional targeting without needing physical addresses.

## Benefits

- Verify addresses instantly: Use `geocoding` to convert any written address into exact coordinates, eliminating guesswork in logistics planning.
- Compare travel options easily: Calculate optimal routes using different modes—you can compare driving directions (`direction_driving`) with public transit routes (`direction_transit`) side-by-side.
- Deep market insights: The `get_business_area` tool lets you analyze the commercial layout of a whole neighborhood, not just one spot. This is crucial for market research.
- Comprehensive search: Don't just rely on coordinates. Use `poi_search` to find specific amenities like hotels or restaurants near any given point.
- Global reach in China: Access reliable spatial data across Chinese cities that other mapping tools struggle with, ensuring your plans are accurate where it matters most.

## How It Works

The bottom line is, you tell your AI what location data you need, and it uses Baidu Map's full set of APIs behind the scenes to get the answer.

1. Subscribe to this MCP and provide your Baidu Map Access Key (AK) and optional Secret Key (SK).
2. Connect the MCP to your AI client, like Cursor or Claude.
3. Ask your agent a natural language question, such as 'What is the best transit route from A to B?' and let it use the available tools.

## Frequently Asked Questions

**How does using the Baidu Map Web Service API MCP help with complex logistics planning?**
It lets your agent calculate and compare multiple routes—driving, transit, walking—in one go. You don't have to switch between apps; you just ask for the most efficient path across China.

**Can I use the Baidu Map Web Service API MCP to research local business areas?**
Yes. Beyond just finding a single point, you can run an analysis of an entire commercial district using the `get_business_area` tool. This gives you deep context about the area's economic makeup.

**What if I only have coordinates and need to find out what street address that is?**
You use reverse geocoding. The MCP takes those raw latitude/longitude numbers and converts them into a readable, usable street address for you. It's the perfect way to validate data.

**Does the Baidu Map Web Service API MCP handle public transportation routes?**
Absolutely. It provides detailed directions using `direction_transit`, handling transfers between subways, buses, and other forms of mass transit across Chinese cities.

**Is this good for market research in China?**
It's excellent. You can combine finding nearby points of interest with analyzing the business area to build a comprehensive picture of local commercial viability, making your research much more accurate.