Front
Tools to search conversations, read messages and contacts, manage tags and assignments, and send replies or comments in Front.
Overview
The Front MCP enables agents to interact with your Front workspace. Agents can search conversations, read messages and contact details, manage tags and assignments, and send replies or comments — supporting customer communication workflows directly from Dust.
Connection Setup (Admin)
- In Dust, go to Spaces → Tools and click Add Tools.
- Select Front from the list of available tools.
- Paste your Front Personal Access Token into the field provided and save.
You can generate a Personal Access Token in Front under Settings → Integrations → API. See the Front API documentation for details.
Once connected, the Front toolset will be available to add to agents in the spaces you grant access to.
Authentication
Front authenticates requests using a Bearer token:
Authorization: Bearer <TOKEN>
See the Front API Introduction for authentication details.
Required Token Scopes
When generating a Personal Access Token in Front, enable the minimum set of scopes that match the tools you plan to use.
Read scopes (required for read operations):
| Scope | Required for |
|---|---|
conversations:read | List conversations, Search conversations |
messages:read | List conversation messages |
contacts:read | Get contact |
tags:read | List tags, Get tag |
teammates:read | List teammates |
Write scopes (required for write operations):
| Scope | Required for |
|---|---|
messages:send | Create message / send reply |
comments:write | Add comment |
drafts:write | Create draft |
conversations:write | Update conversation (status, assignee) |
tags:write | Add or replace tags on conversations |
Apply only the scopes needed by the tools you enable. If your deployment only requires reading conversations, omit all write scopes.
Available Tools
| Tool | Description |
|---|---|
| search_conversations | Search conversations by query, including full-text and filter-based search. |
| get_conversation | Retrieve details of a specific conversation by ID. |
| get_conversation_messages | List all messages in a conversation. |
| get_contact | Retrieve a contact's profile details. |
| get_customer_history | Retrieve conversation history for a contact. |
| list_tags | List all available tags in the workspace. |
| list_teammates | List all teammates (agents) in the workspace. |
| list_inboxes | List all inboxes the token has access to. |
| create_conversation | Create a new outbound conversation. |
| create_draft | Create a draft reply for a conversation. |
| add_comment | Add an internal comment to a conversation. |
| add_tags | Add tags to a conversation. |
| add_links | Add external links to a conversation. |
| send_message | Send a reply message in a conversation. |
| update_conversation_status | Update the status of a conversation (e.g., archive, reopen). |
| assign_conversation | Assign a conversation to a teammate or unassign it. |
Updated about 12 hours ago
