Mautic MCP Connector
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | HTTP listen port. 0 selects an ephemeral port. | 3000 |
| MCP_HTTP_HOST | No | HTTP bind address. | 127.0.0.1 |
| MCP_TRANSPORT | No | Transport mode: stdio or http. --http forces HTTP. | stdio |
| MAUTIC_CONTACT | No | Contact inside the User-Agent. Must not contain a secret. | contact@example.com |
| MAUTIC_BASE_URL | Yes | Mautic 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_PASSWORD | No | Basic auth password. At least 8 characters. Never printed. | |
| MAUTIC_USERNAME | No | Mautic user for basic auth. | |
| MAUTIC_AUTH_MODE | No | Authentication mode: basic or oauth2. Inferred when only one credential pair is set; required when both credential pairs are set. | |
| MAUTIC_CLIENT_ID | No | OAuth2 client id. | |
| MAUTIC_MAX_LIMIT | No | Cap for list limit. Hard max 500. | 100 |
| MAUTIC_PER_MINUTE | No | Local sliding-window request cap per minute. | 60 |
| MAUTIC_TIMEOUT_MS | No | Upstream timeout in milliseconds. | 20000 |
| MCP_HTTP_AUTH_TOKEN | No | Bearer token for /mcp. Required when MCP_HTTP_HOST is not loopback. At least 16 characters. | |
| MAUTIC_CACHE_TTL_SEC | No | TTL for successful reads in seconds. 0 disables the cache. | 60 |
| MAUTIC_CLIENT_SECRET | No | OAuth2 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
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 50 tools
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.
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_*.
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.
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.