# Lalamove Malaysia MCP

> Lalamove Malaysia connects your AI agent to on-demand delivery services across Malaysia. Get real-time price quotes, create new shipments, cancel existing orders, and track the assigned driver's exact GPS location using natural conversation. Stop clicking through multiple web forms; just ask your agent for a quote or status update.

## Overview
- **Category:** transportation
- **Price:** Free
- **Tags:** lalamove, malaysia-delivery, on-demand-logistics, shipping-api, driver-tracking, last-mile-delivery

## Description

Coordinating local deliveries shouldn't require juggling three different websites and calling dispatch repeatedly. This MCP lets you automate the entire logistics workflow, from getting an initial price estimate to tracking the package right up to the door. Instead of manually visiting a portal to check pricing for various vehicle types or trying to piece together order details across multiple screens, your agent handles it all instantly. You can ask for a quote based on location and size, review the exact fee breakdown, and if you're ready, place the whole shipment programmatically. This integration makes tracking driver status and managing cancellations conversational. Because this MCP is hosted on Vinkius, any compatible AI client—Claude, Cursor, or your own agent—connects to it once, giving you access to Malaysian logistics data immediately.

## Tools

### add_priority_fee
Adds an extra tip or priority fee to an existing order.

### cancel_order
Cancels a delivery order that is currently active.

### get_driver_details
Retrieves general information about the driver assigned to an order.

### get_driver_location
Gets the live GPS coordinates of the delivery driver.

### get_order_details
Pulls all known details for a specific order ID.

### get_price_breakdown
Shows the detailed fee structure used to calculate total shipping costs.

### get_quotation
Returns an immediate quote ID and a preliminary price breakdown for a new delivery task.

### list_city_info
Lists all supported cities and types of services available in Malaysia.

### list_vehicle_info
Retrieves a list of vehicle types (e.g., motorcycle, van) that can be used for delivery.

### place_order
Submits and places a brand new delivery order with all necessary details.

## Prompt Examples

**Prompt:** 
```
Get a Lalamove quote for a motorcycle from 'KLCC' to 'Petaling Jaya'.
```

**Response:** 
```
Retrieving Lalamove quotation... For a motorcycle from KLCC to Petaling Jaya (Approx. 12km), the estimated fare is RM 15.00. This includes basic insurance. Would you like to proceed with the order?
```

**Prompt:** 
```
Track my active Lalamove order 'ord_123456789'.
```

**Response:** 
```
Connecting to Lalamove tracking... Your order 'ord_123456789' is currently 'In Progress'. Driver: Ahmad (ID: drv_777) is 5 minutes away from the drop-off point. Would you like me to send you the GPS tracking link?
```

**Prompt:** 
```
Cancel my Lalamove order ID 'ord_999888777'.
```

**Response:** 
```
Processing cancellation request... Success! Order 'ord_999888777' has been cancelled. Please note that cancellation fees may apply based on the driver's current location.
```

## Capabilities

### Estimate Delivery Costs
Get accurate, real-time price quotes for shipments based on pickup and drop-off points.

### Create Shipments
Place new delivery orders using the official API credentials.

### Manage Orders
Retrieve specific order details or cancel an active shipment.

### Monitor Driver Status
Access real-time GPS coordinates and general contact information for the assigned driver.

## Use Cases

### Last-Minute Fulfillment Check
A retail store needs to ship an item across town. Instead of calling dispatch and waiting for an estimate, the agent runs `get_quotation` using parameters for a motorcycle from 'KLCC' to 'Petaling Jaya'. It gets the estimated fare instantly, allowing them to tell the customer the price right now.

### Emergency Tracking
An operations manager needs to know if a high-value item is delayed. They prompt their agent to run `get_driver_location` using the order ID. The agent confirms the driver's current location and provides an estimated time of arrival.

### Correcting Mistakes
A shipment was sent, but the recipient changed their mind. Instead of logging into a portal to find the cancellation button, they ask the agent to run `cancel_order`. The agent processes the request and confirms the status.

### E-commerce Integration
A developer needs to integrate shipping estimates for their Malaysian storefront. They use the MCP's tools to call `list_vehicle_info` first, ensuring they only offer delivery options that are actually supported by Lalamove.

## Benefits

- Get instant cost estimates. Use the `get_quotation` tool to check pricing instantly, eliminating guesswork before committing to a shipment.
- Track everything in real-time. The `get_driver_location` tool provides the driver's live GPS feed, so you never have to wonder where your package is.
- Full order lifecycle management. You can use `place_order` to initiate shipments and `cancel_order` if plans change—all through simple chat prompts.
- Transparency in pricing. Don't just get a number; the `get_price_breakdown` tool tells you exactly why it costs what it does, detailing base fares and surcharges.
- Know your options upfront. Use `list_city_info` to verify if a service is even available at a specific address before quoting anything.

## How It Works

The bottom line is: You provide the credentials once, and your AI agent handles all the complex data calls automatically.

1. Subscribe to this MCP and register a Lalamove Partner Account.
2. Retrieve your necessary credentials (API Key, API Secret) from the platform settings.
3. Supply those keys to your agent so it can start making live requests for quotes or status updates.

## Frequently Asked Questions

**How do I start tracking my order using the get_driver_location tool?**
You just ask your agent to run `get_driver_location` along with the active order ID. The MCP connects and pulls the driver's current GPS coordinates in real-time.

**What is the difference between get_quotation and get_price_breakdown?**
`get_quotation` gives you a live estimate for a new job. `get_price_breakdown` takes an existing quote ID and shows you exactly how that price was calculated, detailing every surcharge.

**Can I use the place_order tool without getting a quote first?**
While possible, it's safer to run `get_quotation` first. This confirms service availability and gives you the expected cost upfront before committing to the full order placement via `place_order`.

**Does this MCP handle cancellations?**
Yes, it does. You can ask the agent to run `cancel_order`, which processes the cancellation request through the official Lalamove API and reports back success or failure.

**What credentials do I need to use the `get_order_details` tool?**
You must provide a valid Order ID and have authenticated API keys. The MCP requires these details to securely pull specific order history or current status for your account.

**Before placing an order, how can I check what vehicle types are available using `list_vehicle_info`?**
This tool returns a comprehensive list of all supported transport options. You'll see everything from motorcycles to vans, helping you select the right fit for your shipment.

**How can I verify if a specific address is serviceable before running `get_quotation` using `list_city_info`?**
The tool provides a list of all supported cities and service types in the Lalamove network. Checking this first prevents failed requests due to unsupported locations.

**If I need to add an extra fee or tip, how do I use the `add_priority_fee` tool?**
You pass the desired priority amount and the order ID into the function. This immediately adjusts the total cost of an existing delivery before you finalize it.

**Can my AI automatically get a delivery quote before placing an order?**
Yes! Use the `get_quotation` tool with the pickup and delivery addresses and vehicle type. Your agent will return the estimated cost and distance instantly.

**How do I track the real-time location of a Lalamove driver?**
Use the `get_order_details` tool with your active Order ID. If a driver has been assigned, the agent will return their current GPS coordinates and contact information.

**Does Lalamove support motorcycle deliveries in Kuala Lumpur?**
Yes! Use the `list_cities` tool to verify coverage and supported vehicle types. Motorcycles (MOTORCYCLE) are a standard vehicle option for Kuala Lumpur and most Malaysian cities.