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)

  1. In Dust, go to Spaces → Tools and click Add Tools.
  2. Select Front from the list of available tools.
  3. 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):

ScopeRequired for
conversations:readList conversations, Search conversations
messages:readList conversation messages
contacts:readGet contact
tags:readList tags, Get tag
teammates:readList teammates

Write scopes (required for write operations):

ScopeRequired for
messages:sendCreate message / send reply
comments:writeAdd comment
drafts:writeCreate draft
conversations:writeUpdate conversation (status, assignee)
tags:writeAdd 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

ToolDescription
search_conversationsSearch conversations by query, including full-text and filter-based search.
get_conversationRetrieve details of a specific conversation by ID.
get_conversation_messagesList all messages in a conversation.
get_contactRetrieve a contact's profile details.
get_customer_historyRetrieve conversation history for a contact.
list_tagsList all available tags in the workspace.
list_teammatesList all teammates (agents) in the workspace.
list_inboxesList all inboxes the token has access to.
create_conversationCreate a new outbound conversation.
create_draftCreate a draft reply for a conversation.
add_commentAdd an internal comment to a conversation.
add_tagsAdd tags to a conversation.
add_linksAdd external links to a conversation.
send_messageSend a reply message in a conversation.
update_conversation_statusUpdate the status of a conversation (e.g., archive, reopen).
assign_conversationAssign a conversation to a teammate or unassign it.