# Shansong Swift Delivery MCP for AI Agents AI Agent Connect

> Shansong Swift Delivery MCP connects your AI to a fast P2P delivery network. It lets your agent handle logistics routing, dispatch riders, and track live GPS locations. Perfect for retail support and office management who need to automate the movement of goods without jumping between different courier dashboards.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_EQkRKkNdAD39QyrDkIEZIuUr6qR50ztfvBVZrrtR/ai-agent-connect
- **Tags:** shansong, delivery, logistics, tracking, gps, instant-delivery, swift-delivery

## Description

Imagine you're running a retail operation where customers are constantly asking for real-time updates on their packages. Instead of your team jumping between different tabs to check a courier's location or manually calculating shipping costs, this Connector puts that power directly into your AI's hands. It handles the heavy lifting of the Shansong delivery infrastructure, letting your agent act as a logistics coordinator that never sleeps. You can have your AI check if a specific city is covered, find the nearest store, or even calculate delivery fees on the fly. When a customer wants to know exactly where their driver is, the AI pulls the live GPS coordinates instantly. It can also handle the administrative side, like adding tips to encourage faster pickups or submitting complaints if things go south. By integrating this into your workflow via the Vinkius catalog, you turn a manual logistics headache into an automated conversation. Your agents can now create orders, confirm pick-ups, and manage the entire lifecycle of a delivery without a human ever having to open a dashboard. It's about moving from "let me check that for you" to "here is exactly where your package is right now."

## Tools

### confirm_goods
Mark a delivery as successfully picked up by the rider. This updates the status for your internal records.

### create_order
Submit a new delivery request to the Shansong network. This automates the creation of new logistics tasks.

### query_city_list
Get a list of all active cities where Shansong provides delivery services. This helps you verify if a location is supported.

### query_order_info
Fetch the current status and details of a specific delivery order. Use this to give customers real-time updates.

### query_rider_position
Get the live GPS coordinates of a rider currently on a delivery. This provides accurate location data for tracking.

### query_store_list
Find all available stores within a specific city for delivery pickup. This is useful for local fulfillment planning.

### submit_complaint
Send a formal complaint regarding a specific assigned rider. This helps manage issues without manual intervention.

### add_tip
Send a tip to a driver to prioritize a specific delivery or pickup. Use this to nudge high-priority orders.

### calculate_fee
Get a dynamic delivery fee estimate based on the order details. This ensures your pricing is always accurate.

### cancel_order
Stop an active delivery dispatch and cancel the order. This allows for quick changes to the logistics flow.

## Prompt Examples

**Prompt:** 
```
Can you check if Shansong delivers to Seattle and tell me the nearest store?
```

**Response:** 
```
Yes, Shansong provides delivery services in the Seattle area. I have identified several active stores nearby that can handle your requests. Would you like me to check the specific delivery fees for a pickup from one of them?
```

**Prompt:** 
```
The driver for order #8821 is taking forever. Can we give them a small tip to speed things up?
```

**Response:** 
```
I have sent a tip to the driver for order #8821. This should help prioritize your delivery and get it to you as quickly as possible. I will keep an eye on the progress for you.
```

**Prompt:** 
```
Where is my package right now?
```

**Response:** 
```
I have tracked your delivery. The rider is currently about 2 miles away and is moving toward your location. You can see their progress here:

* **Current Status:** In Transit
* **Estimated Arrival:** 8 minutes
* **Rider Location:** [Live GPS Update Active]
```

## Capabilities

### Track rider GPS locations
Get live coordinates of a driver currently on a delivery route.

### Calculate real-time delivery fees
Get dynamic pricing for a delivery based on specific order details.

### Create new delivery orders
Submit new delivery requests directly to the Shansong network.

### Check city and store availability
Verify if a specific city is supported and find nearby stores.

### Add tips to driver orders
Send a tip to a driver to prioritize a specific pickup or delivery.

### Cancel active dispatches
Stop an active delivery and cancel the order immediately.

### Confirm successful pick-ups
Mark a delivery as successfully picked up by the rider.

## Use Cases

### Live Customer Support
A customer asks where their package is. The agent uses `query_rider_position` to give them a live update on the driver's location.

### Retail Coverage Checks
A store owner needs to know if they can deliver to a new zip code. The agent runs `query_city_list` to verify Shansong's service area.

### Automated Office Dispatch
An admin wants to send a contract to a nearby office. The agent uses `calculate_fee` and `create_order` to ship it instantly.

### Priority Rider Nudging
A driver is running late. The support agent uses `add_tip` to encourage them to prioritize that specific stop in their route.

## Benefits

- Give customers live GPS tracking for their orders using `query_rider_position` so they never have to call you for updates.
- Automate delivery cost estimates with `calculate_fee` to provide instant pricing to your customers during the checkout flow.
- Reduce manual data entry by letting your agent use `create_order` to submit new delivery requests directly from a chat.
- Improve rider satisfaction and delivery speed by using `add_tip` to prioritize specific high-value pickups.
- Handle order lifecycle changes like `cancel_order` or `confirm_goods` without leaving your primary communication channel.
- Verify service areas instantly with `query_city_list` and `query_store_list` to ensure you only take orders you can fulfill.

## How It Works

The bottom line is you get a fully functional logistics backend for your AI without writing any custom signing logic.

1. Sign up on the Shansong Open Platform to get your Client ID, App Secret, and Shop ID.
2. Add these credentials to Vurb to connect the Shansong network to your AI.
3. Your agent can now fetch GPS data, calculate fees, and manage orders directly.

## Frequently Asked Questions

**Can the Shansong Swift Delivery MCP track live rider locations?**
Yes, it allows your AI to pull live GPS coordinates for any active delivery. This means you can give customers real-time updates without having to check a separate app.

**How do I use Shansong Swift Delivery MCP to calculate shipping costs?**
Your AI can use the tool to get dynamic delivery fees based on specific order details. This ensures your customers always see the most accurate pricing instantly.

**Can I create delivery orders through the Shansong Swift Delivery MCP?**
Yes, your agent can submit new delivery requests directly to the Shansong network. This lets you automate the entire ordering process from a chat interface.

**Is the Shansong Swift Delivery MCP good for retail customer support?**
It is ideal for retail support because it handles the most common customer questions, like tracking status and delivery estimates, automatically.

**Can I cancel an order using the Shansong Swift Delivery MCP?**
Your AI can handle order cancellations autonomously. This is helpful for quickly managing changes to a delivery without involving a human agent.

**Does the Shansong Swift Delivery MCP support multiple cities?**
The Connector allows your agent to check which cities are active in the Shansong network, making it easy to verify coverage for different regions.

**How is the Shansong API payload encrypted?**
Instead of demanding complex LLM scripting to assemble `clientId`, JSON stringification, and MD5 encoding, this plugin seamlessly abstracts the `sign` variable creation. All HTTP form-data bounds are strictly governed locally on the proxy instance yielding instant results.