# Front MCP

> Front MCP manages shared team communication across email, SMS, and chat. It lets your AI agent track active conversations, list all inboxes, fetch full message histories, and send replies directly—all without leaving your client interface.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** shared-inbox, email-management, team-collaboration, customer-operations, thread-tracking, sms-integration

## Description

Managing customer communications used to mean juggling tabs: checking the support inbox, finding the right thread history, then drafting a reply while keeping track of who owns it. Now, you can handle that whole flow inside your AI agent. This MCP connects your Front account directly, giving your agent the power to act like a full-time operations employee. You'll get real-time visibility into every shared inbox and conversation status, so you never miss an assignment or lose context on a reply. Need to update a ticket from 'open' to 'resolved'? Your agent handles that instantly. It even lets you find all your team members or client contacts before replying. Getting this connected through Vinkius means you only sign up once for the entire catalog, giving you deep control over every communication point.

## Tools

### verify_api_status
Checks your connection to Front to make sure everything is working correctly.

### get_conversation_details
Retrieves basic metadata about a specific customer conversation, like who it’s assigned to.

### get_inbox_details
Fetches general information and status details for an entire shared inbox.

### list_address_book
Pulls a list of all customer contacts stored in your Front account.

### list_all_conversations
Gets a comprehensive list of every conversation existing in your account.

### list_inbox_threads
Lists all the active conversations within a specific shared inbox.

### list_shared_inboxes
Retrieves a list of every shared mailbox your team uses.

### list_conversation_messages
Gets the full, chronological message history for any given conversation thread.

### list_inbox_teammates
Retrieves a list of all team members who have access to your shared inboxes.

### search_conversations
Searches the entire platform for conversations based on criteria like status or keyword.

### send_inbox_reply
Sends a reply to an active conversation thread from your agent interface.

### update_conversation_status
Changes the status of a conversation, such as marking it resolved or assigning it to someone else.

## Prompt Examples

**Prompt:** 
```
List all shared inboxes in my Front account.
```

**Response:** 
```
Retrieving inboxes... I found 3 shared inboxes: 'Support' (ID: inb_123), 'Sales' (ID: inb_456), and 'General Info' (ID: inb_789).
```

**Prompt:** 
```
Search for open conversations in the Support inbox.
```

**Response:** 
```
Searching conversations... I found 4 open conversations matching your query. Two are currently assigned to 'John', and two remain unassigned.
```

**Prompt:** 
```
Archive conversation 'cnv_987'.
```

**Response:** 
```
Conversation updated! I have successfully changed the status of conversation cnv_987 to 'archived'. It will no longer appear in the open queue.
```

## Capabilities

### View and organize shared inboxes
List all team mailboxes and retrieve specific conversations routed to them.

### Search for customer interactions
Find any conversation across your account, checking its current status or who it's assigned to.

### Review full message history
Pull the complete thread history for a specific interaction so you know the whole story before replying.

### Send replies on behalf of the team
Draft and send responses to active conversations directly from your agent chat window.

### Update ticket status automatically
Change a conversation's status (like archiving or reopening) programmatically after resolving an issue.

## Use Cases

### Handling complex billing inquiries
A user needs to respond to a payment question. They first use `search_conversations` to find all open billing issues, then call `list_conversation_messages` on the top result to understand the full history before drafting a response with `send_inbox_reply`.

### Tidying up closed tickets
An ops manager finishes reviewing a week's worth of resolved support issues. They call `list_inbox_threads` to see what was handled, and then run `update_conversation_status` on all completed threads to clear the active queue.

### Onboarding new team members
A manager needs to know who can work in support. They use `list_inbox_teammates` to get a roster of available agents, ensuring accurate assignment before checking if the inbox is already assigned via `get_conversation_details`.

### Getting a client overview
An account manager needs quick visibility on a specific client. They use `list_address_book` to pull contact details, then run `search_conversations` using the client's name to see all recent interactions.

## Benefits

- Never lose context on a reply again. Use the `list_conversation_messages` tool to fetch the entire thread history instantly, so your response is accurate.
- Keep your team focused. You can use `list_shared_inboxes` to see all operational mailboxes in one place and find exactly where an issue landed.
- Automate cleanup tasks. After resolving a ticket, use `update_conversation_status` to archive the conversation right away, keeping the open queue clean.
- Collaborate without leaving your agent. You can send replies using `send_inbox_reply`, making it look like you’re typing directly into Front.
- Know who owns what. Use `search_conversations` and `get_conversation_details` to quickly identify which team member is responsible for a given client issue.

## How It Works

The bottom line is your AI client uses this MCP to speak the language of Front, turning complex backend operations into simple chat commands.

1. Subscribe to this MCP through Vinkius and provide your Front API Token, found in your developer settings.
2. Connect your AI client—whether it's Cursor or Windsurf—using the credentials you just provided.
3. Tell your agent what you need. For example, 'Find all open conversations in the Support inbox that mention billing issues.' The agent executes the command and brings back the data.

## Frequently Asked Questions

**How do I get an API Token for Front?**
Log in to your Front account, click the gear icon (Settings), go to 'Developers' > 'API Tokens', and create a new token with 'Shared Resources' scope.

**Can I search for specific types of conversations?**
Yes, use the 'search_conversations' tool. It accepts standard Front search syntax, such as 'is:open' or 'inbox:support'.

**Is it possible to reply to an email via the agent?**
Yes! Use the 'send_inbox_reply' tool. You must provide the Conversation ID, the message body, and the Teammate ID of the sender.

**How do I archive a conversation?**
Use the 'update_conversation_status' tool and set the status parameter to 'archived'. This updates the global status for the shared inbox.