# Tencent Map LBS API MCP > Tencent Map LBS API brings China's leading location-based services directly into your AI agent. It lets you calculate precise routes, find points of interest, and convert addresses to coordinates for any task involving Chinese geography. This MCP gives your agent the ability to handle complex mapping tasks—like optimizing logistics or market research—without ever opening a map app or dealing with API keys. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** lbs, mapping, routing, poi-data, geocoding, location-services ## Description Stop manually looking up address data or switching between multiple mapping tools. With this MCP, you give your AI client the power of Tencent Map, China's dominant location infrastructure. Your agent handles all geographic operations through natural conversation. Need to know where an address is? Ask it to convert that physical location into precise coordinates instantly. Planning a delivery route across Chinese cities? Just ask for driving, transit, or walking directions between points. It even searches for specific types of businesses, like restaurants or hotels, near any given spot. This unified access makes your agent act like a real-time geographic intelligence expert. If you're building an application that needs reliable mapping data in China, connecting this MCP via Vinkius gives you instant control over complex geocoding and routing without writing a single line of code. ## Tools ### direction_bicycling Gets detailed step-by-step directions for cycling routes. ### direction_driving Calculates the fastest and most efficient driving route between points. ### direction_transit Plans optimal public transit directions, including subway and bus transfers. ### direction_walking Provides simple turn-by-turn walking instructions for pedestrians. ### geocoding Converts a physical street address into precise latitude and longitude coordinates. ### get_district_list Retrieves the full, official list of administrative districts used for regional classification. ### ip_location Determines a location and regional data based on an input IP address. ### poi_search Searches for specific types of points of interest, such as restaurants or hospitals, by keyword. ### poi_suggestion Suggests relevant local places when a user is searching generally in an area. ### reverse_geocoding Converts raw latitude and longitude coordinates back into a readable street address. ## Prompt Examples **Prompt:** ``` Find the coordinates for 'Tencent Seafront Towers' in Shenzhen. ``` **Response:** ``` I've geocoded the address. The Tencent Seafront Towers in Shenzhen are located at latitude 22.5229, longitude 113.9351. Would you like me to plan a driving route there or search for nearby restaurants? ``` **Prompt:** ``` Search for 'Coffee' near 22.5229, 113.9351 within 1000 meters. ``` **Response:** ``` I've found 8 coffee shops within 1000 meters of those coordinates, including 'Starbucks' and 'Luckin Coffee'. Would you like the full list with addresses and contact numbers? ``` **Prompt:** ``` What is the best transit route from Shenzhen University to the Airport? ``` **Response:** ``` I've planned the transit route. The best option is taking Metro Line 11 directly, which takes about 35 minutes. Would you like a step-by-step breakdown of the transit directions? ``` ## Capabilities ### Calculate Coordinates from Addresses The agent converts physical addresses into specific latitude and longitude coordinates. ### Plan Multi-Modal Routes You get turn-by-turn directions for driving, public transit, walking, or cycling between two points. ### Discover Points of Interest The agent searches for specific categories of places, like hotels or restaurants, within a defined area. ### Audit User Locations by IP You can determine the regional location and audit user data using only an IP address. ### Identify Administrative Areas The agent accesses a comprehensive list of all administrative districts in China for classification purposes. ## Use Cases ### Optimizing Last-Mile Delivery A logistics manager needs the fastest route for 15 packages across Shanghai. They ask their agent, 'What's the best way to get from point A to point B?' The agent uses direction_driving and then calculates a secondary walking path between two cluster points, delivering an optimized, multi-modal plan. ### Verifying Miniapp User Input A developer needs to ensure that a user entered a valid address for their WeChat app. They prompt the agent with 'Check this address: [Address]' and use geocoding, which instantly returns coordinates or flags the address as invalid. ### Competitive Site Analysis A market researcher wants to know where all the major coffee chains are in a new neighborhood. They ask their agent to perform a poi_search for 'coffee' within a 1km radius, getting an immediate list of competitors. ### Geographic Data Validation A compliance officer receives a user report with coordinates but no address context. They ask the agent to use reverse_geocoding on those points, instantly converting them into a readable street address for reporting. ## Benefits - Turns complex map tasks into simple conversations. Instead of writing code to convert an address, you just ask your agent for the coordinates using the geocoding tool. - Saves time on routing by supporting all modes: driving (direction_driving), public transit (direction_transit), walking (direction_walking), and bicycling (direction_bicycling). - Improves market intelligence by allowing you to search for specific businesses, like coffee shops, using the poi_search tool without needing to know their exact address. - Gives regional confidence. You can audit user location or classify data sources using the ip_location tool based on IP addresses, which is critical for compliance. - Provides complete coverage of Chinese geography, from getting a simple list of administrative districts via get_district_list to accurately reversing coordinates with reverse_geocoding. ## How It Works The bottom line is you tell your agent what you need—a route, an address conversion, or a list of places—and it handles all the complex mapping calls in the background. 1. Subscribe to this MCP and provide your Tencent Map API Key and optional Secret Key. 2. Your AI client reads the location request (e.g., 'Find a coffee shop near X coordinates'). 3. The agent executes the necessary tool call, retrieves precise map data, and reports the final result back in plain conversation. ## Frequently Asked Questions **How do I convert an address to coordinates using the Tencent Map LBS API MCP?** You use the geocoding tool. Simply ask your agent to take a physical street name and return its latitude and longitude, and it handles the conversion immediately. **Can I plan a route from my current location using direction_driving?** Yes, you just need to provide both endpoints. The agent uses direction_driving to calculate the fastest driving path, accounting for real-time traffic conditions. **What if I only know coordinates and want a street address? Do I use reverse_geocoding?** Yes, that's exactly what reverse_geocoding does. Give it the latitude and longitude, and it pulls back the most accurate readable street address. **Does poi_search only find businesses, or can it find other points of interest?** It searches for various types of locations based on keywords you give it. It's useful for finding anything from a specific hospital to a general type of restaurant. **Is the get_district_list tool necessary if I just need to know the city name?** No, but it’s useful for deep data validation. It provides the full list of administrative districts, ensuring your classification uses official governmental boundaries.