# Navisphere MCP

> Navisphere connects your freight account directly to any AI client. It lets you search for available loads by location and equipment, submit bids instantly, estimate spot market rates, create new shipments, and track every milestone from pickup to delivery—all through conversation.

## Overview
- **Category:** shipping-logistics
- **Price:** Free
- **Tags:** freight, ch-robinson, trucking, shipment-tracking, logistics-automation

## Description

# Navisphere MCP Server

This server hooks your freight account right up to your AI client. It manages every move in logistics—from finding available loads and figuring out prices, to placing bids and tracking the whole damn thing until it hits its final stop. You handle all this stuff just by talking to your agent.

**Finding Loads and Setting Rates**

You can search the network for specific freight loads using **`search_available_loads`**. Just give it an origin, a destination, and what kind of equipment you need—it pulls up everything that fits. Once you spot a load ID you're interested in, you pull up the full scoop on it with **`get_load_details`**, which gives you all the nuts and bolts of that particular freight requirement. Before you commit to anything, you can run a market query using **`get_rate_estimate`**. This tool tells you what a shipment rate *should* be for that lane right now—it's your gut check before bidding.

When you know the value, you can jump into action. You submit your price on specific loads with **`submit_bid`** when you want to bid up a load ID. If another carrier sends you an offer through your account, you accept it instantly using **`accept_offer`**. This lets you manage multiple offers without leaving the chat window.

**Booking and Setting Up Shipments**

Need to start a whole new shipment? You create the record right away with **`create_shipment`**, feeding in all the necessary customer API data. For visibility, you can set up real-time alerts using **`subscribe_webhooks`**. This means your AI client gets hit with notifications about critical events on certain loads or shipments as they happen.

**Tracking and Status Management**

For active freight, tracking is a multi-step process. To get the general idea of where things are, you check the known customer shipment ID using **`track_shipment`**. This gives you all the main milestones—the big picture stuff. But if you need to know what just happened, you run **`get_tracking_events`**, which pulls high-frequency, granular updates for an active load ID, telling you exactly when and where it moved last.

When a shipment hits key operational points, you update the status directly using **`update_shipment_status`**. You mark things like 'Loaded' or 'Departed,' keeping your internal records accurate. The system also handles documentation; you attach all required paperwork—like Proofs of Delivery (PODs) and Bills of Lading (BOLs)—to a specific active shipment record using **`upload_shipment_documents`**. This keeps your compliance solid and the billing clean.

**How It Works When You Use It**

Your AI client acts as the interface, running these tools based on your conversational commands. If you tell it, 'Find me a load from Miami to Atlanta,' it executes **`search_available_loads`**. If you follow up with, 'Bid $3,500 on that one,' it fires off **`submit_bid`** against the specific load ID found moments before. It keeps all these steps connected so you don't gotta manually jump between a dozen different screens. You just talk to your agent, and it makes the connections in the background.

## Tools

### accept_offer
Accepts a specific freight offer that was extended to your carrier account.

### create_shipment
Creates a new shipment record within the system using customer API data.

### get_load_details
Retrieves complete, detailed information for one specific available freight load ID.

### get_rate_estimate
Queries the market to provide an instant estimate of what a shipment rate should be.

### get_tracking_events
Fetches high-frequency, granular tracking updates for a specific active shipment ID.

### search_available_loads
Searches the network for freight loads based on user-defined criteria like origin and destination.

### submit_bid
Submits a specific dollar amount bid against a particular available load ID.

### subscribe_webhooks
Sets up real-time notifications for visibility events on certain shipments or loads.

### track_shipment
Gets the current status and general milestones for a known, existing customer shipment ID.

### update_shipment_status
Changes the operational status of an assigned shipment to mark key points like 'Loaded' or 'Departed'.

### upload_shipment_documents
Attaches required documents—like PODs and BOLs—to a specific active shipment record.

## Prompt Examples

**Prompt:** 
```
Search for available loads from Chicago, IL to Dallas, TX for a Van (V).
```

**Response:** 
```
I found 3 available loads matching your criteria. The most relevant is Load #882910, picking up tomorrow with a weight of 42,000 lbs. Would you like the full details or to submit a bid?
```

**Prompt:** 
```
Submit a bid of 1500 USD for load 882910. Contact is John Doe.
```

**Response:** 
```
Bid successfully submitted! Your offer of $1,500 USD for Load #882910 has been recorded under John Doe. I will notify you if the status changes.
```

**Prompt:** 
```
Track shipment ID 992288 and show me the latest ETA.
```

**Response:** 
```
Shipment 992288 is currently 'In Transit'. The latest milestone was 'Departed Chicago Terminal' at 08:00 AM. The estimated arrival in Dallas is tomorrow at 04:30 PM.
```

## Capabilities

### Search and Identify Available Loads
Run searches to find specific freight loads based on criteria like origin, destination, and required equipment type.

### Calculate Live Rate Estimates
Query the market for immediate rate estimates using lane data before committing to a bid or booking.

### Manage Bids and Offers
Submit pricing bids on available loads, or accept offers sent through your carrier account.

### Book and Track Shipments
Create new shipment records and monitor their status using real-time tracking events and milestones.

### Process Documentation
Upload required paperwork (PODs, BOLs) directly to a shipment record for compliance and billing.

## Use Cases

### Securing a new lane quickly
A dispatcher needs freight from Miami to Atlanta for a Flatbed trailer. They ask their agent, who runs `search_available_loads`. The agent returns three options; the user asks for pricing, triggering `get_rate_estimate`. Satisfied with the quote, they use `submit_bid` immediately.

### Handling a late-arriving shipment
The logistics coordinator needs to know where Shipment ID 992288 is. They ask their agent, which calls `get_tracking_events`. The agent reports the last known location and ETA. The user then uses `update_shipment_status` to mark it as 'Arrived' once they physically check it in.

### Completing paperwork after delivery
The carrier finished a drop-off but forgot the Proof of Delivery (POD). They ask their agent to attach the document. The agent prompts for the shipment ID and executes `upload_shipment_documents`, filing the record immediately.

### Booking an entire route
A supply chain manager needs to book three loads in a week. They ask the agent, who runs `search_available_loads` repeatedly for different dates and locations. Once confirmed, they use `create_shipment` for each load ID.

## Benefits

- Find loads faster. Instead of jumping between multiple web portals to find open freight, the agent runs `search_available_loads` instantly based on your spoken criteria.
- Know your pricing upfront. Use `get_rate_estimate` before you bid or book anything. This prevents accepting suboptimal loads that might cost too much later.
- Close the loop fast. Once a load is accepted, use the agent to run `create_shipment` and immediately follow up by uploading documents with `upload_shipment_documents`. No manual data entry required.
- Never miss an update. Instead of logging into 5 different tracking pages, you get real-time milestones for every shipment using `get_tracking_events` or `track_shipment` directly in the chat.
- Streamline bidding. The system handles the whole cycle: from finding a load with `search_available_loads`, to submitting your bid via `submit_bid`, all before you hit send.

## How It Works

The bottom line is: you manage complex, multi-step logistics processes using plain conversation instead of multiple web portals and manual form filling.

1. Subscribe to the server and input your Navisphere Client ID and Client Secret.
2. Your AI client connects using these credentials, granting it permission to access live load data and execute transactions on your behalf.
3. You talk naturally to your agent—'Find loads from Chicago to Dallas for a Van.'—and the agent runs the necessary tools in sequence.

## Frequently Asked Questions

**How does Navisphere MCP Server help with finding loads?**
It uses the `search_available_loads` tool. You just tell your agent the origin, destination, and equipment type (V, R, F, etc.), and it returns live listings.

**Can I track an old shipment using Navisphere MCP Server?**
Yes, you can use `track_shipment` or the more detailed `get_tracking_events`. You just need to provide the correct customer shipment ID to get the latest milestones.

**What’s the process for bidding on a load?**
First, use `search_available_loads` to find the load ID. Then, ask your agent to run `get_rate_estimate`. If you're ready, tell it to submit the bid using `submit_bid`.

**How do I record proof of delivery with Navisphere MCP Server?**
You use the `upload_shipment_documents` tool. You need to provide the shipment ID and then upload the required documents (like PODs) through your conversation.

**Can I create a new shipment record with Navisphere MCP Server?**
Yes, you use the `create_shipment` tool. You just provide the necessary customer and route details, and the agent handles the record creation in the system.

**How do I get a rate estimate using the `get_rate_estimate` tool?**
You submit the required lane and equipment data directly to the server. It returns instant spot market or contract rate estimates, helping you price loads before bidding.

**Can I subscribe to real-time updates with `subscribe_webhooks`?**
Yes, subscribing via `subscribe_webhooks` allows your agent to receive live visibility events. You get automated alerts on shipment status changes without constantly polling the API.

**What is the process for updating a shipment's status using `update_shipment_status`?**
You use `update_shipment_status` by providing the shipment ID and the desired status (like Arrived, Loaded, or Departed). This keeps your records accurate and up-to-date.

**How do I find available loads for a specific route and equipment type?**
Use the `search_available_loads` tool. You can filter by `originCity`, `destinationCity`, and `equipmentType` (e.g., 'V' for Van, 'R' for Reefer) to see all matching freight opportunities.

**Can I update the location and status of a shipment while in transit?**
Yes! Use the `update_shipment_status` tool with the `shipmentId`. You can provide a JSON object containing the new status code (e.g., 'Arrived') and current GPS coordinates.

**How do I submit a price bid for a load I found?**
Use the `submit_bid` tool. Provide the `loadNumber`, your `bidAmount`, the `currency`, and a `contactName`. The system will register your offer directly in the Navisphere ecosystem.