# Help Scout MCP for AI Agents AI Agent Connect

> Help Scout MCP connects your help desk to your AI agent to handle customer support tasks automatically. You can manage conversations, search history, and update customer statuses without switching tabs. It turns your AI into a support coordinator that handles the heavy lifting of ticket management and team updates, letting you focus on solving actual problems.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_359IhRH0GHVoIqv40EQ8D8IUs0rCobfoHdNAfX5I/ai-agent-connect
- **Tags:** shared-inbox, customer-experience, support-automation, live-chat, knowledge-base, conversation-tracking

## Description

Managing a help desk usually means jumping between tabs to check ticket statuses, find old customer threads, and leave internal notes for your team. It's a constant cycle of copy-pasting data and manual updates that eats up your day. This Connector changes that by letting your AI agent do the clicking for you. Instead of manually searching for a customer's history, you can just ask your agent to pull up their full profile and summarize their last three interactions. You can have your agent monitor incoming queries in specific mailboxes, update ticket statuses from active to pending, and tag conversations as they come in. It helps your team stay focused on solving problems rather than moving data around. Because it's part of the Vinkius catalog, you get a clean way to plug this functionality into your existing AI workflow. You'll stop worrying about the logistics of ticket management and start spending more time on the actual customer experience. Your AI becomes a dedicated support coordinator that handles the tedious parts of the job while you handle the high-level strategy.

## Tools

### get_conversation
Get full details for a specific thread. Use this to see the complete transcript of a single issue.

### list_conversations
Get a list of all support tickets. Use this to monitor incoming customer queries quickly.

### list_mailboxes
View all your configured support mailboxes. Check which inboxes are active and where messages are landing.

### list_tags
See all available tags. Use these to categorize conversations and organize your help desk.

### list_customer_ratings
See recent customer satisfaction ratings. Use this to track the health of your support operations.

### list_staff_users
See all support agents in your account. Use this to check who is on the team.

### update_convo_status
Change a conversation status. Move tickets between active, pending, and closed states.

### create_convo_note
Add a private internal note. Share updates with your team without the customer seeing them.

### get_customer
Get a detailed customer profile. Access historical interactions and account details in one go.

### list_customers
See every customer in your help desk. This helps you find specific profiles for personalized service.

### list_workflows
View your automated support workflows. See exactly how your help desk automates tasks.

### search_conversations
Search your entire conversation history. Find specific answers or past issues using a query.

## Prompt Examples

**Prompt:** 
```
Check the status of the refund request from Sarah Jenkins.
```

**Response:** 
```
I've looked into the refund request for Sarah Jenkins. Here's the current status:

**Status:** Active
**Last Update:** 2 hours ago
**Latest Note:** 'Waiting on warehouse confirmation.'

**Customer History:**
* Refund Request (Active)
* Shipping Inquiry (Closed)

Would you like me to update the status to 'Pending' or add a new note?
```

**Prompt:** 
```
Summarize the last 3 interactions for customer #8821.
```

**Response:** 
```
Here is the recent history for customer #8821:

1. **Billing Issue:** Customer reported a double charge on Oct 12. (Resolved)
2. **Login Trouble:** Customer couldn't access account on Oct 15. (Resolved)
3. **Feature Request:** Asked about dark mode integration on Oct 20. (Active)

The customer seems frustrated with billing but is generally happy with the product.
```

**Prompt:** 
```
List all active conversations in the 'Support' mailbox.
```

**Response:** 
```
I've pulled the active conversations from the Support mailbox:

| Ticket ID | Customer | Subject |
| --- | --- | --- |
| 4421 | John Doe | 'API Connection Error' |
| 4425 | Jane Smith | 'Subscription Cancelled' |
| 4429 | Mike Ross | 'Missing Package' |

There are 3 active threads. Which one should we look at first?
```

## Capabilities

### Monitor active support threads
Get a real-time list of all conversations requiring attention in your help desk.

### Pull up full customer profiles
Access detailed history and account information for any customer instantly.

### Update ticket statuses automatically
Move conversations between active, pending, and closed states using natural language.

### Add private team notes
Log internal updates that only your team can see without bothering the customer.

### Search through old conversation history
Find specific past answers or issues across your entire history using a simple query.

### Track customer satisfaction ratings
Retrieve recent ratings to see how your team is performing in real time.

## Use Cases

### Finding past refund details
A customer asks for a refund on an old order. Use search_conversations to find the original order and get_customer to see their history before responding.

### Logging technical bugs privately
An agent needs to tell the engineering team about a bug. Use create_convo_note to log the technical details privately on the ticket.

### Monitoring team capacity
A support lead needs to check if the team is overwhelmed. Use list_conversations and list_staff_users to see the volume of active tickets vs. available agents.

### Auditing automation rules
A manager wants to see if the new automation is working. Use list_workflows to review the current automated support rules.

## Benefits

- Stop manual ticket searching by using search_conversations to find past answers instantly.
- Keep your team aligned by using create_convo_note to leave internal updates that customers can't see.
- Improve response times by using update_convo_status to move tickets through your pipeline faster.
- Get a bird's-eye view of your help desk by using list_mailboxes and list_tags to see everything in one place.
- Monitor customer happiness by using list_customer_ratings to see how your team is performing.

## How It Works

The bottom line is your AI becomes a hands-on support coordinator that manages your help desk in real-time.

1. Subscribe to the Help Scout MCP in the Vinkius catalog.
2. Enter your Help Scout OAuth Access Token into your preferred AI client.
3. Ask your agent to list conversations, search history, or update ticket statuses.

## Frequently Asked Questions

**Can I use the Help Scout MCP to send emails to my customers?**
No, this Connector is for managing your help desk. It lets your agent update statuses and notes within Help Scout, but it doesn't send new outgoing emails.

**Does the Help Scout MCP work with my existing account?**
Yes, it connects directly to your current help desk using your OAuth token, so all your existing customers and conversations are accessible.

**Can my AI agent see my private team notes with the Help Scout MCP?**
Yes, your agent can read and create internal notes using the note tool, which keeps your internal team communication private from the customer.

**How do I find a specific customer's history using the Help Scout MCP?**
You can just ask your agent to search for a customer by name or email. It will use the search capabilities to find their profile and previous interactions.

**Can I use the Help Scout MCP to track my team's performance?**
Yes, you can ask your agent to list recent customer ratings or check the status of active conversations to see how the team is handling the queue.

**What happens to my data when I connect the Help Scout MCP?**
Your AI client interacts with Help Scout through the Connector. Your data stays within the Help Scout ecosystem and is accessed only when you ask your agent to perform an action.

**How do I get my Help Scout Access Token?**
You can generate an OAuth2 Access Token by creating an application in the **Help Scout Developer Portal** (developer.helpscout.com). Alternatively, if you are using a personal script, you can use the Client Credentials flow to obtain a token.

**Can I add internal notes to conversations?**
Yes! Use the `create_convo_note` tool. You must provide the `conversation_id` and the text of your note. This allows you to collaborate with your team without the customer seeing the message.

**How do I change the status of a support thread?**
Use the `update_convo_status` tool. Provide the conversation ID and the new status (active, pending, or closed). This helps you keep your mailbox organized.

**Is the integration secure for managing support data?**
Absolutely. The integration uses industry-standard OAuth 2.0 Bearer tokens over HTTPS. Your credentials are encrypted and stored securely within the Vinkius Cloud infrastructure.