# Route4Me MCP for AI Agents AI Agent Connect

> Route4Me lets you put your logistics data into a conversation. Instead of jumping between tabs or downloading CSVs to see how your routes performed, you can ask your AI agent to pull reports, check vehicle status, or update your address book. It bridges the gap between your Route4Me account and your daily workflow, making it easier to manage fleet operations without the manual data entry.

## Overview
- **Category:** erp-operations
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_lXDGLcvA89W820Dg9yEmeN8DIKvOZqNlTM2CxgWM/ai-agent-connect
- **Tags:** route-optimization, fleet-management, address-management, vrp-algorithms, logistics-automation, vehicle-tracking

## Description

Stop digging through spreadsheets just to see if your drivers are on schedule or how many stops were completed in a specific run. This Connector lets you treat your Route4Me account like a live database that your AI agent can query and update instantly. You can ask for the latest optimization reports, check which vehicles are currently available, or manage your customer list without ever opening the main dashboard. If you're tired of the friction between your planning software and your communication tools, this is how you fix it. By connecting through the Vinkius catalog, you give your agent the eyes it needs to see your fleet and the hands it needs to organize it. You get to stop copy-pasting and start actually making decisions based on real-time logistics data. Instead of hunting for a specific vehicle ID or digging through nested menus to find a customer's updated coordinates, you just ask. This turns your logistics management into a conversation, allowing you to handle high-volume tasks like address updates or fleet audits with a single prompt. It's about moving from being a data entry clerk to being a decision maker. You can quickly verify driver assignments, pull historical performance metrics to see how your VRP algorithms are actually performing, and keep your address book clean without the headache of manual syncs. This Connector bridges the gap between your planning software and your daily communication, ensuring that your fleet data is always accessible, accurate, and ready for analysis whenever you need it.

## Tools

### get_address
Fetch specific address details using a unique ID. This is useful for looking up customer information quickly.

### get_route
Retrieve the details of a specific vehicle route. Use this to check planned paths and stop counts.

### create_address
Add a new customer location to your book by sending a JSON object. This keeps your database current without manual entry.

### get_addresses
Pull a full list of addresses from your Route4Me book. Use this to audit your customer list or find specific locations.

### get_optimizations
Access your history of route optimizations. This helps you review past performance and VRP algorithm results.

### get_routes
List all the active routes currently assigned to your fleet. This gives you a bird's-eye view of current operations.

### get_users
See a list of all drivers and users linked to your account. This helps you manage personnel and permissions.

### get_vehicles
View the list of all registered vehicles in your fleet. Use this to check your current fleet size and availability.

### delete_address
Remove a specific address from your database. This is the quickest way to clean up old or incorrect customer records.

### update_address
Modify the information for an existing customer address. Use this to keep your data accurate as customer needs change.

## Prompt Examples

**Prompt:** 
```
Show me the last 5 route optimizations.
```

**Response:** 
```
### Recent Route Optimizations

| Route ID | Stops | Completion Status |
| :--- | :--- | :--- |
| **OPT-9921** | 42 | Completed |
| **OPT-9918** | 38 | Completed |
| **OPT-9915** | 45 | Completed |
| **OPT-9912** | 31 | Completed |
| **OPT-9909** | 40 | Completed |

*All optimizations were generated using the standard VRP algorithm.*
```

**Prompt:** 
```
Which vehicles do we have in the fleet right now?
```

**Response:** 
```
Checking your registered fleet... Here are your current vehicles:

*   **2020 Ford Transit** (ID: `TR-442`) - *Active*
*   **2018 Toyota Van** (ID: `VN-109`) - *Available*
*   **2022 Mercedes Sprinter** (ID: `SP-001`) - *In Maintenance*
*   **2019 Chevy Express** (ID: `EX-882`) - *Active*
```

**Prompt:** 
```
Add a new stop for a customer at 123 Main St.
```

**Response:** 
```
Done! I've added the new customer coordinate at **123 Main St** to your Route4Me address book. It's now ready for your next route optimization.
```

## Capabilities

### Pull optimization reports
Get historical data on your VRP algorithms to see how routes were performed.

### Add new customer stops
Insert new addresses into your book with a simple request.

### Check fleet availability
See which vehicles are registered and ready to go at any time.

### Update existing addresses
Modify customer details on the fly to keep your records current.

### List all active routes
See every vehicle route currently in your system in one view.

### Manage driver lists
View all associated users and drivers in one place.

## Use Cases

### Adding a last-minute stop
A dispatcher needs to add a new stop. They tell the agent to use `create_address` to put the new coordinate in the book immediately.

### Analyzing weekly performance
An analyst wants to see last week's performance. They ask the agent to pull the latest data from `get_optimizations`.

### Checking fleet availability
A manager wants to see who's available. They ask the agent to list the fleet using `get_vehicles`.

### Cleaning up customer records
A coordinator needs to clean up a list. They ask the agent to remove old entries using `delete_address`.

## Benefits

- Stop manually exporting CSVs to analyze your Route4Me optimization history.
- Add new stops to your address book instantly using `create_address` instead of clicking through menus.
- Get a real-time look at your fleet status with `get_vehicles` without opening a new tab.
- Update customer locations quickly using `update_address` to keep your data current.
- Pull driver lists with `get_users` to see who's on the road at a glance.
- Check specific route details using `get_route` to answer driver questions faster.

## How It Works

The bottom line is you get a conversational interface for your entire Route4Me logistics stack.

1. Grab your API Token from the Route4Me Developer settings.
2. Paste that key into your Vinkius vault.
3. Ask your agent to list your routes or update an address.

## Frequently Asked Questions

**Can Route4Me MCP help me manage my driver list?**
Yes, it allows your AI agent to pull the full list of associated users and drivers from your account instantly. You can check who is on the road or manage permissions without logging into the dashboard.

**How does Route4Me MCP handle my address book?**
The Connector connects directly to your address book. Your agent can list all current addresses, update existing ones, or add new customer stops on the fly.

**Can I use Route4Me MCP to see my optimization history?**
Yes. You can ask your agent to pull reports on previous route optimizations. This is great for reviewing VRP algorithm performance and historical data.

**Is Route4Me MCP good for fleet tracking?**
It is excellent for high-level fleet oversight. You can quickly check which vehicles are registered and see your total fleet status through a simple conversation.

**How do I get my data into the Route4Me MCP?**
You just need to grab your API Token from your Route4Me Developer settings and paste it into your Vinkius vault. From there, your agent can access everything.

**Can Route4Me MCP help with logistics reporting?**
Absolutely. It lets you extract specific optimization and route data into a chat interface, making it much easier to gather info for reports without manual exports.

**Can the agent trigger a new algorithm calculation?**
Currently, the agent is restricted to retrieving existing optimization histories and reading paths to ensure API limits are protected. Address book creations are however supported.

**Is the API key secure across requests?**
Yes. The API key is securely appended to standard HTTPS queries locally during execution time.

**What addresses are retrieved from the book?**
The tool fetches the most recent addresses but allows passing a dynamic parameter to iterate through larger chunks of your system.