# ActiveTrail — how to use (mcp.ai)

Connect your ActiveTrail account and use 159 tools for email newsletters straight from your AI agent. Connect with your own API key. ActiveTrail is the world's friendliest email marketing platform, newsletter software and marketing automation software.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_active_trail?ms=1787291220000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `active_trail_add_group_member`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/active_trail`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/active_trail/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/active_trail/add/group/member` — Tool to add a member to a group in ActiveTrail. Creates a new contact or adds an existing contact to the specified group. Supports comprehensive contact information including names, phone numbers, add
  - body: { fax?: string, city?: string, ext1?: string, ext2?: string, ext3?: string, ext4?: string, ext5?: string, ext6?: string, email: string, phone1?: string, phone2?: string, status?: string, street?: string, birthday?: string, group_id: integer, zip_code?: string, last_name?: string, first_name?: string, anniversary?: string, campaign_id?: integer, encryptedext1?: string, encryptedext2?: string, encryptedext3?: string, encryptedext4?: string, is_do_not_mail?: boolean, is_trigger_events?: boolean }
- `POST https://api.mcp.ai/api/active_trail/add/mailinglist/member` — Tool to add a member to a mailing list in ActiveTrail. Creates a new contact or adds an existing contact to the specified mailing list and groups. Either email or SMS must be provided.
  - body: { fax?: string, sms?: string, city?: string, ext1?: string, ext2?: string, ext3?: string, ext4?: string, ext5?: string, ext6?: string, ext7?: string, ext8?: string, ext9?: string, num1?: integer|number, num2?: integer|number, num3?: integer|number, num4?: integer|number, num5?: integer|number, date1?: string, date2?: string, date3?: string, date4?: string, date5?: string, email?: string, ext10?: string, ext11?: string, ext12?: string, ext13?: string, ext14?: string, ext15?: string, ext16?: string, ext17?: string, ext18?: string, ext19?: string, ext20?: string, ext21?: string, ext22?: string, ext23?: string, ext24?: string, ext25?: string, phone1?: string, phone2?: string, status?: string, street?: string, birthday?: string, zip_code?: string, group_ids: integer[], last_name?: string, first_name?: string, is_deleted?: boolean, sms_status?: string, anniversary?: string, subscribe_ip?: string, mailinglist_id: integer }
- `POST https://api.mcp.ai/api/active_trail/contact/growth` — Retrieves daily contact growth statistics showing active (subscribed) and inactive (unsubscribed) contact counts over a specified date range. Use this to analyze contact acquisition trends and measure
  - body: { to_date?: string, from_date?: string }
- `POST https://api.mcp.ai/api/active_trail/create/a/new/group` — Creates a new contact group in ActiveTrail for organizing and segmenting contacts. Groups are containers for contacts that allow you to: - Organize contacts by category, campaign, or segment - Target 
  - body: { name: string }
- `POST https://api.mcp.ai/api/active_trail/create/campaign` — Tool to create a new email campaign in ActiveTrail. Use when you need to create and return a new campaign for specific groups. The campaign can be configured as an A/B split test, E-commerce campaign,
  - body: { carts?: object, pairs?: object[], design: object, details: object, segment?: object, template?: object, send_test?: string, scheduling: object, a_b_settings?: object }
- `POST https://api.mcp.ai/api/active_trail/create/campaign/for/contacts` — Tool to create and send a new campaign to specific contacts in ActiveTrail. Use when you need to create campaigns targeted at selected recipients by contact IDs or email addresses. Supports regular ca
  - body: { campaign: object, campaign_contacts: object }
- `POST https://api.mcp.ai/api/active_trail/create/contact` — Creates a new contact in ActiveTrail with the provided information. At least one of email or sms must be provided as the primary identifier. All other fields are optional and can be used to enrich the
  - body: { fax?: string, sms?: string, city?: string, ext1?: string, ext2?: string, ext3?: string, ext4?: string, ext5?: string, ext6?: string, ext7?: string, ext8?: string, ext9?: string, num1?: integer, num2?: integer, num3?: integer, num4?: integer, num5?: integer, date1?: string, date2?: string, date3?: string, date4?: string, date5?: string, email?: string, ext10?: string, ext11?: string, ext12?: string, ext13?: string, ext14?: string, ext15?: string, ext16?: string, ext17?: string, ext18?: string, ext19?: string, ext20?: string, ext21?: string, ext22?: string, ext23?: string, ext24?: string, ext25?: string, phone1?: string, phone2?: string, street?: string, birthday?: string, zip_code?: string, last_name?: string, first_name?: string, anniversary?: string, subscribe_ip?: string }
- `POST https://api.mcp.ai/api/active_trail/create/content/category` — Tool to create a new content category in ActiveTrail account. Use when you need to add a new category for organizing campaigns and templates.
  - body: { name: string, is_default?: boolean, display_order?: integer }
- `POST https://api.mcp.ai/api/active_trail/create/new/mailing/list` — Tool to create a new mailing list in ActiveTrail. Use when you need to add a new mailing list to organize and manage contacts.
  - body: { name: string }
- `POST https://api.mcp.ai/api/active_trail/create/order` — Tool to create new orders in ActiveTrail commerce system. Use when you need to add order records with customer information, products, and transaction details. Accepts an array of order objects for bat
  - body: { orders: object[] }
