Skip to main content
Glama
Mautic MCP Connector

Mautic MCP Connector

by si-essence

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PORTNoHTTP listen port. 0 selects an ephemeral port.3000
MCP_HTTP_HOSTNoHTTP bind address.127.0.0.1
MCP_TRANSPORTNoTransport mode: stdio or http. --http forces HTTP.stdio
MAUTIC_CONTACTNoContact inside the User-Agent. Must not contain a secret.contact@example.com
MAUTIC_BASE_URLYesMautic origin and optional path. Must use http or https, with no userinfo, query, or hash. API paths are under {MAUTIC_BASE_URL}/api. Required.
MAUTIC_PASSWORDNoBasic auth password. At least 8 characters. Never printed.
MAUTIC_USERNAMENoMautic user for basic auth.
MAUTIC_AUTH_MODENoAuthentication mode: basic or oauth2. Inferred when only one credential pair is set; required when both credential pairs are set.
MAUTIC_CLIENT_IDNoOAuth2 client id.
MAUTIC_MAX_LIMITNoCap for list limit. Hard max 500.100
MAUTIC_PER_MINUTENoLocal sliding-window request cap per minute.60
MAUTIC_TIMEOUT_MSNoUpstream timeout in milliseconds.20000
MCP_HTTP_AUTH_TOKENNoBearer token for /mcp. Required when MCP_HTTP_HOST is not loopback. At least 16 characters.
MAUTIC_CACHE_TTL_SECNoTTL for successful reads in seconds. 0 disables the cache.60
MAUTIC_CLIENT_SECRETNoOAuth2 client secret. At least 8 characters. Never printed.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
mautic_search_contactsB

Search contacts. GET /api/contacts with search, start, limit, orderBy, orderByDir, minimal. Mautic search syntax includes email:*@example.com, tag:vip, and segment:alias.

mautic_get_contactC

Get one contact. GET /api/contacts/{id}.

mautic_create_contactB

Create a contact. POST /api/contacts/new. Omit confirm for a dry-run preview. confirm must be the boolean true to execute.

mautic_update_contactB

Update a contact. PATCH /api/contacts/{id}/edit so a missing ID fails rather than creating. Omit confirm for a dry-run preview.

mautic_add_contact_tagsA

Add tags on a contact. PATCH /api/contacts/{id}/edit with body tags as an array of tag names. Omit confirm for a dry-run preview.

mautic_remove_contact_tagsA

Remove tags from a contact. PATCH /api/contacts/{id}/edit with tags prefixed by minus, for example -vip. Pass the tag name without the prefix. Omit confirm for a dry-run preview.

mautic_list_segmentsB

List segments. GET /api/segments. The collection key in the Mautic body is lists.

mautic_add_contact_to_segmentA

Add a contact to a segment. POST /api/segments/{segmentId}/contact/{contactId}/add. Omit confirm for a dry-run preview.

mautic_remove_contact_from_segmentB

Remove a contact from a segment. POST /api/segments/{segmentId}/contact/{contactId}/remove. Omit confirm for a dry-run preview.

mautic_list_companiesC

List companies. GET /api/companies.

mautic_get_companyC

Get one company. GET /api/companies/{id}.

mautic_create_companyA

Create a company. POST /api/companies/new. companyname is required. Omit confirm for a dry-run preview.

mautic_update_companyB

Update a company. PATCH /api/companies/{id}/edit. Omit confirm for a dry-run preview.

mautic_add_contact_to_companyB

Add a contact to a company. POST /api/companies/{companyId}/contact/{contactId}/add. Omit confirm for a dry-run preview.

mautic_remove_contact_from_companyA

Remove a contact from a company. POST /api/companies/{companyId}/contact/{contactId}/remove. Omit confirm for a dry-run preview.

mautic_list_emailsC

List emails. GET /api/emails.

mautic_get_emailC

Get one email. GET /api/emails/{id}.

mautic_get_email_statsA

Get email send and read counts from GET /api/emails/{id} (sentCount, readCount, variantSentCount, variantReadCount). Row-level stats are mautic_get_stats with table email_stats.

mautic_send_email_to_contactA

Send an email to one contact. POST /api/emails/{id}/contact/{contactId}/send with optional tokens. Omit confirm for a dry-run preview.

mautic_send_email_to_segmentA

Send a segment email to its lists. POST /api/emails/{id}/send with optional listIds. Omit confirm for a dry-run preview.

mautic_list_campaignsC

List campaigns. GET /api/campaigns.

mautic_get_campaignB

Get one campaign. GET /api/campaigns/{id}.

mautic_add_contact_to_campaignA

Add a contact to a campaign. POST /api/campaigns/{campaignId}/contact/{contactId}/add. Omit confirm for a dry-run preview.

mautic_remove_contact_from_campaignA

