# Front MCP > Front MCP Server. Manages shared inboxes, tracks conversations, and handles customer communication workflows directly from your AI agent. Use this to list shared inboxes, search open conversations, fetch message history, assign messages, and send replies—all without leaving your chat interface. ## Overview - **Category:** communication-messaging - **Price:** Free - **Tags:** shared-inbox, email-management, team-collaboration, customer-operations, thread-tracking, sms-integration ## Description When you connect your Front account through this MCP Server, your AI agent handles all your shared inbox comms. You'll use it to list all shared inboxes connected to your account, check the status of every inbox with `get_inbox_details`, and grab a complete list of every inbox with `list_shared_inboxes`. You can also see which teammates have access to any shared inbox by calling `list_inbox_teammates`. When you need to track down a conversation, you can list every single conversation in your account with `list_all_conversations` or narrow your search using `search_conversations`, filtering by status or inbox ID. You can also list all the conversation threads inside a specific shared inbox using `list_inbox_threads`. For any single conversation, you can get its metadata with `get_conversation_details` and grab the full message history, keeping all the context, using `list_conversation_messages`. You can also list all your contacts in the workspace by running `list_address_book`. Need to send a reply? You can send a reply to an active conversation thread directly from your agent using `send_inbox_reply`. You can also update a conversation's status—you can change it to 'archived' or 'open' or reassign the owner—by calling `update_conversation_status`. Finally, you can check the health of the connection to the Front API using `verify_api_status`. ## Tools ### get_conversation_details Retrieves metadata for a single customer conversation. ### get_inbox_details Retrieves metadata for a specific shared inbox. ### list_address_book Retrieves a list of all contacts in your workspace. ### list_all_conversations Lists every conversation in your account, regardless of its current status. ### list_conversation_messages Fetches the full, chronological list of messages within a conversation thread. ### list_inbox_teammates Lists all team members who have access to the shared inbox. ### list_inbox_threads Lists all conversation threads within a specific shared inbox. ### list_shared_inboxes Retrieves a list of all shared inboxes connected to your account. ### search_conversations Searches all conversations using specific filters like inbox ID or status (open/archived). ### send_inbox_reply Sends a reply to an active conversation thread. ### update_conversation_status Changes the status (open/archived) or reassigns the owner of a conversation. ### verify_api_status Checks if the connection to the Front API is currently active and working. ## 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 ### Get Inbox Details Retrieves metadata for a specific shared inbox, giving you an overview of its current state. ### List Shared Inboxes Gathers a complete list of all shared inboxes connected to your Front account. ### Search and Filter Conversations Searches across all conversations, allowing you to filter by status (open/archived) or assignment. ### Fetch Message History Retrieves the full, chronological message thread for any given conversation ID, maintaining context. ### Send a Reply Drafts and sends a reply to an active conversation directly from your AI agent. ### Update Conversation Status Changes the status of a conversation (e.g., to 'archived' or 'open') or reassigns it to a different teammate. ## Use Cases ### Client has a complex, multi-touchpoint issue. A support agent gets a ticket. They need the full background. They run `list_conversation_messages` to pull the complete thread history, then check `get_conversation_details` for the latest status. They use this context to write a perfect reply via `send_inbox_reply`, closing the loop without switching tabs. ### The team needs to clear out old, resolved tickets. The operations manager runs `list_shared_inboxes` to see all channels. They then use `search_conversations` to find all tickets marked 'resolved' and run `update_conversation_status` to archive them. The inboxes stay clean and actionable. ### Quickly checking a client's communication status. An account manager needs to know if a client replied to a follow-up. They use `get_conversation_details` to check the current status and thread owner. This saves them from having to log into the main platform just for a status check. ### Routing a ticket to the right expert. A support agent spots a new issue in the 'Billing' inbox. They use `list_inbox_teammates` to confirm who is available for billing issues and then use `update_conversation_status` to reassign the ticket to the correct person. ## Benefits - See the full context of a client issue instantly. Instead of manually navigating to a ticket, run `list_conversation_messages` to fetch the entire message history, no matter how long the thread is. You're ready to reply immediately. - Keep your inboxes clean with automation. Use `update_conversation_status` to programmatically archive resolved tickets or reassign them, keeping your team focused only on open, actionable items. - Never lose track of who owns what. Run `search_conversations` to find open issues, filtering specifically by status or the assigned owner, so you know exactly who needs to take action. - Collaborate on replies without leaving your tool. Use `send_inbox_reply` to draft and send a response on behalf of a teammate, keeping the workflow contained within your AI chat. - Get a quick overview of all operational channels. Run `list_shared_inboxes` to list every inbox connected to your account, ensuring your agent knows where to look for client comms. - Build out a complete contact list. Use `list_address_book` to pull contact details and teammate lists (`list_inbox_teammates`) before sending a targeted message, guaranteeing accurate routing. ## How It Works The bottom line is, your AI agent talks to Front using these tools, so you don't have to copy-paste data or switch screens. 1. Subscribe to the Front MCP Server on the Vinkius Marketplace and provide your Front API Token. 2. Your AI client calls a specific tool, like `list_shared_inboxes`, to begin the workflow. 3. The server executes the API call, returns the structured data (e.g., a list of inboxes), and your AI agent uses that data to proceed with the task (e.g., searching a specific inbox). ## Frequently Asked Questions **How do I use the list_shared_inboxes tool with Front MCP Server?** You call `list_shared_inboxes` to get a list of all operational inboxes. This is the first step if you don't know which inbox holds the conversation you're looking for. **Can I search for a conversation using the search_conversations tool?** Yes. You provide filters like the inbox ID or status (e.g., 'open'). The tool runs a targeted search, returning only the relevant conversation IDs. **Does send_inbox_reply require the conversation ID?** Yes. The `send_inbox_reply` tool requires an active conversation ID to know where the reply should go. You can get this ID first using `get_conversation_details`. **How do I mark a ticket as resolved using update_conversation_status?** You use `update_conversation_status` and pass the conversation ID along with the desired new status (e.g., 'archived'). This updates the record immediately. **What is the difference between list_all_conversations and list_inbox_threads?** `list_all_conversations` lists everything in your account. `list_inbox_threads` limits the list to only the conversations within a specific, targeted shared inbox. **How do I use the list_inbox_teammates tool to find a colleague's details?** It lists all workspace teammates. This helps you confirm who owns a conversation or find a teammate's name for accurate replies. **When should I use the list_conversation_messages tool to get the full context?** Use this tool to pull the complete message history. It ensures you have all the context needed before drafting a reply or making a status update. **Does the update_conversation_status tool accept specific status values?** Yes, it accepts defined statuses (like 'archived', 'open', or 'resolved'). You must provide the conversation ID and the desired new status. **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.