Every capability is a discrete, logged action the agent calls by name — scoped to what you authorize and recorded in the run trace.
Create Chat HandleHELP_SCOUT_CREATE_CHAT_HANDLE
Tool to create a chat handle for a Help Scout customer. Use when you need to add a chat platform username (like Skype, AIM, Yahoo) to a customer's profile.
Create Chat ThreadHELP_SCOUT_CREATE_CHAT_THREAD
Tool to create a new chat thread on a Help Scout conversation. Use when adding a chat message to an existing conversation. Note: Conversations can have a maximum of 100 threads. Non-imported threads automatically reopen closed conversations.
Create ConversationHELP_SCOUT_CREATE_CONVERSATION
Tool to create a new conversation in Help Scout. Use when creating email, phone, or chat conversations with customer threads.
Create CustomerHELP_SCOUT_CREATE_CUSTOMER
Tool to create a new customer in Help Scout with contact details and profile information. Use when you need to add a new customer with emails, phones, addresses, or other contact data.
Tool to create a customer property definition in Help Scout. Use when you need to add custom fields to track additional customer information like subscription plan, tier level, or custom attributes. Maximum 50 customer property definitions per company.
Tool to create a new customer thread on a Help Scout conversation. Use when a customer needs to add a message to an existing conversation. The conversation will reopen unless imported mode is enabled. Conversations are limited to 100 threads maximum.
Tool to create a website entry for a customer in Help Scout. Use when adding a website URL to an existing customer profile.
Create Note on ConversationHELP_SCOUT_CREATE_NOTE
Tool to create a new note thread on a Help Scout conversation. Use when you need to add internal notes to conversations. Notes are visible only to team members, not customers. Maximum 100 threads per conversation.
Create OrganizationHELP_SCOUT_CREATE_ORGANIZATION
Tool to create a new organization in Help Scout. Use when you need to create a company profile with associated domains, contact information, and metadata.
Tool to create a new custom property definition for organizations in Help Scout. Use when you need to add custom fields to track organization-specific data like industry, account tier, renewal dates, or other metadata. Maximum 50 property definitions allowed per account.
Create Phone ThreadHELP_SCOUT_CREATE_PHONE_THREAD
Tool to create a new phone thread on a Help Scout conversation. Use when you need to log a phone call interaction with a customer on an existing conversation.
Create Reply ThreadHELP_SCOUT_CREATE_REPLY_THREAD
Tool to create a new reply thread on a Help Scout conversation. Use when sending a reply to a customer in an existing conversation. The reply can be published immediately or saved as a draft.
Create saved replyHELP_SCOUT_CREATE_SAVED_REPLY
Tool to create a saved reply for a mailbox in Help Scout. Use when you need to create reusable message templates for email or chat responses.
Create Social ProfileHELP_SCOUT_CREATE_SOCIAL_PROFILE
Tool to create a social profile for a customer in Help Scout. Use when you need to add social media profile information (LinkedIn, Twitter, Facebook, etc.) to a customer record.
Create WebhookHELP_SCOUT_CREATE_WEBHOOK
Tool to create a new webhook subscription in Help Scout to receive real-time event notifications. Use when setting up webhook integrations to track conversations, customers, tags, or other events.
Delete Chat HandleHELP_SCOUT_DELETE_CHAT_HANDLE
Tool to delete a chat handle for a customer. Use when you need to remove a chat handle associated with a customer account.
Delete ConversationHELP_SCOUT_DELETE_CONVERSATION
Tool to move a conversation to the deleted folder. Use when you need to delete a conversation. The conversation can only be restored by a Help Scout administrator.
Delete customerHELP_SCOUT_DELETE_CUSTOMER
Tool to permanently delete a customer by ID from Help Scout. This hard-deletes the customer including microsurvey responses and conversations (irreversible, GDPR compliant). Returns 403 if user lacks access to all conversations or customer has >100 conversations.
Tool to perform a soft delete on a customer property definition. The property is scheduled for permanent deletion, with its slug temporarily reassigned during the grace period.
Tool to delete a website for a customer. Use when you need to remove a website from a customer record.
Delete OrganizationHELP_SCOUT_DELETE_ORGANIZATION
Tool to delete an organization by ID. Use when removing an organization from Help Scout. This operation also removes the reference to this organization from all associated customers.
Tool to delete a customer tier property definition from organizations. This performs a soft-delete, and the property will be removed permanently after a grace period. Use when you need to remove a custom organization property definition.
Delete Saved ReplyHELP_SCOUT_DELETE_SAVED_REPLY
Tool to delete a saved reply from a mailbox. Use when you need to permanently remove a saved reply. Returns 204 No Content on successful deletion.
Delete SnoozeHELP_SCOUT_DELETE_SNOOZE
Tool to delete a snooze on a conversation. Use when you need to remove a snooze from a conversation, which will place it into its new home folder (Mine, Team or Unassigned, based on assignee).
Delete Social ProfileHELP_SCOUT_DELETE_SOCIAL_PROFILE
Tool to delete a social profile for a customer in Help Scout. Use when you need to remove a social media profile link from a customer record.
Tool to unschedule a scheduled thread in a conversation. Use when you need to convert a scheduled thread to a draft thread. The scheduled thread will be converted to a standard draft thread.
Delete WebhookHELP_SCOUT_DELETE_WEBHOOK
Tool to permanently delete a webhook subscription from Help Scout. Use when you need to remove webhook integrations that are no longer needed.
Download AttachmentHELP_SCOUT_DOWNLOAD_ATTACHMENT
Tool to download an attachment file from a Help Scout conversation. Use when you need to retrieve the actual file content of an attachment.
Get Attachment DataHELP_SCOUT_GET_ATTACHMENT_DATA
Tool to retrieve attachment data for a specific attachment. Returns base64-encoded attachment content.
Get Busy Times ReportHELP_SCOUT_GET_BUSY_TIMES_REPORT
Tool to get busiest time of day report showing conversation volume by day and hour. Use when you need to analyze conversation patterns to identify peak support hours or optimize team scheduling. Requires Plus or Pro plan.
Get Chat ReportHELP_SCOUT_GET_CHAT_REPORT
Tool to retrieve comprehensive chat report statistics from Help Scout. Use when you need to analyze chat performance metrics including conversation volume, wait times, response times, message counts, and chat durations. Supports period-over-period comparisons and filtering by mailboxes, tags, or folders. Note: Only available to Plus and Pro plans.
Get Company Customers Helped ReportHELP_SCOUT_GET_COMPANY_CUSTOMERS_HELPED_REPORT
Tool to retrieve company customers helped report showing distinct customer count receiving support. Use when you need to analyze how many unique customers were helped during a specific period, compare periods, or track customer engagement trends. Available only for Plus and Pro plans.
Get Company Drilldown ReportHELP_SCOUT_GET_COMPANY_DRILLDOWN_REPORT
Tool to retrieve company drilldown report showing underlying conversation data for company statistics. Use when you need to analyze conversations by various dimensions like reply counts, response times, or resolution metrics. Available only for Plus and Pro plans.
Get Company ReportHELP_SCOUT_GET_COMPANY_REPORT
Tool to retrieve overall company performance report from Help Scout. Returns metrics like customers helped, conversations closed, total replies, and per-user statistics for a specified time period. Use when you need to analyze team performance, track support metrics, or generate reports on customer service activity.
Get ConversationHELP_SCOUT_GET_CONVERSATION
Tool to retrieve a specific conversation by ID from Help Scout. Use when you need detailed information about a conversation including assignee, customer, tags, custom fields, and optionally embedded threads.
Get Conversations Drilldown ReportHELP_SCOUT_GET_CONVERSATIONS_DRILLDOWN
Tool to get conversations drilldown report from Help Scout. Use when you need detailed conversation data for a specific time period. Available on Plus and Pro plans only.
Get Conversations Field Drilldown ReportHELP_SCOUT_GET_CONVERSATIONS_FIELD_DRILLDOWN
Tool to get conversations drilldown by field report from Help Scout. Use when you need to analyze conversations by specific tags, saved replies, workflows, or customers for a time period.
Get Conversations ReportHELP_SCOUT_GET_CONVERSATIONS_REPORT
Tool to get overall conversations report with statistics on conversation volume, channels, and trends. Use when you need insights on conversation patterns, busiest times, top customers, tags, or custom field analytics. Supports optional previous period comparison for trend analysis.
Get CustomerHELP_SCOUT_GET_CUSTOMER
Tool to get a specific customer by ID from Help Scout. Use when you need to retrieve detailed customer information including contact details, profile data, and conversation history.
Get Customer AddressHELP_SCOUT_GET_CUSTOMER_ADDRESS
Tool to retrieve a customer's address from Help Scout. Use when you need to fetch the physical address associated with a specific customer account.
Get Docs ReportHELP_SCOUT_GET_DOCS_REPORT
Tool to retrieve overall docs performance report from Help Scout. Returns metrics like unique visitors, browse and search actions, popular searches, top articles, and top categories for a specified time period. Use when you need to analyze documentation usage, track knowledge base effectiveness, or identify popular content.
Get Email ReportHELP_SCOUT_GET_EMAIL_REPORT
Tool to retrieve email report with volume, resolution, and response metrics from Help Scout. Returns statistics like email conversations, response times, resolution rates, and time distributions for a specified period. Use when you need detailed email performance analytics or trend comparisons.
Get First Response Time ReportHELP_SCOUT_GET_FIRST_RESPONSE_TIME_REPORT
Tool to retrieve first response time productivity report showing average response duration. Use when you need to analyze team response performance, track response time trends, or compare response times across different periods. Available only for Plus and Pro plans.
Get Happiness Ratings ReportHELP_SCOUT_GET_HAPPINESS_RATINGS_REPORT
Tool to retrieve happiness ratings report with customer satisfaction scores and feedback from Help Scout. Returns paginated list of ratings including conversation details, rating scores (Great/OK/Not Good), customer comments, and associated agent information. Use when you need to analyze customer satisfaction metrics or gather feedback data.
Get Happiness ReportHELP_SCOUT_GET_HAPPINESS_REPORT
Tool to retrieve overall happiness report from Help Scout. Returns customer satisfaction metrics including ratings percentages, counts, and happiness scores for a specified time period. Use when you need to analyze customer satisfaction trends, track happiness scores, or generate reports on customer feedback.
Get InboxHELP_SCOUT_GET_INBOX
Tool to retrieve a specific inbox by ID with details including name, email, and timestamps. Use when you need to get information about a particular mailbox or inbox.
Get New Conversations Drilldown ReportHELP_SCOUT_GET_NEW_CONVERSATIONS_DRILLDOWN
Tool to get new conversations drilldown report showing underlying conversation data for new conversations created within a time period. Use when you need to analyze newly created conversations with detailed information. Available only for Plus and Pro plans.
Get New Conversations ReportHELP_SCOUT_GET_NEW_CONVERSATIONS_REPORT
Tool to get new conversations report showing conversation counts over time intervals. Use when you need to analyze new conversation trends, compare time periods, or track conversation volume patterns.
Get OrganizationHELP_SCOUT_GET_ORGANIZATION
Tool to retrieve a specific organization by ID from Help Scout. Use when you need to fetch details about an organization including name, website, domains, and contact information.
Get Organization ConversationsHELP_SCOUT_GET_ORGANIZATION_CONVERSATIONS
Tool to get conversations associated with an organization in Help Scout. Use when you need to retrieve all conversations linked to a specific organization. Returns paginated results with HAL+JSON format.
Get Organization CustomersHELP_SCOUT_GET_ORGANIZATION_CUSTOMERS
Tool to get customers associated with an organization in Help Scout. Use when you need to retrieve a list of all customers belonging to a specific organization. Returns paginated results with 50 customers per page.
Get Organization PropertyHELP_SCOUT_GET_ORGANIZATION_PROPERTY
Tool to retrieve a single organization property definition by its slug identifier. Use when you need to get details about a specific custom property configured for organizations, including its type, display name, and available options.
Get Phone ReportHELP_SCOUT_GET_PHONE_REPORT
Tool to retrieve phone report statistics from Help Scout. Returns metrics like phone conversations, phone calls created, and customer counts for a specified period. Use when you need to analyze phone support performance or track phone activity trends. Note: Only available to Plus and Pro plans.
Get Productivity ReportHELP_SCOUT_GET_PRODUCTIVITY_REPORT
Tool to retrieve productivity overall report showing comprehensive team performance metrics. Use when you need to analyze productivity statistics including response times, resolution times, handle times, and conversation volumes. Available only for Plus and Pro plans.