> This page is for Agent Handler. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.merge.dev/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server. # Front **Authentication:** OAuth or API token. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app. ## Sample use cases * Show me every conversation in the `Support` inbox tagged `escalation` and unassigned. * Reply to every conversation in `Sales` with a follow-up template after 3 days of silence. * Pull the average response time for the support team this week. ## Available Tools #### list\_accounts List company accounts with optional sorting. Accounts represent companies/organizations in your CRM. #### get\_account Get a specific company account by ID, including name, description, domains, and custom fields. #### create\_account Create a new company account with name, description, domains, external ID, and custom fields. #### update\_account Update a company account's name, description, domains, external ID, or custom fields. #### delete\_account Delete a company account permanently. This cannot be undone. #### get\_account\_contacts Get all contacts associated with a company account. #### add\_account\_contact Associate a contact with a company account. #### remove\_account\_contact Remove a contact's association with a company account. #### list\_teams List all teams in the workspace, including their inboxes and members. #### get\_team Get a specific team by ID, including name, inboxes, and members. #### list\_channels List all channels in the workspace (email, twilio, twitter, facebook, intercom, custom, etc.). #### get\_channel Get a specific channel by ID, including type, address, send-as, and settings. #### update\_channel Update a channel's name or settings. Settings vary by channel type. #### get\_comment Get a specific internal comment by ID, including body, author, and attachments. #### create\_comment Create an internal comment on a conversation. Comments are team notes not visible to customers. #### get\_comment\_mentions Get all @mentions in a comment, including mentioned teammates. #### list\_contacts List contacts in Front with optional search query. Supports sorting and pagination. #### get\_contact Get a specific contact by ID, including all handles, groups, and custom fields. #### create\_contact Create a new contact with handles (email, phone, twitter, etc.), name, and custom fields. #### update\_contact Update a contact's name, description, avatar, spammer status, links, groups, or custom fields. #### delete\_contact Delete a contact permanently. This cannot be undone. #### merge\_contacts Merge multiple contacts into a single target contact. Source contacts will be deleted. #### get\_contact\_conversations Get all conversations associated with a contact. #### add\_contact\_handle Add a new handle (email, phone, twitter, etc.) to an existing contact. #### delete\_contact\_handle Remove a handle from a contact. The contact must have at least one handle remaining. #### get\_contact\_notes Get all notes attached to a contact. #### add\_contact\_note Add a note to a contact for internal documentation. #### list\_conversations List conversations in Front with optional filtering by inbox, tag, status, or assignee. Supports pagination. #### get\_conversation Get a specific conversation by ID, including subject, status, assignee, tags, and metadata. #### update\_conversation Update a conversation's assignee, inbox, status, or tags. Use status 'archived' to archive, 'open' to reopen. #### search\_conversations Search conversations using Front's search syntax. Supports advanced queries like 'from:[email@example.com](mailto:email@example.com)' or 'is:unassigned'. #### add\_conversation\_tag Add a tag to a conversation for categorization and filtering. #### remove\_conversation\_tag Remove a tag from a conversation. #### get\_conversation\_messages Get all messages in a conversation thread, including inbound and outbound messages. #### get\_conversation\_comments Get internal comments on a conversation (team notes not visible to customers). #### get\_conversation\_followers Get teammates who are following a conversation for updates. #### add\_conversation\_follower Add a teammate as a follower to receive notifications about a conversation. #### remove\_conversation\_follower Remove a teammate from following a conversation. #### get\_conversation\_inboxes Get all inboxes a conversation is shared with. #### list\_inboxes List all inboxes in the workspace, including private and public inboxes. #### get\_inbox Get a specific inbox by ID, including name, address, and send-as settings. #### create\_inbox Create a new shared inbox with a name and optional teammate assignments. #### get\_inbox\_conversations Get conversations in a specific inbox with optional search and status filter. #### get\_inbox\_channels Get all channels connected to a specific inbox (email, chat, social, etc.). #### get\_inbox\_teammates Get all teammates who have access to a specific inbox. #### add\_inbox\_teammates Add teammates to an inbox, giving them access to view and respond to conversations. #### remove\_inbox\_teammates Remove teammates from an inbox, revoking their access to the inbox's conversations. #### get\_message Get a specific message by ID, including body, recipients, attachments, and metadata. #### send\_message Send a new message through a channel (email, SMS, etc.) to specified recipients. #### reply\_to\_conversation Reply to an existing conversation. The reply will be sent through the conversation's channel. #### import\_message Import an external message into Front with an external ID for deduplication. Creates a new conversation. #### list\_tags List all tags in the workspace, including private tags and their visibility settings. #### get\_tag Get a specific tag by ID, including name, description, highlight color, and visibility. #### create\_tag Create a new tag with name, description, highlight color, and visibility settings. #### update\_tag Update a tag's name, description, highlight color, or visibility settings. #### delete\_tag Delete a tag permanently. Conversations will keep their tag history. #### get\_tag\_conversations Get all conversations that have a specific tag applied, with optional search. #### list\_child\_tags Get all child tags nested under a parent tag. #### create\_child\_tag Create a new child tag under a parent tag for hierarchical organization. #### list\_teammates List all teammates in the workspace, including admins, available status, and blocked status. #### get\_teammate Get a specific teammate by ID, including email, username, admin status, and availability. #### update\_teammate Update a teammate's username, name, or availability status. #### get\_teammate\_conversations Get conversations assigned to a specific teammate with optional search and status filter. #### get\_teammate\_inboxes Get inboxes accessible to a specific teammate. #### get\_teammate\_tags Get tags accessible to a specific teammate.