- `POST https://api.mcp.ai/api/active_trail/create/segmentation` — Create a new contact segmentation in ActiveTrail. Segmentations are rule-based filters that define target audiences based on contact field values (e.g., email equals specific value, city contains text
  - body: { name: string, rules_segment: object }
- `POST https://api.mcp.ai/api/active_trail/create/smart/code/site` — Creates a new Smart Code tracking site in ActiveTrail. Smart Code is ActiveTrail's web analytics and visitor tracking solution that monitors visitor behavior on your website. Use this action to regist
  - body: { name: string, domains: string }
- `POST https://api.mcp.ai/api/active_trail/create/sms/campaign` — Tool to create a new SMS campaign in ActiveTrail. Use when you need to send SMS messages to segments of your audience with customizable content, sender name, and scheduling options.
  - body: { name: string, content: string, segment: object, from_name?: string, scheduling: object, can_unsubscribe?: boolean, is_link_tracking?: boolean, unsubscribe_text: string }
- `POST https://api.mcp.ai/api/active_trail/create/sms/operational/message` — Tool to create a new operational SMS transactional message. Use when you need to create an SMS campaign for later use or editing.
  - body: { name: string, content: string, from_name: string, can_unsubscribe?: boolean, unsubscribe_text?: string }
- `POST https://api.mcp.ai/api/active_trail/create/webhook` — Create a new webhook for event notifications in ActiveTrail. Webhooks enable real-time notifications for events like contact changes or campaign activities. After creating the webhook, use the 'Update
  - body: { url: string, name: string, event_type: string }
- `POST https://api.mcp.ai/api/active_trail/delete/a/member/in/a/group` — Tool to delete a group member by ID. Use when you need to remove a contact from a specific group in ActiveTrail.
  - body: { group_id: integer, contact_id: integer }
- `POST https://api.mcp.ai/api/active_trail/delete/account/content/categories` — Tool to delete a specific content category by ID. Use when you need to remove a category from your ActiveTrail account.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/active_trail/delete/automations` — Tool to delete one or more automations from Active Trail. Use when you need to remove automations by their IDs. Supports bulk deletion by providing comma-separated IDs.
  - body: { ids: string }
- `POST https://api.mcp.ai/api/active_trail/delete/campaign` — Tool to remove a campaign from ActiveTrail account. Use when you need to delete a campaign that is no longer needed.
  - body: { id: string }
- `POST https://api.mcp.ai/api/active_trail/delete/contact` — Tool to permanently remove a contact from the ActiveTrail account by their unique contact ID. Use when you need to delete a specific contact. This operation is destructive and cannot be undone. Return
  - body: { id: string }
- `POST https://api.mcp.ai/api/active_trail/delete/group/by/id` — Tool to delete a group by ID. Use when you need to permanently remove a group from ActiveTrail. This is a destructive operation that cannot be undone.
  - body: { group_id: integer }
- `POST https://api.mcp.ai/api/active_trail/delete/mailing/list` — Tool to permanently remove a mailing list from the ActiveTrail account by its unique ID. Use when you need to delete a mailing list that is no longer needed. This operation is destructive and cannot b
  - body: { id: string }
- `POST https://api.mcp.ai/api/active_trail/delete/smart/code/site` — Tool to remove a Smart Code site from ActiveTrail. Use when you need to permanently delete a Smart Code site identified by its unique ID.
  - body: { id: string }
- `POST https://api.mcp.ai/api/active_trail/delete/template` — Tool to remove a template from ActiveTrail account. Use when you need to delete a template that is no longer needed.
  - body: { id: string }
- `POST https://api.mcp.ai/api/active_trail/delete/templates/template/category` — Tool to delete a template category by ID. Use when you need to remove a template category. Warning: Deleting a category will cascade-delete all templates within that category.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/active_trail/delete/webhook` — Tool to remove a webhook from ActiveTrail account by its ID. Use when you need to delete a webhook that is no longer needed.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/active_trail/delete/webhooks/parameters` — Removes a specific parameter from a webhook configuration in ActiveTrail. Use this when you need to delete custom headers, query parameters, or body parameters that were previously added to a webhook.
  - body: { webhook_id: integer, parameter_id: integer }
- `POST https://api.mcp.ai/api/active_trail/get/account/balance` — Tool to retrieve email and SMS credit balance for the account. Use when you need to check available email and SMS credits.
- `POST https://api.mcp.ai/api/active_trail/get/account/content/categories2` — Tool to retrieve specific category details by ID. Use when you need to get information about a content category from your ActiveTrail account.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/active_trail/get/account/integrationdata` — Retrieves the account's ActiveCommerce integration configuration data including mailing list and group associations. This endpoint returns the integration settings that connect ActiveTrail with Active
- `POST https://api.mcp.ai/api/active_trail/get/account/merge` — Check if the ActiveTrail account has any pending account merge operations. This action retrieves the current account merge status, indicating whether there are any account merges awaiting completion. 
- `POST https://api.mcp.ai/api/active_trail/get/all/campaign/reports` — Tool to retrieve a full overview of all campaign reports with comprehensive metrics. Use when you need to get reports for all campaigns including send date, opened emails, number of clicks, CTO, bounc
  - body: { page?: integer, limit?: integer, to_date?: string, from_date?: string }
- `POST https://api.mcp.ai/api/active_trail/get/all/groups` — Tool to retrieve the full list of account groups with pagination and filtering. Use when you need to get all groups or search for groups by name. Default limit is 100 groups per page.
  - body: { page?: integer, limit?: integer, search_term?: string }
- `POST https://api.mcp.ai/api/active_trail/get/all/sent/campaigns` — Tool to retrieve campaigns with optional filtering by date, mailing list, and search criteria. Use when you need to get campaigns filtered by date range (default is last 3 months), limited to a specif
  - body: { page?: integer, limit?: integer, to_date?: string, from_date?: string, send_type?: string, search_term?: string, mailing_list_id?: string, content_category_id?: string }
- `POST https://api.mcp.ai/api/active_trail/get/automation/log` — Tool to track contacts through automation journey by retrieving detailed logs. Use when you need to see which contacts started a specific automation and their progress through each step of the workflo
  - body: { id: integer }
- `POST https://api.mcp.ai/api/active_trail/get/automation/reports/log/automation/queue` — Tool to retrieve contacts that did not finish a specific automation. Use when you need to get the list of contacts remaining in the automation queue for a given automation ID.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/active_trail/get/automation/reports/sms/campaign/summary` — Tool to retrieve SMS campaigns' summary reports for a specific automation. Use when you need to analyze SMS campaign performance including sent, delivered, failed, credits consumed, unsubscribe, and c
  - body: { id: integer, to_date?: string, from_date?: string }
- `POST https://api.mcp.ai/api/active_trail/get/automation/reports/summary/report` — Tool to retrieve email campaigns' summary reports for a specific automation. Use when you need to analyze email campaign performance metrics including opens, clicks, click-to-open rate, conversions, b
  - body: { id: integer, to_date: string, from_date: string }
- `POST https://api.mcp.ai/api/active_trail/get/automation/trigger/types` — Tool to retrieve all available start trigger options for automations. Use when you need to get the list of trigger types that can initiate automation workflows in ActiveTrail.
- `POST https://api.mcp.ai/api/active_trail/get/automations` — Tool to list account automations with filtering and pagination. Use when you need to retrieve automations from the ActiveTrail account. Supports filtering by state and pagination parameters.
  - body: { page?: integer, limit?: integer, state_type?: string }
- `POST https://api.mcp.ai/api/active_trail/get/automations/details` — Tool to retrieve detailed configuration of a specific automation excluding step-by-step execution details. Use when you need metadata about automation behavior, scheduling, reporting settings, and ope
  - body: { id: integer }
- `POST https://api.mcp.ai/api/active_trail/get/automations/email/campaign/steps` — Tool to retrieve all email campaign steps in an automation workflow. Use when you need to get details about all 'send email' steps configured within a specific automation, including email content, sch
  - body: { id: integer }
- `POST https://api.mcp.ai/api/active_trail/get/automations/sms/campaign/steps` — Tool to retrieve all SMS campaign steps in an automation workflow. Use when you need to get details about all 'send SMS' steps configured within a specific automation, including SMS content, schedulin
  - body: { id: integer }
- `POST https://api.mcp.ai/api/active_trail/get/campaign/bounces` — Tool to retrieve bounce details by domain for a specific campaign. Use when you need to analyze campaign bounce rates and identify problematic email domains. Defaults to campaigns updated in the last 
  - body: { id: string, page?: integer, limit?: integer, to_date?: string, from_date?: string }
- `POST https://api.mcp.ai/api/active_trail/get/campaign/clicks` — Retrieves detailed click-through data for all links in a campaign or optionally for a specific link. Returns comprehensive information including contact details (name, email), click timestamps, device
  - body: { id: string, page?: integer, limit?: integer, link_id?: string, to_date?: string, from_date?: string }
- `POST https://api.mcp.ai/api/active_trail/get/campaign/design` — Tool to retrieve campaign design configuration including visual layout and HTML content. Use when you need to get the design details of a specific email campaign.
  - body: { id: string }
- `POST https://api.mcp.ai/api/active_trail/get/campaign/domains/report` — Tool to retrieve a report by domain for a specific campaign. Use when you need to analyze campaign performance grouped by recipient email domains, including sends, opens, clicks, bounces, and engageme
  - body: { page?: integer, limit?: integer, to_date?: string, from_date?: string, campaign_id: string }
- `POST https://api.mcp.ai/api/active_trail/get/campaign/opens` — Tool to retrieve contacts who opened a specific campaign email. Use when you need to identify which recipients opened your campaign, track open rates, and analyze campaign engagement. Default search c
  - body: { page?: integer, limit?: integer, groupid?: integer, to_date?: string, from_date?: string, campaign_id: integer }
- `POST https://api.mcp.ai/api/active_trail/get/campaign/report` — Retrieves comprehensive performance metrics for a specific email campaign by its ID. Returns detailed statistics including send count, open rate, click rate, click-to-open rate (CTO), bounce rate, uns
  - body: { id: string, page?: integer, limit?: integer, to_date?: string, from_date?: string }
- `POST https://api.mcp.ai/api/active_trail/get/campaign/reports/bounced` — Tool to retrieve bounced email details filtered by bounce type for a specific campaign. Use when you need detailed information about which contacts' emails bounced and why, with the ability to filter 
  - body: { id: string, page?: integer, limit?: integer, bounce_type?: string }
- `POST https://api.mcp.ai/api/active_trail/get/campaign/reports/complaints` — Tool to retrieve contacts who reported a specific campaign as spam. Use when you need to identify which contacts flagged your campaign as unwanted. The default search window is the last 3 months; if t
  - body: { id: string, page?: integer, limit?: integer, groupid?: string, to_date?: string, from_date?: string }
- `POST https://api.mcp.ai/api/active_trail/get/campaign/reports/email/activity` — Tool to retrieve all contacts' activity on a specific campaign. Use when you need comprehensive activity data including opens, clicks, bounces, and other engagement metrics for each contact in a campa
  - body: { id: string, page?: integer, limit?: integer, to_date?: string, from_date?: string }
- `POST https://api.mcp.ai/api/active_trail/get/campaign/reports/sent` — Tool to retrieve contacts who received a specific campaign email. Use when you need to identify which recipients successfully received your campaign. The default search window is the last 3 months; if
  - body: { id: string, page?: integer, limit?: integer, groupid?: string, to_date?: string, from_date?: string }
- `POST https://api.mcp.ai/api/active_trail/get/campaign/reports/unopened` — Tool to retrieve contacts who did not open a specific campaign. Use when you need to identify which recipients received but did not open your campaign email. The default search window is the last 3 mo
  - body: { id: string, page?: integer, limit?: integer, groupid?: string, to_date?: string, from_date?: string }
- `POST https://api.mcp.ai/api/active_trail/get/campaign/s/details` — Tool to retrieve complete campaign information including send settings, design, template, and A/B test configuration. Use when you need comprehensive details about a specific email campaign.
  - body: { campaign_id: integer }
- `POST https://api.mcp.ai/api/active_trail/get/campaign/scheduling` — Retrieves the scheduling configuration for a specific email campaign, including send status and scheduled datetime. Use this action when you need to check if a campaign is scheduled to send, when it's
  - body: { id: string }
- `POST https://api.mcp.ai/api/active_trail/get/campaign/template` — Retrieves template details (design, content, subject line, sender info) for a specific email campaign. Use this action when you need to: - View the template configuration used in a campaign - Get HTML
  - body: { id: string }
- `POST https://api.mcp.ai/api/active_trail/get/campaign/unsubscribed` — Retrieves the list of contacts who unsubscribed from a specific email campaign. Use this action when you need to: - Identify which recipients opted out of receiving future communications from a campai
  - body: { id: integer, page?: integer, limit?: integer, to_date?: string, from_date?: string }
- `POST https://api.mcp.ai/api/active_trail/get/campaigns/details` — Tool to retrieve detailed campaign information including name, subject, and settings. Use when you need to get comprehensive details about a specific email campaign.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/active_trail/get/campaigns/segment` — Tool to retrieve campaign sending settings including target groups and sending restrictions. Use when you need to get the segmentation configuration for a specific campaign.
  - body: { id: string }
- `POST https://api.mcp.ai/api/active_trail/get/campaigns/sent/campaigns` — Tool to retrieve a list of all sent campaigns from ActiveTrail. Use when you need to view all campaigns that have been sent, including their details such as name, subject, send status, and delivery me
- `POST https://api.mcp.ai/api/active_trail/get/commerce/schema` — Tool to retrieve order fields schema information from the ActiveTrail commerce API. Use when you need to get information about available order fields, their types, and custom names for commerce/order 
- `POST https://api.mcp.ai/api/active_trail/get/contact/activity` — Tool to retrieve contact's email engagement history including opens and clicks. Use when you need detailed activity data showing which campaigns were sent to a contact and their engagement metrics.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/active_trail/get/contact/details` — Tool to retrieve complete details of a specific contact by their ID. Use when you need full contact information including personal data, contact fields, subscription status, and all custom extended fi
  - body: { id: integer }
- `POST https://api.mcp.ai/api/active_trail/get/contact/fields` — Tool to retrieve account contact fields filtered by type. Use when you need to get contact field definitions from the ActiveTrail account.
  - body: { fields_type?: string }
- `POST https://api.mcp.ai/api/active_trail/get/contact/groups` — Tool to retrieve all groups associated with a specific contact. Returns group details including group ID, name, member counts, and creation dates. Use when you need to list a contact's group membershi
  - body: { id: integer }
- `POST https://api.mcp.ai/api/active_trail/get/contact/list` — Tool to retrieve account contacts filtered by status and date range. Use when you need to get a list of contacts filtered by customer status (active, unsubscribed, bounced, etc.) or by registration da
  - body: { page?: integer, limit?: integer, to_date?: string, from_date?: string, search_term?: string, customer_states?: string }
- `POST https://api.mcp.ai/api/active_trail/get/contact/sms/statistics` — Tool to retrieve contact interaction statistics for a specific transactional SMS. Use when you need to see how a contact interacted with a transactional/operational SMS including delivery status, boun
  - body: { contact_id: integer, message_id: integer }
- `POST https://api.mcp.ai/api/active_trail/get/contacts/errors` — Tool to retrieve bounce and error history for a specific contact. Use when you need to understand delivery issues or bounce patterns for a contact's email address.
  - body: { id: string }
- `POST https://api.mcp.ai/api/active_trail/get/contacts/mailinglists` — Tool to retrieve all mailing lists associated with a specific contact. Use when you need to list a contact's mailing list memberships by contact ID.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/active_trail/get/contacts/merges` — Tool to retrieve contacts experiencing merge conflicts with filtering options. Use when you need to get the list of contacts with merge conflicts, filtered by status, date range, or limited to a speci
  - body: { page?: integer, limit?: integer, to_date?: string, from_date?: string, state_type?: string }
- `POST https://api.mcp.ai/api/active_trail/get/contacts/statistics/campaign` — Tool to retrieve contact's interaction statistics for a specific campaign. Use when you need to see how a specific contact engaged with a campaign including opens, clicks, bounces, unsubscribes, and s
  - body: { id: integer, campaign_id: integer }
- `POST https://api.mcp.ai/api/active_trail/get/contacts/subscription/all/contacts` — Tool to get contacts' subscription status and the source of their status (if known). Use when you need to retrieve all contacts with their subscription status information filtered by creation date. De
  - body: { page?: integer, limit?: integer, to_date?: string, from_date?: string }
- `POST https://api.mcp.ai/api/active_trail/get/contacts/subscription/customers/status` — Get daily breakdown of contact status statistics over a date range. Returns counts of active, unsubscribed, bounced, quarantined, spam complaints, inactive, and user-requested removal contacts for eac
  - body: { to_date?: string, from_date?: string }
- `POST https://api.mcp.ai/api/active_trail/get/contacts/subscription/subscribers` — Tool to retrieve all contacts who subscribed and the source of their subscription status. Use when you need to get a comprehensive list of subscribers. The search defaults to 3 months back if date ran
  - body: { page?: integer, limit?: integer, to_date?: string, from_date?: string }
- `POST https://api.mcp.ai/api/active_trail/get/contacts/subscription/unsubscribers` — Tool to retrieve all contacts who unsubscribed and the source of their unsubscription status. Use when you need to get a comprehensive list of unsubscribers. The search defaults to 3 months back if da
  - body: { page?: integer, limit?: integer, to_date?: string, from_date?: string }
- `POST https://api.mcp.ai/api/active_trail/get/contacts/unsubscribers/sms` — Tool to retrieve all contacts who unsubscribed from receiving SMS messages. Use when you need to get a list of SMS unsubscribers with optional filtering by date range and pagination support.
  - body: { page?: integer, limit?: integer, to_date?: string, from_date?: string }
- `POST https://api.mcp.ai/api/active_trail/get/contacts/with/sms/state` — Tool to retrieve account's contacts list with SMS subscription state. Use when you need to get contacts filtered by customer status (active, unsubscribed, bounced, etc.) and by state change date range
  - body: { page?: integer, limit?: integer, to_date?: string, from_date?: string, search_term?: string, customer_states?: string }
- `POST https://api.mcp.ai/api/active_trail/get/content/categories` — Tool to retrieve all content categories from the ActiveTrail account. Use when you need to get the list of categories used for organizing campaigns and templates.
- `POST https://api.mcp.ai/api/active_trail/get/customer/stats/for/transactional/message` — Tool to retrieve customer interaction statistics for a specific transactional message. Use when you need to see how a contact engaged with a transactional/operational message including delivery status
  - body: { contact_id: integer, transactional_id: integer }
- `POST https://api.mcp.ai/api/active_trail/get/executive/report` — Retrieve executive performance report for the ActiveTrail account, providing email marketing metrics over the past 12 months. Returns monthly statistics including emails sent, bounce rates, open rates
- `POST https://api.mcp.ai/api/active_trail/get/external/schema` — Tool to retrieve contact field schema information for the account. Use when you need to get the structure and metadata of all available contact fields.
- `POST https://api.mcp.ai/api/active_trail/get/group` — Tool to retrieve detailed information about a specific group by its unique identifier. Use when you need to fetch group details including name, contact counters, and timestamps.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/active_trail/get/group/contents/by/id` — Tool to retrieve all group members by group ID with pagination and filtering. Use when you need to get complete information about contacts in a specific group. Returns up to 100 contacts per page with
  - body: { page?: integer, limit?: integer, to_date?: string, group_id: integer, from_date?: string, search_term?: string, customer_states?: string }
- `POST https://api.mcp.ai/api/active_trail/get/groups/events` — Tool to retrieve all events for a specific group with optional filtering by event type, event date, and subscriber creation date. Use when you need to analyze group engagement metrics like opens, clic
  - body: { id: integer, event_type?: string, event_to_date?: string, created_to_date?: string, event_from_date?: string, created_from_date?: string }
- `POST https://api.mcp.ai/api/active_trail/get/landing/pages` — Tool to retrieve landing pages from the ActiveTrail account with pagination support. Use when you need to get all landing pages or fetch paginated results.
  - body: { page?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/active_trail/get/mailing/list` — Tool to retrieve basic information about a specific mailing list by its unique identifier. Returns the mailing list ID and name. Use when you need to verify a mailing list exists or get its name by ID
  - body: { id: string|integer }
- `POST https://api.mcp.ai/api/active_trail/get/mailing/list/members` — Tool to retrieve all members belonging to a specific mailing list. Use when you need to get contacts from a mailing list, with optional filtering by contact status and state change date range.
  - body: { id: string|integer, page?: integer, limit?: integer, to_date?: string, from_date?: string, customer_states?: string }
- `POST https://api.mcp.ai/api/active_trail/get/mailing/lists` — Tool to retrieve all mailing lists from the ActiveTrail account. Use when you need to get the list of mailing lists associated with the account.
- `POST https://api.mcp.ai/api/active_trail/get/order` — Tool to retrieve complete details of a specific order from ActiveTrail commerce system. Use when you need to fetch order information including customer details, financial data, products, and shipping 
  - body: { order_id: string }
- `POST https://api.mcp.ai/api/active_trail/get/push/campaign/opens` — Retrieves a list of contacts who opened a specific push notification campaign, including contact details and when they opened the notification. Use this action to: - Track engagement metrics for push 
  - body: { id: string, page?: integer, limit?: integer, to_date?: string, from_date?: string, send_type?: string, search_term?: string }
- `POST https://api.mcp.ai/api/active_trail/get/push/campaign/report/delivered` — Tool to retrieve contacts who successfully received a specific push notification campaign. Use when you need to identify which recipients had the push campaign delivered to their devices. The campaign
  - body: { id: string, page?: integer, limit?: integer, to_date?: string, from_date?: string, send_type?: string, search_term?: string }
- `POST https://api.mcp.ai/api/active_trail/get/push/campaign/report/failed` — Tool to retrieve the failed delivery report for a specific push campaign. Use when you need to see which contacts experienced delivery failures and why. The campaign must be sent in the specified date
  - body: { id: string, page?: integer, limit?: integer, to_date?: string, from_date?: string, send_type?: string, search_term?: string }
- `POST https://api.mcp.ai/api/active_trail/get/push/campaign/report/sent` — Tool to retrieve the list of contacts who were sent a specific push notification campaign, including contact details, device types, and sent timestamps. Use when you need to see the complete list of r
  - body: { id: string, page?: integer, limit?: integer, to_date?: string, from_date?: string, send_type?: string, search_term?: string }
- `POST https://api.mcp.ai/api/active_trail/get/push/campaign/report/summary` — Tool to retrieve aggregated summary statistics for push notification campaigns filtered by date range. Returns total counts across all campaigns including total sent, opens, clicks, clickers, unsubscr
  - body: { page?: integer, limit?: integer, to_date?: string, from_date?: string, send_type?: string, search_term?: string }
- `POST https://api.mcp.ai/api/active_trail/get/push/campaign/reports` — Retrieves push notification campaign performance metrics and reports filtered by date range, send type, or search term. Returns analytics including sent count, delivered count, opened count, clicked c
  - body: { page?: integer, limit?: integer, to_date?: string, from_date?: string, send_type?: string, search_term?: string }
- `POST https://api.mcp.ai/api/active_trail/get/push/campaigns` — Tool to retrieve push notification campaigns with optional filtering by date, campaign ID, and search criteria. Use when you need to get push campaigns filtered by date range (default is last 6 months
  - body: { to_date?: string, from_date?: string, page_size?: integer, campaign_id?: string, filter_type?: string, page_number?: integer, search_term?: string, include_deleted?: boolean, include_not_sent?: boolean }
- `POST https://api.mcp.ai/api/active_trail/get/segmentation/rule/field/types` — Retrieve a reference dictionary of all available field types that can be used in segmentation rules for ActiveTrail automation. Returns field type definitions including their identifiers, names, data 
- `POST https://api.mcp.ai/api/active_trail/get/segmentation/rule/operations` — Retrieves available rule operations for segmentation by field type. Returns operations categorized by field types (Info, Date, Action, Numeric, etc.) with their corresponding operation types (Is, IsNo
- `POST https://api.mcp.ai/api/active_trail/get/segmentation/rule/types` — Tool to retrieve available segmentation rule types for automation. Returns a list of rule type names that can be used when creating or editing automation segmentations. Use this to discover what types
- `POST https://api.mcp.ai/api/active_trail/get/segmentation/rule/types/mapping` — Tool to retrieve the complete mapping of segmentation rule types with their associated field types and operations from ActiveTrail. Use this when building segmentation rules to understand which field 
- `POST https://api.mcp.ai/api/active_trail/get/segmentations` — Retrieve all contact segmentations from your ActiveTrail account. Segmentations are rule-based filters that define target audiences for campaigns and automations (e.g., contacts who opened specific ca
- `POST https://api.mcp.ai/api/active_trail/get/sending/profiles` — Tool to retrieve account email sending profiles. Use when you need to get sending profile configurations including sender names, email addresses, and reply-to settings.
- `POST https://api.mcp.ai/api/active_trail/get/signup/forms` — Tool to retrieve all signup forms from the ActiveTrail account. Use when you need to get the list of signup forms associated with the account.
- `POST https://api.mcp.ai/api/active_trail/get/smart/code/sites` — Retrieves all Smart Code tracking sites configured in the ActiveTrail account. Smart Code is ActiveTrail's web analytics and visitor tracking solution. Use this action to list all registered websites 
- `POST https://api.mcp.ai/api/active_trail/get/sms/campaign` — Tool to retrieve detailed information about a specific SMS campaign by its unique identifier. Use when you need to fetch campaign details including message content, sender, status, and delivery metric
  - body: { id: integer }
- `POST https://api.mcp.ai/api/active_trail/get/sms/campaign/clickers` — Retrieve contacts who clicked links in an SMS campaign with detailed click analytics. Returns contact information (name, email, phone), click timestamps, link details, and click counts. Supports filte
  - body: { id: string, page?: integer, limit?: integer, link_id?: string, to_date?: string, from_date?: string, send_type?: string, search_term?: string, rows_affected?: integer, previous_row_count?: integer }
- `POST https://api.mcp.ai/api/active_trail/get/sms/campaign/delivered` — Tool to retrieve delivery confirmations for a specific SMS campaign. Use when you need to see which contacts successfully received the SMS message. The campaign must be sent in the specified date rang
  - body: { id: string, page?: integer, limit?: integer, to_date?: string, from_date?: string, send_type?: string, search_term?: string, rows_affected?: integer, previous_row_count?: integer }
- `POST https://api.mcp.ai/api/active_trail/get/sms/campaign/estimate` — Tool to calculate the estimated number of messages for a given SMS campaign. Use when you need to get message count estimates for campaigns that have not been sent yet. Cannot be used for already-sent
  - body: { id: integer }
- `POST https://api.mcp.ai/api/active_trail/get/sms/campaign/report` — Tool to retrieve summary report for a specific SMS campaign by ID. Use when you need detailed metrics about an SMS campaign's performance including sent count, delivery rate, clicks, and errors.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/active_trail/get/sms/campaign/report/clicks` — Tool to retrieve detailed click event data for links in SMS campaigns. Returns individual click records (not unique clickers) with contact information, timestamps, link details, and device/browser inf
  - body: { id: string, page?: integer, limit?: integer, to_date?: string, from_date?: string, send_type?: string, search_term?: string, rows_affected?: integer, previous_row_count?: integer }
- `POST https://api.mcp.ai/api/active_trail/get/sms/campaign/report/failed` — Tool to retrieve the failed delivery report for a specific SMS campaign. Use when you need to see which contacts experienced delivery failures and why. The campaign must be sent in the specified date 
  - body: { id: string, page?: integer, limit?: integer, to_date?: string, from_date?: string, send_type?: string, search_term?: string }
- `POST https://api.mcp.ai/api/active_trail/get/sms/campaign/report/sent` — Tool to retrieve all contacts that an SMS campaign was sent to. Use when you need to see the list of recipients for a specific SMS campaign. The campaign must be sent in the specified date range (defa
  - body: { id: string, page?: integer, limit?: integer, to_date?: string, from_date?: string, send_type?: string, search_term?: string, rows_affected?: integer, previous_row_count?: integer }
- `POST https://api.mcp.ai/api/active_trail/get/sms/campaign/report/summary` — Retrieve aggregate summary metrics for SMS campaigns across a filtered date range. Returns total counts for sent messages, failed deliveries, clicks, unique clicks, unsubscribes, and credits consumed.
  - body: { to_date?: string, from_date?: string, send_type?: string, search_term?: string }
- `POST https://api.mcp.ai/api/active_trail/get/sms/campaign/report/unsubscribed` — Tool to retrieve contacts who unsubscribed from a specific SMS campaign. Use when you need to identify recipients who opted out of receiving future SMS messages. Note: For manually added numbers, only
  - body: { id: string, page?: integer, limit?: integer, to_date?: string, from_date?: string, send_type?: string, search_term?: string, rows_affected?: integer, previous_row_count?: integer }
- `POST https://api.mcp.ai/api/active_trail/get/sms/campaign/reports` — Tool to retrieve SMS campaign performance metrics and reports with filtering options. Use when you need to access SMS campaign analytics including sent, delivered, failed, clicks, and engagement stati
  - body: { page?: integer, limit?: integer, to_date?: string, from_date?: string, send_type?: string, search_term?: string, rows_affected?: integer, previous_row_count?: integer }
- `POST https://api.mcp.ai/api/active_trail/get/sms/sending/profiles` — Tool to retrieve SMS sending profiles configured for the account. Use when you need to get SMS sender profile configurations including sender names and phone numbers.
- `POST https://api.mcp.ai/api/active_trail/get/template` — Tool to retrieve detailed information about a specific template from the account's saved templates. Use when you need to fetch template details including name, subject, content, category, and encoding
  - body: { id: integer }
- `POST https://api.mcp.ai/api/active_trail/get/template/content` — Tool to retrieve HTML content of a specific template. Use when you need to get the HTML markup or design content of a template by its ID.
  - body: { id: string }
- `POST https://api.mcp.ai/api/active_trail/get/templates` — Tool to retrieve saved templates from the ActiveTrail account. Use when you need to list all templates or search for templates by name. Supports pagination and filtering.
  - body: { page?: integer, limit?: integer, search_term?: string }
- `POST https://api.mcp.ai/api/active_trail/get/templates/template/category` — Tool to retrieve all template categories from 'my templates' section. Use when you need to get the list of categories for organizing email templates.
- `POST https://api.mcp.ai/api/active_trail/get/transactional/messages/classification` — Tool to retrieve all classification options for operational/transactional messages. Use when you need to get available classifications for categorizing and filtering transactional message reports.
- `POST https://api.mcp.ai/api/active_trail/get/transactional/sms/message` — Tool to retrieve detailed information about a specific transactional SMS message by its unique identifier. Use when you need to fetch SMS message content, delivery statistics, and metadata for operati
  - body: { transactional_sms_id: integer }
- `POST https://api.mcp.ai/api/active_trail/get/two/way/sms/replies` — Tool to retrieve virtual number SMS replies with filtering options. Use when you need to fetch two-way SMS responses for campaigns with optional filtering by search term, campaign ID, or date range.
  - body: { page?: integer, limit?: integer, to_date?: string, from_date?: string, campaign_id?: integer, search_term?: string }
- `POST https://api.mcp.ai/api/active_trail/get/update/actions` — Retrieves all available update action types that can be applied to contacts within automation workflows. Each action type includes its ID, name, description, type category, and required parameters. Us
- `POST https://api.mcp.ai/api/active_trail/get/user/social/accounts/get` — Retrieve social media accounts (Facebook, Instagram, etc.) connected to the ActiveTrail account. Returns a list of connected social media accounts with details like platform, username, status, and con
- `POST https://api.mcp.ai/api/active_trail/get/webhook` — Tool to retrieve detailed information about a specific webhook by its unique identifier. Use when you need to fetch complete webhook configuration including event type, target URL, state, and associat
  - body: { webhook_id: integer }
- `POST https://api.mcp.ai/api/active_trail/get/webhooks` — Tool to list account webhooks with optional filtering. Use when you need to retrieve webhooks configured for the ActiveTrail account with filtering by event type, state, or target type.
  - body: { event_type?: string, state_type?: string, target_type?: string, is_ignore_parameters?: boolean }
- `POST https://api.mcp.ai/api/active_trail/get/webhooks/parameters` — Retrieves custom parameters configured for a specific webhook. Parameters define additional data (headers, query parameters, or body fields) that ActiveTrail includes when calling the webhook URL. Use
  - body: { webhook_id: integer }
- `POST https://api.mcp.ai/api/active_trail/import/new/contacts` — Tool to import new contacts into a group in ActiveTrail. Use when you need to bulk import contacts with customer information (limited to 1000 contacts per call). Returns success count and any errors f
  - body: { group: integer, contacts: object[], mailing_list?: integer }
- `POST https://api.mcp.ai/api/active_trail/list/sms/campaigns` — Tool to retrieve SMS campaigns with optional filtering by date, search term, and type. Use when you need to get SMS campaigns filtered by date range (default is last 3 months) or other criteria. Retur
  - body: { page?: integer, limit?: integer, to_date?: string, from_date?: string, filter_type?: string, search_term?: string, is_include_not_sent?: boolean }
- `POST https://api.mcp.ai/api/active_trail/list/transactional/sms/messages` — Tool to retrieve all SMS transactional messages with pagination support. Use when you need to fetch the list of operational SMS campaigns configured in the account.
  - body: { page?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/active_trail/post/templates/campaign` — Creates a new email campaign from an existing template. The campaign will be created in draft status. Prerequisites: - A valid template ID (obtain from 'Get Templates' action) - A valid sending profil
  - body: { template_id: integer, campaign_details: object }
- `POST https://api.mcp.ai/api/active_trail/post/templates/template/category` — Tool to create a new template category in ActiveTrail. Use when you need to add a new category for organizing email templates.
  - body: { name: string, name_key?: string }
- `POST https://api.mcp.ai/api/active_trail/post/webhooks/parameters` — Tool to add a new parameter to an existing webhook in your ActiveTrail account. Use when you need to configure additional parameters for webhook events, such as authentication headers, custom query pa
  - body: { key: string, value: string, user_field?: string, webhook_id: integer, event_value_type: string, event_parameter_type: string }
- `POST https://api.mcp.ai/api/active_trail/post/webhooks/test2` — Tool to send a test webhook request with configurable URL and parameters. Use when you need to validate webhook configurations by sending a test request to a specified URL with custom event types, par
  - body: { url: string, format: integer, user_id?: integer, event_type: string, parameters?: object[], target_type: string }
- `POST https://api.mcp.ai/api/active_trail/put/account/content/categories` — Tool to update a specific content category by ID. Use when you need to modify the name or display order of a category in your ActiveTrail account.
  - body: { id: integer, name: string, display_order: integer }
- `POST https://api.mcp.ai/api/active_trail/put/campaigns/segment` — Tool to update campaign sending settings including groups and sending restrictions. Use when you need to modify which groups receive a campaign. Note: Only campaigns in draft mode can be updated.
  - body: { id: integer, group_ids: integer[], restricted_group_ids?: integer[] }
- `POST https://api.mcp.ai/api/active_trail/remove/a/contact/from/a/mailing/list` — Removes a specific contact from a mailing list in ActiveTrail. Use this action to unsubscribe or remove a contact from a particular mailing list without deleting the contact from your account entirely
  - body: { contact_id: string|integer, mailinglist_id: string|integer }
- `POST https://api.mcp.ai/api/active_trail/remove/external/contact/from/group` — Tool to remove contacts from a group via external ID. Use when you need to delete external contacts from a specific group in ActiveTrail. Limited to 1000 contacts per call.
  - body: { group_id: string, external_contacts: object[] }
- `POST https://api.mcp.ai/api/active_trail/send/operational/message` — Tool to send operational email messages to individual recipients (limited to 500 messages per request). Use when you need to send transactional or automated emails with personalized content. Recipient
  - body: { bcc?: object, design: object, details: object, email_package?: object[] }
- `POST https://api.mcp.ai/api/active_trail/send/operational/message/email` — Tool to send transactional/operational email messages via ActiveTrail. Use when you need to send automated emails like order confirmations, password resets, or notifications. Supports dynamic text rep
  - body: { bcc?: object, design: object, details: object, email_package: object[] }
- `POST https://api.mcp.ai/api/active_trail/test/webhook` — Send a test request to a configured webhook to verify it's working correctly. This action triggers a test event for the specified webhook without waiting for actual events to occur. Use this to valida
  - body: { id: integer }
- `POST https://api.mcp.ai/api/active_trail/update/campaign` — Tool to update draft campaigns in ActiveTrail. Use when you need to modify campaign properties such as name, subject, content, or design settings. IMPORTANT: Only campaigns in draft mode can be update
  - body: { id: integer, design: object, details: object, send_test?: string, send_type?: string }
- `POST https://api.mcp.ai/api/active_trail/update/campaign/design` — Tool to update the design and HTML content of an email campaign in ActiveTrail. Use when you need to modify a campaign's visual layout, HTML content, or encoding settings. Important: Only campaigns in
  - body: { id: integer, content: string, language_type?: string, is_add_print_email?: boolean, is_auto_css_inliner?: boolean, is_remove_system_links?: boolean, header_footer_language_type?: string }
- `POST https://api.mcp.ai/api/active_trail/update/campaign/s/details` — Updates an email campaign's core details including name, subject line, sender profile, category, and delivery settings. Important: Only campaigns in DRAFT status can be updated. Attempting to update s
  - body: { id: integer, name: string, subject: string, preheader?: string, user_profile_id: integer, content_category_id: integer, predictive_delivery: boolean, google_analytics_name?: string }
- `POST https://api.mcp.ai/api/active_trail/update/campaign/scheduling` — Tool to configure send schedule for draft campaigns. Use when you need to update the scheduling configuration of a campaign. Only campaigns in draft mode can be updated.
  - body: { id: integer, is_sent: boolean, scheduled_date_utc: string }
- `POST https://api.mcp.ai/api/active_trail/update/campaign/template` — Tool to update the template associated with an email campaign in ActiveTrail. Use when you need to assign or change a template for a campaign. Important: Only campaigns in draft mode can be updated th
  - body: { campaign_id: integer, template_id: integer }
- `POST https://api.mcp.ai/api/active_trail/update/contact` — Tool to update an existing contact's information by ID. Use when you need to modify contact details such as name, email, phone, address, or custom fields. Only the fields you include in the request wi
  - body: { id: integer, fax?: string, sms?: string, city?: string, ext1?: string, ext2?: string, ext3?: string, ext4?: string, ext5?: string, ext6?: string, ext7?: string, ext8?: string, ext9?: string, num1?: integer, num2?: integer, num3?: integer, num4?: integer, num5?: integer, date1?: string, date2?: string, date3?: string, date4?: string, date5?: string, email?: string, ext10?: string, ext11?: string, ext12?: string, ext13?: string, ext14?: string, ext15?: string, ext16?: string, ext17?: string, ext18?: string, ext19?: string, ext20?: string, ext21?: string, ext22?: string, ext23?: string, ext24?: string, ext25?: string, phone1?: string, phone2?: string, status?: string, street?: string, birthday?: string, zip_code?: string, last_name?: string, first_name?: string, is_deleted?: boolean, sms_status?: string, anniversary?: string, subscribe_ip?: string, double_opt_in_config?: object }
- `POST https://api.mcp.ai/api/active_trail/update/group` — Updates an existing group in ActiveTrail by its ID. Primary use case: Rename a group by updating its name field. Important notes: - Only the 'name' field is reliably updateable via this endpoint - The
  - body: { id: integer, name?: string }
- `POST https://api.mcp.ai/api/active_trail/update/order` — Updates an existing order in the ActiveTrail commerce system. Use this action to modify order details including customer information (name, email, phone), shipping address, order status, pricing (amou
  - body: { tax?: number, city?: string, email?: string, items?: object[], mobile?: string, status?: string, address?: string, orderId?: string, currency?: string, lastName?: string, order_id: string, firstName?: string, netAmount?: number, orderName?: string, totalPrice?: number, totalAmount?: number, purchaseDate?: string }
- `POST https://api.mcp.ai/api/active_trail/update/segmentation` — Tool to update an existing segmentation's name and/or rules by its ID. Use when you need to modify segmentation criteria or rename a segment. Segmentations are rule-based filters that define target au
  - body: { id: integer, name?: string, rules_segment?: object }
- `POST https://api.mcp.ai/api/active_trail/update/smart/code/site` — Updates an existing Smart Code tracking site in ActiveTrail. Use this action to modify a site's name and domain configuration. Both name and domains must be provided in the update request (the API doe
  - body: { id: string, name: string, domains: string }
- `POST https://api.mcp.ai/api/active_trail/update/sms/operational/message` — Tool to update an operational SMS transactional message by ID. Use when you need to modify the name, sender, or content of an existing SMS campaign. Important: You cannot update a campaign that has al
  - body: { id: integer, name: string, content: string, from_name: string }
- `POST https://api.mcp.ai/api/active_trail/update/template` — Tool to update an existing email template in ActiveTrail account. Use this action to modify template properties including: - Template name and subject line - HTML content/body - Editor type and displa
  - body: { id: integer, name?: string, content?: string, subject?: string, editor_type?: string, AddPrintButton?: boolean, campaign_encoding?: integer, template_category_id?: integer }
- `POST https://api.mcp.ai/api/active_trail/update/template/category` — Tool to update an existing template category in ActiveTrail. Use when you need to modify the name of a template category used for organizing email templates.
  - body: { id: integer, name: string, name_key?: string }
- `POST https://api.mcp.ai/api/active_trail/update/template/content` — Tool to update the HTML content of an email template in ActiveTrail. Use when you need to modify the design or layout of an existing template.
  - body: { id: string, content: string }
- `POST https://api.mcp.ai/api/active_trail/update/webhook` — Tool to update an existing webhook configuration in ActiveTrail. Use when you need to modify webhook properties such as name, URL, event type, format, or active status.
  - body: { id: integer, url: string, name: string, format?: integer|string, typeid?: integer, stateid?: integer, is_active?: boolean, event_type?: string }
- `POST https://api.mcp.ai/api/active_trail/update/webhook/parameter` — Tool to update an existing webhook parameter in your ActiveTrail account. Use when you need to modify parameter properties such as key, value, type, or field mappings for webhook events.
  - body: { key?: string, value?: string, user_field?: string, webhook_id: integer, parameter_id: integer, event_value_type?: string, event_parameter_type?: string }

## Example prompts
- "What can I do in ActiveTrail?"
- "Show me a summary of my ActiveTrail account"

## More
- Page: https://mcp.ai/active_trail
- Agent spec (llms.txt): https://mcp.ai/active_trail/llms.txt
- Postman collection: https://mcp.ai/active_trail/postman.json