# Dashdoc MCP MCP

> Dashdoc connects your AI agent directly to a major transport management system, letting you manage everything from delivery addresses and contact lists to real-time fleet tracking and order status. You can check if a truck is active, find specific cargo details for an order, or instantly add new pickup locations using natural language prompts.

## Overview
- **Category:** erp-operations
- **Price:** Free
- **Tags:** transport-management, fleet-tracking, logistics-automation, delivery-management, supply-chain-visibility

## Description

This MCP lets your AI agent talk directly to the Dashdoc platform. Forget jumping between multiple portals just to figure out where a shipment is or who needs to be contacted at the destination. You can ask it to list all active transport orders, search for details based only on a reference number, or pull up the full profile of a specific truck, including its license plate and capacity. It also handles your site data; need to create a new pickup address? Done. Want to see who's working today? The agent can list registered drivers and even show you which trailers are available for assignment. Because this connection is hosted on Vinkius, you get access to all these logistics tools in one spot, letting your AI client handle the heavy lifting so you don’t have to.

## Tools

### create_new_address
Adds a new site location to your address book record using name, city, and postal code.

### get_my_user_info
Retrieves the account's user ID, role, and associated company configuration details.

### get_transport_details
Pulls a full report for one transport order, including addresses, contact numbers, cargo items, and status history.

### list_saved_addresses
Returns a list of all saved pickup or delivery addresses, including GPS coordinates and gate codes.

### list_transport_contacts
Lists contacts and business partners by resolving their legal names and tax identifiers.

### list_fleet_drivers
Lists all registered drivers with their professional names and internal system identifiers.

### list_fleet_trailers
Provides a list of all trailers, noting their type (like refrigerated) and assignment status.

### list_transports
Gives a summary list of all transport orders, showing their current status and scheduling dates.

### list_fleet_trucks
Lists every truck in the fleet, showing license plates, vehicle types, and maximum load capacity.

### search_transports_by_reference
Searches for specific transport orders using a partial reference keyword that matches the customer ID or order number.

## Prompt Examples

**Prompt:** 
```
List all transport orders that are 'Ongoing'.
```

**Response:** 
```
I've found 5 ongoing transports, including 'Order #TR123' from Paris to Lyon and 'Order #TR124' from Berlin to Munich. Would you like to see the assigned drivers for these?
```

**Prompt:** 
```
Show me the details for transport order 'TR123'.
```

**Response:** 
```
Transport order 'TR123' is currently 'Loading'. It contains 20 pallets of 'Electronics'. The estimated arrival at destination is tomorrow at 14:00. Should I check the contact info for the pickup point?
```

**Prompt:** 
```
List all trucks in our fleet.
```

**Response:** 
```
I've retrieved 12 trucks from your fleet, including 'Truck #01 (AB-123-CD)' and 'Truck #02 (EF-456-GH)'. 8 are currently 'Active' and 4 are 'In Maintenance'. Would you like a list of available trailers?
```

## Capabilities

### Check transport order status
Retrieve detailed information about any specific shipment, including its current location and cargo contents.

### Track fleet assets
Get comprehensive lists of available trucks, trailers, and drivers registered in the system.

### Manage site data
Add new delivery addresses or search through saved locations using GPS coordinates and contact details.

### Identify business partners
Pull up legal names, tax identifiers, and primary contacts for any associated company or partner.

## Use Cases

### A client calls asking about a shipment delay.
The agent uses `search_transports_by_reference` to find the order, then executes `get_transport_details`. It reports back that the container is delayed due to weather and provides the new estimated arrival time, all without you needing to navigate the Dashdoc portal.

### A dispatcher needs to assign a vehicle for tomorrow's run.
The agent first runs `list_fleet_trucks` to check capacity and then calls `list_fleet_trailers` to see what equipment is ready. It compiles this data, recommending the perfect truck/trailer pair for the job.

### A new warehouse needs a pickup spot added.
Instead of manually inputting coordinates in three different forms, you tell your agent to `create_new_address`. It handles persisting the metadata and gives you back the system ID immediately for tracking.

### A planner needs to audit all partner details before an international shipment.
The agent uses `list_transport_contacts` to pull up every associated business partner, ensuring that all required tax identifiers and primary communication channels are recorded correctly for customs forms.

## Benefits

- Instantly check shipment status: Need to know if Order #XYZ is confirmed? Just ask the agent. It calls `get_transport_details` and gives you the full story, including cargo details and arrival estimates.
- Never lose an address: Instead of guessing coordinates, use `list_saved_addresses` to pull up a list with GPS data and site-specific instructions, like gate codes or loading bay requirements.
- Optimize fleet assignment: Quickly audit your vehicles by running `list_fleet_trucks` and then cross-reference available units against `list_fleet_trailers` to ensure you have the right combination for a job.
- Keep contacts accurate: Before calling a partner, run `list_transport_contacts`. This tool confirms their legal name and tax ID, preventing billing mixups when planning multi-stage shipments.
- Handle massive order lists: When you need an overview of everything happening this week, running `list_transports` gives you the status summary instantly. If a specific reference is needed, use `search_transports_by_reference` for precision.

## How It Works

The bottom line is you can manage complex logistics operations by just talking to it.

1. First, you authorize your AI client using the Dashdoc API Key. You'll need this key, which is found in the platform's settings.
2. Once authorized, your agent can access all ten tools and execute commands based on natural language instructions (e.g., 'Find all trailers that are refrigerated').
3. The system returns structured data—like a list of active trucks or the details for a specific order—which your AI client then formats into an easy-to-read, conversational response.

## Frequently Asked Questions

**How do I find an order using the Dashdoc MCP? (search_transports_by_reference)**
You search for orders by reference keyword. This tool allows you to partially match identifiers, so you don't need the full number—just a key piece of information like the customer name or partial ID.

**What if I have multiple addresses and want to save them? (create_new_address)**
You use `create_new_address` to persist site metadata. When you run it, the system returns a newly generated unique ID for that specific address record.

**Can I check driver details using the Dashdoc MCP? (list_fleet_drivers)**
Yes, running `list_fleet_drivers` pulls up profiles including professional names and internal system identifiers, letting you confirm who is assigned to which job.

**How do I get the detailed history of a transport order? (get_transport_details)**
You use `get_transport_details` for deep dives. It resolves IDs into human-readable names and provides historical status logs, making it perfect for reporting.

**Do I need to know the user ID before listing contacts? (list_transport_contacts)**
No. You can use `list_transport_contacts` directly to resolve business partner identities by name or tax identifier, regardless of which user is authenticated.

**How can I use `list_fleet_trucks` to check the status of my entire vehicle inventory?**
It provides a detailed list including license plates, vehicle types, and current operational status. You immediately know which trucks are active versus those that require maintenance.

**If I need to see all my stored sites, how does `list_saved_addresses` work?**
This function returns a collection of site objects with GPS coordinates and technical instructions. It's the best way to get an overview of every pickup or delivery point you use.

**When should I use `get_my_user_info` to check my current connection details?**
This tool retrieves account-level metadata like your User ID, role, and company configuration. Run this first whenever you need to confirm the context of the operational data.

**How do I get a Dashdoc API Key?**
Log in to your Dashdoc account, navigate to **Settings > API**, and you can generate or retrieve your API Key there. Ensure your account has API access enabled.

**Can the agent update transport statuses?**
This integration currently focuses on listing and retrieving transport data for analysis. Status updates should be managed via the Dashdoc dashboard or driver mobile app.

**Is fleet data included?**
Yes, you can list your trucks, trailers, and drivers, allowing the agent to provide information on your available transport resources.