Remove a contact from a campaign. POST /api/campaigns/{campaignId}/contact/{contactId}/remove. Omit confirm for a dry-run preview.

mautic_list_formsC

List forms. GET /api/forms.

mautic_get_formC

Get one form. GET /api/forms/{id}.

mautic_list_form_submissionsC

List submissions for a form. GET /api/forms/{formId}/submissions.

mautic_list_stagesC

List stages. GET /api/stages.

mautic_change_contact_stageB

Add a contact to a stage. POST /api/stages/{stageId}/contact/{contactId}/add. Omit confirm for a dry-run preview.

mautic_adjust_contact_pointsA

Add or subtract contact points. POST /api/contacts/{id}/points/plus/{points} or /points/minus/{points} with optional eventName and actionName. Omit confirm for a dry-run preview.

mautic_list_point_triggersC

List point triggers. GET /api/points/triggers.

mautic_list_point_actionsC

List point actions. GET /api/points.

mautic_list_notesA

List notes. GET /api/notes, or GET /api/contacts/{id}/notes when contact_id is set.

mautic_create_noteA

Create a note. POST /api/notes/new with lead, text, and optional type (general, email, call, meeting). Omit confirm for a dry-run preview.

mautic_list_reportsC

List reports. GET /api/reports.

mautic_get_reportB

Get one report. GET /api/reports/{id} with optional dateFrom, dateTo, limit, and page.

mautic_list_stat_tablesA

List available stats tables. GET /api/stats.

mautic_get_statsC

Read rows from a stats table. GET /api/stats/{table} with start, limit, order, and where.

mautic_check_contact_dncA

Read a contact's doNotContact entries. GET /api/contacts/{id}. Optional channel keeps only that channel. DNC writes clear the read cache.

mautic_add_contact_dncA

Add a do-not-contact entry. POST /api/contacts/{id}/dnc/{channel}/add with optional reason (1 unsubscribed, 2 bounced, 3 manual), channelId, and comments. Omit confirm for a dry-run preview.

mautic_remove_contact_dncA

Remove a do-not-contact entry. POST /api/contacts/{id}/dnc/{channel}/remove. Omit confirm for a dry-run preview.

mautic_get_contact_activityB

List activity for one contact. GET /api/contacts/{id}/activity with filters[search], filters[includeEvents][], filters[excludeEvents][], filters[dateFrom], filters[dateTo], order[0], order[1], page, and limit.

mautic_list_activityC

List activity for all contacts. GET /api/contacts/activity with filters[search], filters[includeEvents][], filters[excludeEvents][], filters[dateFrom], filters[dateTo], order[0], order[1], page, and limit.

mautic_list_assetsC

List assets. GET /api/assets with search, start, limit, orderBy, and orderByDir.

mautic_get_assetB

Get one asset. GET /api/assets/{id}.

mautic_list_webhook_triggersB

List webhook trigger names. GET /api/hooks/triggers. Each row has name, label, and description.

mautic_list_webhooksB

List webhooks. GET /api/hooks. The signing secret field is removed from every webhook before the result is returned or cached.

mautic_get_webhookB

Get one webhook. GET /api/hooks/{id}. The signing secret field is removed before the result is returned or cached.

mautic_create_webhookA

Create a webhook. POST /api/hooks/new with name, webhookUrl, and triggers. Optional description, eventsOrderbyDir (ASC or DESC), and isPublished. When confirm is true, trigger names are checked against GET /api/hooks/triggers before the create. Omit confirm for a dry-run preview that does not call Mautic. The response secret is removed.

mautic_delete_webhookA

Delete a webhook. DELETE /api/hooks/{id}/delete. Omit confirm for a dry-run preview. The response secret is removed.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

C2.9/5.0

Scored across 50 tools

Disambiguation4/5

Most tools target clearly distinct resources and actions, with helpful separation between single-contact and global activity, and between row-level stats and email stats. A few pairs such as update_contact vs add/remove_contact_tags and list_activity vs get_contact_activity could be confused, but the descriptions clarify the boundaries.

Naming Consistency4/5

All names use snake_case with the mautic_ prefix and a predictable verb_noun structure. The main minor inconsistency is change_contact_stage using 'change' while analogous membership tools use add_contact_to_* / remove_contact_from_*.

Tool Count2/5

At 50 tools, the surface is heavy for an agent-facing connector, with many list/get pairs and resource families that could be consolidated or scoped more tightly. The domain is broad, but the count exceeds a well-scoped tool set.

Completeness3/5

Read coverage is broad across contacts, companies, campaigns, segments, emails, forms, stages, points, notes, reports, stats, webhooks, and assets. However, write lifecycle is uneven: contacts lack a delete operation, and campaigns, segments, emails, forms, stages, notes, reports, and assets have no create/update/delete tools, leaving notable gaps for full CRUD.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues