campaign_get
ChatGPTGet one campaign by id. Returns campaign metadata, source segments/forms, and optionally a compact event graph. Access is checked by the Mautic campaign API.
Business & Operations
Overview
Aivie helps users search CRM contacts, campaigns, reports, segments, themes, and MJML emails, then inspect details or create and update private Aivie email content through ChatGPT.
Tools
campaign_search
ChatGPTSearch campaigns by Mautic filter string. Results are permission-filtered by the Mautic campaign API. Use
includeContactCounts only when counts are needed.config_get_customer
ChatGPTGet customer and brand configuration for AI-assisted content creation. Returns the Customer object — brand identity (company, tagline, website, address, colors, typography, CTA styling), social profiles, app parameters, and infrastructure context. When to use: before creating or editing emails, landing pages, templates, or reusable content. Guidance: - Prefer
customer.ci.company, customer.ci.tagline, customer.ci.url, customer.ci.addressPart1, customer.ci.addressPart2, customer.ci.colors, customer.ci.font, and CTA styling fields when matching customer identity. - Treat customer.appParam and customer.infra as operational context only; do not print infrastructure details in public marketing copy unless explicitly requested. - Treat missing or empty fields as unknown — never invent customer facts. Field map by intent: - Brand identity → customer.ci.company, customer.ci.tagline, customer.ci.url - Company profile → customer.ci.company, customer.ci.addressPart1, customer.ci.addressPart2, customer.ci.url - Social profiles → customer.social.linkedin, customer.social.instagram, customer.social.facebook, customer.social.youtube, customer.social.twitter - Visual style → customer.ci.colors, customer.ci.font, customer.ci.fontColor, customer.ci.fontSize, customer.ci.lineHeight - Primary CTA style → customer.ci.pc2aColor, customer.ci.pc2aBgColor, customer.ci.pc2aBorderRadius, customer.ci.pc2aPadding - Instance context → customer.appParam.clientType, customer.appParam.siteUrl, customer.infra.vanityHostcontact_call_briefing_context_get
ChatGPTGet the CRM context needed to prepare a sales meeting/call with one contact. This read-only tool bundles the normalized contact, briefing profile fields such as persona or role when available, recent contact notes, and recent timeline activity.
meetingGoal is required so the AI client can prepare the briefing for the right objective instead of producing a generic summary.contact_get
ChatGPTGet one contact by id. Returns a normalized contact read model. Access is checked by the Mautic contact API.
contact_note_create
ChatGPTCreate a new note on one contact. The note is written through the Mautic contact notes API.
text may contain simple HTML; it is stored as-is. type categorizes the note (general, email, call, or meeting). Provide dateTime (format YYYY-MM-DD HH:MM) to backdate the note, otherwise the current time is used.contact_notes_get
ChatGPTGet the notes attached to one contact. Notes are read through the Mautic contact notes API and normalized for MCP (HTML is converted to plain text). Use
search to filter by note text and orderBy/orderByDir to sort.contact_search
ChatGPTSearch contacts by Mautic filter string. Use
search for Mautic contact filters. Pagination uses limit (1-100) and offset. Results are permission-filtered by the Mautic contact API.contact_timeline_get
ChatGPTGet timeline activity for one contact. Results are read through the Mautic contact activity API and normalized for MCP. Use
search, includeEvents, or excludeEvents to narrow activity.email_create_mjml
ChatGPTCreate a new MJML email in Aivie. Required:
name, subject, language, emailType, mjml. - emailType must be list or template. - lists (array of segment IDs) is required when emailType=list. Use segment_search first to pick segment IDs. - Use email_theme_search first to find a theme key. Use email_theme_get to inspect sample templates, then pass the selected theme key as theme. - When using a theme as a base, call email_theme_get with returnFormat=mjml (not mjml+twig). The mjml passed here should be valid rendered MJML. Do not pass raw theme Twig unless you are intentionally creating Twig-based content. The MJML is validated locally (UTF-8, size ≤ 100 KB, Twig syntax) before the email is created so errors are reported up-front.email_get
ChatGPTGet an email including MJML/HTML content. By default returns MJML for MJML emails and omits the generated HTML. Set
mjmlOnly=false to also include the rendered HTML.email_search
ChatGPTSearch existing MJML emails. Use
search for Mautic filter strings (e.g. segment:Newsletter). Pagination via limit (1–100) and offset.email_theme_get
ChatGPTGet one email theme including sample template content. Use
key from email_theme_search. returnFormat controls the format of the returned theme sample: - mjml (default) returns rendered MJML with concrete values and no Twig variables in MJML attributes. Use this when creating or editing emails — it can be passed directly to email_create_mjml. - mjml+html returns rendered MJML and rendered HTML for preview. - html returns rendered HTML, e.g. for preview. - mjml+twig returns the raw theme template source. Use this only when you explicitly need the template source — it may contain Twig variables such as {{fontSize}}, {{bgColor}}, or conditional blocks, and should not normally be passed directly to email_create_mjml.email_theme_search
ChatGPTSearch available email themes for AI-assisted email creation. Use this to choose a theme key. Use
email_theme_get to load MJML/HTML/Twig sample content for one theme.email_update_content
ChatGPTUpdate only the body content of an existing email (
customMjml / customHtml). format must be mjml+twig or html+twig. Metadata (name, subject, lists, published state) is not modified. Updates overwrite the live email and are not auto-reversible.email_update_metadata
ChatGPTUpdate email metadata only (name, subject, language, translation parent, lists, published state, etc.). Body HTML/MJML/Twig is intentionally excluded; use
email_update_content for body changes. Updates overwrite the live email and are not auto-reversible.report_get
ChatGPTGet the compiled data of one report by id. Returns the report metadata, the column map, and the tabular rows. Use
limit and page to paginate large reports, and dateFrom/dateTo (YYYY-MM-DD) to restrict the date range. Access is checked by the Aivie report API.report_search
ChatGPTList or search reports by Mautic filter string. Returns report metadata only (id, name, description, source). Use
report_get with a report id to fetch the compiled rows. Results are permission-filtered by the Aivie report API.segment_search
ChatGPTSearch available segments for newsletter/list emails. By default this focuses on published preference-center segments — the public segments users can subscribe to. Set
publicOnly=false to include internal segments. Use the returned segment ids with email_create_mjml.lists when creating list emails.Capabilities
Writes
