# Happyrobot MCP

> Happyrobot connects your AI agent directly into Happyrobot's CRM and communication platform. It lets you track complex logistics status updates, summarize call logs across time periods, and instantly retrieve customer records by calling `happyrobot_info`. Stop manually checking carrier dashboards; let your agent handle the full lifecycle of customer interactions from data retrieval to status reporting.

## Overview
- **Category:** crm-sales
- **Price:** Free
- **Tags:** automation, integrations

## Description

This MCP connects your AI client directly into Happyrobot. You use it when you need to manage complex customer relationships or track logistics details without logging into multiple portals. Instead of juggling spreadsheets and manual follow-up calls, your agent pulls the necessary information—like current load statuses or past communication logs—and synthesizes it for you. For example, if a client needs an update on a shipment that stalled three days ago, your agent can check all pending carrier requests and summarize the history instantly. This level of automation is what Vinkius provides: access to critical business functions from any compatible AI agent. You get structured data retrieval, automated status checks, and comprehensive reporting all in one conversation.

## Tools

### happyrobot_info
Gets general information about the client or load from Happyrobot.

## Prompt Examples

**Prompt:** 
```
Trigger a check-call for load #1045.
```

**Response:** 
```
I have triggered an automated check-call to the carrier assigned to load #1045. I will update the status once the call is complete and the driver's location is confirmed.
```

**Prompt:** 
```
List all pending inbound requests from carriers today.
```

**Response:** 
```
There are currently 4 pending inbound requests from carriers regarding load statuses. You can find their details in the active communications dashboard.
```

**Prompt:** 
```
Summarize the call logs for the past 24 hours.
```

**Response:** 
```
Over the last 24 hours, Happyrobot successfully completed 125 check-calls and received 42 inbound queries. 94% of outbound calls resulted in successful status updates.
```

## Capabilities

### Get general company information
Retrieves core details about the client or load through `happyrobot_info`.

### List pending carrier requests
Gathers a list of all incoming communication requests from carriers for the current day.

### Check specific shipment status
Triggers automated check-calls to confirm the location and status of a particular load number.

### Summarize historical call data
Consolidates communication records over a defined time period, showing calls made and received.

### Identify communications gaps
Analyzes pending requests to show where the supply chain process is currently blocked or stalled.

## Use Cases

### The Shipment Status Panic
A logistics coordinator needs to know why Load #1045 is delayed. Instead of calling three different people, they ask their agent to 'Trigger a check-call for load #1045.' The system handles the call and reports back the updated status immediately.

### The Weekly Sales Review
An account manager needs talking points for a client meeting. They ask their agent to 'Summarize the call logs for the past 24 hours.' The system provides a clean report showing successful calls and queries received.

### The New Client Onboarding
A support lead needs to understand a client's history. They prompt the agent to 'List all pending inbound requests from carriers today,' providing an instant overview of communication gaps.

## Benefits

- Stop manual tracking. Instead of logging into carrier portals to see if a load is moving, you can trigger an automated check-call for a specific load number.
- Consolidate reporting. The MCP summarizes call logs over time, telling you exactly how many successful calls were made and what percentage resulted in status updates.
- Identify bottlenecks fast. You can list all pending inbound requests from carriers today, immediately showing where the communication chain has broken down.
- Streamline account history. Use `happyrobot_info` to quickly retrieve client records without asking your agent five different questions about who they are or what services they used.
- Coordinate complex outreach. By connecting these tools, you let your agent manage the entire sales pipeline, from initial data retrieval to final status confirmation.

## How It Works

The bottom line is: your AI client handles the messy API calls; you just get the final answer.

1. Tell your agent exactly what data you need, like 'List all carriers with pending requests today.'
2. The MCP executes the necessary tool call (e.g., listing pending requests) and pulls raw status reports from Happyrobot.
3. Your agent processes that raw data, giving you a clean summary of statuses, successful calls, or specific next steps.

## Frequently Asked Questions

**What is Happyrobot?**
Happyrobot is an AI-powered voice and communication platform specifically built for the logistics and freight industry, designed to automate routine check-calls, status updates, and supply chain operations.

**Where can I find my API credentials?**
You can find your API credentials in the Happyrobot dashboard under the Developer or Integrations settings. You will need your API key to authenticate requests.

**Can I trigger automated calls via this integration?**
Yes, you can initiate automated outbound check-calls and manage voice interactions through the API by specifying the target load or carrier information.

**When running `happyrobot_info`, how do I specify a unique load number or tracking ID?**
You provide the specific identifier directly as an argument to the tool call. The system uses this explicit input (like a load #) to pull data only for that single, precise record.

**If `happyrobot_info` cannot find any records for a given client, what error message should I anticipate?**
It returns a clear status code along with an explanatory message. This lets your agent process the lack of data gracefully instead of failing the entire workflow.

**Are there rate limits if I call `happyrobot_info` many times in quick succession?**
The platform manages standard usage rates, but extremely high volumes might require adjusting your agent's request cadence. Always check Vinkius for the most current throughput guidelines.

**What types of data fields does `happyrobot_info` pull when summarizing customer interactions?**
It retrieves comprehensive records, including recent activity logs, status updates, and communication history summaries. This gives your agent full context for making decisions.

**Does using `happyrobot_info` access all my client data, or are permissions restricted?**
The tool respects the permissions set up within your Happyrobot account. It will only return specific data fields that your connected user role has been explicitly granted visibility to.