Tencent Map LBS API MCP. Turn location data into conversation.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Tencent Map LBS API provides access to Tencent Map, one of China's main location platforms. It gives your AI client tools for geocoding (address-to-coordinates), POI search (finding businesses like hotels and restaurants), routing calculations (driving, transit, walking directions), and IP address localization.
Use it when you need reliable geographic data or logistics planning within the Chinese market.
What your AI agents can do
Direction bicycling
Gets step-by-step directions for bicycling between two points.
Direction driving
Calculates the fastest driving route, including estimated time and distance.
Direction transit
Provides detailed directions using public transportation methods (metro, bus).
The agent converts addresses into precise latitude/longitude coordinates, or vice versa.
It generates step-by-step directions for driving, public transit, walking, and bicycling between any two points.
The agent finds Points of Interest (POI) using keywords or geographical boundaries.
It determines a general location based on an provided IP address.
The agent retrieves the full list of administrative districts across China.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Tencent Map LBS API: 10 Tools for Location Data
Use these ten tools to convert addresses to coordinates, plan routes across different modes of transport, and discover Points of Interest using the Tencent Map infrastructure.
019d848bdirection bicycling
Gets step-by-step directions for bicycling between two points.
019d848bdirection driving
Calculates the fastest driving route, including estimated time and distance.
019d848bdirection transit
Provides detailed directions using public transportation methods (metro, bus).
019d848bdirection walking
Calculates the optimal route for foot traffic.
019d848bgeocoding
Converts a physical address string into precise latitude and longitude coordinates.
019d848bget district list
Fetches the complete, official list of administrative districts in China.
019d848bip location
Estimates a geographical location based on an IP address provided by the user.
019d848bpoi search
Searches for Points of Interest (like restaurants or hotels) near specific coordinates using keywords and radius.
019d848bpoi suggestion
Gets suggestions for relevant Places of Interest when a user is specifying a location.
019d848breverse geocoding
Converts latitude and longitude coordinates back into a human-readable address string.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Tencent Map LBS API, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Listen up. This server hooks your agent into Tencent Map—it's one of the biggest location platforms out there in China. It gives your AI client the raw tools to handle almost any geographic data problem you throw at it. You won't need a separate mapping API; your agent just uses these functions like built-in knowledge.
Coordinates and Addresses
The server lets your agent convert physical addresses into precise latitude and longitude coordinates using geocoding. It does the reverse too: if you only have lat/long, it'll use reverse_geocoding to spit out a readable address string. This means you can move between raw data points (numbers) and human language (addresses) seamlessly.
Finding Routes
The agent calculates step-by-step directions for every kind of travel imaginable. You can get the fastest driving route, which includes estimated time and distance via direction_driving. If your user's taking public transit—like a subway or bus—it uses direction_transit to give detailed steps. For foot traffic, it runs direction_walking, finding the optimal path for people on foot.
You also get directions for cyclists with direction_bicycling; these tools ensure you always calculate the best way between two points.
Searching Places and Locations
When your client needs to find a business—say, a decent noodle shop or a hotel—it uses poi_search. You just feed it keywords and coordinates plus a radius, and it returns relevant Points of Interest. Before the user even searches, your agent can use poi_suggestion to get ideas for places of interest based on where you are looking.
Utility Tools: IP and Districts
If you only have an IP address, don't sweat it. The ip_location tool estimates a general geographical location from that IP. For administrative context across China, the server provides a complete list of official districts using get_district_list. These functions let your client build out background data on location structure and general area boundaries.
How Tencent Map LBS API MCP Works
- 1 1. Subscribe to this server and input your Tencent Map API Key (and optional Secret Key).
- 2 2. Instruct your AI client to perform a location action: e.g., 'Find the coordinates for X' or 'Plan a driving route from Y to Z.'
- 3 3. The agent calls the appropriate tool, receives structured data (coordinates, directions), and presents it as part of the conversation.
The bottom line is that your AI client handles all the API calls; you just talk to it using natural language.
Who Is Tencent Map LBS API MCP For?
Miniapp developers building WeChat-integrated tools need this. Logistics coordinators who manage deliveries across China use it. Market researchers analyzing local business density also rely on this server. It’s for anyone whose job requires reliable, real-time geographic data in the Chinese market.
Uses geocoding and POI search to verify user locations and plan routes within WeChat apps.
Optimizes delivery paths, audits addresses, and checks driving directions for field teams.
Analyzes the density of specific businesses (like coffee shops) or regional distribution using POI discovery.
What Changes When You Connect
- Geocoding Orchestration: Stop manual address lookups. Your agent converts any physical Chinese address directly to coordinates, saving the time of opening separate mapping portals and copying/pasting values.
- Comprehensive Routing: Instead of guessing which map view is right, your AI client instantly plans routes for driving, walking, or public transit using tools like
direction_drivinganddirection_transit. It gives you a single answer. - Hyper-Local Search (POI): Need to find the nearest coffee shop? Use
poi_search. You just ask: 'Find 5 restaurants near X,' and it returns structured data with addresses, skipping manual map panning. - IP Address Auditing: For compliance or initial triage, use
ip_location. The agent determines a region from an IP address without needing user input, which is critical for regional service checks. - Administrative Context: Need to classify a location? Use
get_district_listto access the full hierarchy of Chinese districts. This structured data lets you categorize results instantly—something otherwise locked behind complex database queries.
Real-World Use Cases
Optimizing Multi-Stop Deliveries
A logistics manager needs to route 12 packages across Shenzhen. Instead of manually inputting all addresses into a mapping service, they ask their agent: 'Plan the most efficient driving route starting at A and hitting B through K.' The agent uses direction_driving repeatedly, optimizing the sequence and giving the final step-by-step path.
Market Research for New Stores
A business owner wants to open a new branch near existing competitors. They ask the agent: 'Search for all coffee shops within 500 meters of this coordinate.' The agent runs poi_search, returning structured data on competitor names and addresses, letting them map density immediately.
WeChat Miniapp Location Verification
A developer is building a booking app. When the user inputs an address, they don't trust it. They ask the agent: 'Confirm the coordinates for this address.' The agent runs geocoding and verifies the precise lat/long pair before allowing the transaction to proceed.
Assessing User Origin
Customer support gets an inquiry from a suspicious IP. Instead of asking the user for their location, they ask the agent: 'What is the approximate location for this IP?' The agent uses ip_location to provide immediate regional context, speeding up initial fraud assessment.
The Tradeoffs
Treating coordinates as magic
Telling the agent: 'Just find me restaurants near 22.5229, 113.9351.' This is vague and doesn't specify what kind of POI you want or how far away.
→
Be specific. Use the poi_search tool by saying: 'Search for five highly-rated restaurants within 1 kilometer of these coordinates using the poi_search tool.' Always include keywords.
Mixing up address formats
Trying to paste a mix of street names and vague district numbers into one prompt without knowing which tools handle what. The agent fails because it can't distinguish between an address and an administrative code.
→
If you need coordinates, use geocoding for the full physical address. If you need classification, use get_district_list first to ensure your input is valid data.
Assuming a single route type
Asking 'How do I get from A to B?' and being disappointed when the agent gives driving directions, because you were walking.
→
Specify the mode of transport. Ask: 'What's the best way to walk from A to B?' or 'Give me transit directions using direction_transit.' The tool requires this input.
When It Fits, When It Doesn't
Use this server if your primary need is location intelligence within China, requiring specific tools like geocoding and POI search. It’s essential for logistics and Miniapp development in that market.
Don't use it if you only need general map views or basic address lookups outside of the Chinese context; other dedicated mapping APIs handle those regions better. If your goal is purely data visualization (e.g., plotting millions of random points), this server is too granular. Instead, build a custom ETL pipeline to consume generalized location data sources.
When in doubt, check if you need a specific function: Do you need coordinates? Use geocoding. Are you planning travel? Check the directional tools (direction_driving, etc.). If the tool doesn't exist (e.g., 'Find me a pet store'), you'll have to build that search logic yourself.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Tencent Map LBS API. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Manually gathering location data is slow and error-prone.
Today, if your agent needs to know where an address is, you manually check the address format against several systems. You copy the street name into a geocoding service, then take the resulting coordinates and paste them into a routing tool, only to find out later that the address was ambiguous or incomplete.
With this MCP server, your agent handles it all in one go. You simply ask: 'What is the driving route from X to Y?' The system runs `geocoding` first if needed, then passes those coordinates directly into the correct directional tool (`direction_driving`). You get the final directions and time estimate without any copy-pasting.
Tencent Map LBS API MCP Server: Calculate routes & locations
Before this, planning a multi-stage trip meant opening five tabs: one for the starting address, one for the destination, and three others—one for walking, one for transit, and one for driving. You had to manually track which tool gave you which result.
Now, your agent manages the entire sequence. Give it the start point and the end goal, specify 'transit,' and it runs `direction_transit` automatically. It gives a single, definitive set of instructions—the whole process is contained in one conversation.
Common Questions About Tencent Map LBS API MCP
How do I use geocoding with Tencent Map LBS API MCP Server? +
You ask the agent to convert an address. It uses the geocoding tool, taking the physical street address as input and returning precise latitude/longitude coordinates.
Does poi_search require exact coordinates? +
No, you can search for POIs using keywords and a radius around specific coordinates. The agent runs poi_search to find relevant businesses like hotels or restaurants within that area.
What is the difference between direction_driving and direction_transit? +
They calculate different types of paths. direction_driving gives you car routes, while direction_transit uses public transport options like buses or subways for your journey.
Can I find a location just from an IP address using ip_location? +
Yes. You can ask the agent to use the ip_location tool, which estimates a general geographical area based on the IP provided in your prompt.
What happens if the input data for `reverse_geocoding` contains invalid coordinates? +
The system returns a structured error message, identifying which coordinate pair failed. You'll receive specific codes detailing whether the issue is format-based or location-specific.
Are there rate limits when running multiple `poi_search` queries in quick succession? +
Yes, usage has defined rate limits to prevent abuse. The MCP server will return a 429 error code if you exceed the allowed requests per minute.
How does the `get_district_list` tool handle data pagination for large regions? +
The tool is designed to manage large datasets using paginated responses. You only need to specify the page number and size parameters in your API call.
Does `direction_bicycling` accept addresses or does it require exact latitude/longitude coordinates? +
It accepts both address strings and coordinate pairs. If you provide an address, the system first runs a geocoding lookup before calculating the route.
How do I find my Tencent Map API Key? +
Log in to the Tencent Map Open Platform Console, create an application, and your Key will be displayed. You can also configure the optional Secret Key (SK) in the key settings.
When should I provide the Secret Key (SK)? +
Provide the SK if you have enabled 'Signature Verification' (sig) in your Tencent Map key settings. This server will automatically calculate the MD5 signature for every request if the SK is provided.
Can I use this for international geocoding? +
Tencent Map is highly optimized for mainland China, Hong Kong, and Macau. While some international coverage exists, results outside these regions may be less detailed than local providers.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Bing Search
Empower your AI agent with real-time web, image, and news search via Bing.
EPO Open Patent Services
Search global patents — audit bibliographic and legal data via AI.
Dada Now Delivery
Bring Dada Now's Instant Local Delivery API to your LLM. Schedule swift deliveries, manage your stores, and calculate routing fees.
You might also like
Basecamp
Manage your Basecamp projects via AI — list tasks, read message boards, track campfire logs, and orchestrate to-dos seamlessly.
GoTo Connect
Manage your cloud phone system — view call records, send SMS, and manage voicemails via AI.
Hanko (Passkey Auth)
Manage passkey authentication and user identity via Hanko — initialize registrations, handle logins, and manage WebAuthn credentials directly.