ManyChat MCP server Let your AI agent run your ManyChat bot.

ToolWhat it doesAccess

• list_contacts Contacts from the Contacts tab with name, channel, tags and subscription status, filtered by search text or tag. read

  Returns the contacts the Contacts tab shows for the filter you pass, newest first. status says whether the contact is subscribed or unsubscribed; ManyChat keeps tags and custom field values on unsubscribed contacts but cannot message them. Pass next_cursor back as cursor for the next page. contact_id is what the other tools take.

  MCP callmanychat_read → list_contacts

  REST endpointGET https://cotlet.dev/api/v1/manychat/contacts

  Parameters

  Parameters: list_contacts

  Name	Type	Description
  search string	string	Text to match against the contact name.
  tag string	string	Only contacts that carry this tag.
  status enum	enum	subscribed or unsubscribed. Default: both.
  cursor string	string	next_cursor from the previous page.

  Example response

  {
    "contacts": [
      {
        "contact_id": "c_48120377",
        "name": "Maya Lopez",
        "channel": "Instagram",
        "tags": [
          "lead",
          "webinar"
        ],
        "status": "subscribed",
        "last_interaction": "2026-11-04T16:12:00Z"
      },
      {
        "contact_id": "c_48120391",
        "name": "Tom Becker",
        "channel": "WhatsApp",
        "tags": [
          "customer"
        ],
        "status": "subscribed",
        "last_interaction": "2026-11-03T09:40:00Z"
      }
    ],
    "next_cursor": null
  }

• get_contact One contact profile: channels, tags, custom field values and the last interaction. read

  Opens the contact profile in ManyChat and returns what it shows: the channels the contact is on, tags, custom field values (including answers saved from a Data Collection step) and the last interaction. Custom fields with no value are left out. Use it before tagging or messaging someone.

  MCP callmanychat_read → get_contact

  REST endpointGET https://cotlet.dev/api/v1/manychat/contacts/{contact_id}

  Parameters

  Parameters: get_contact

  Name	Type	Description
  contact_id string required	string	contact_id from list_contacts.

  Example input

  {
    "contact_id": "contact_8c41d2"
  }

  Example response

  {
    "contact_id": "c_48120377",
    "name": "Maya Lopez",
    "channels": [
      "Instagram"
    ],
    "tags": [
      "lead",
      "webinar"
    ],
    "custom_fields": {
      "Budget": "500-1000",
      "Business": "Pilates studio"
    },
    "status": "subscribed",
    "last_interaction": "2026-11-04T16:12:00Z"
  }

ToolWhat it doesAccess

• list_conversations Conversations in the ManyChat Inbox with contact, channel, label and last message, newest first. read

  Lists threads from the Inbox, newest activity first, with the last message and its sender. label filters by one of your Inbox labels. Use conversation_id with get_conversation to read the whole thread.

  MCP callmanychat_read → list_conversations

  REST endpointGET https://cotlet.dev/api/v1/manychat/conversations

  Parameters

  Parameters: list_conversations

  Name	Type	Description
  label string	string	Only threads with this Inbox label.
  search string	string	Text to match against the contact name.
  cursor string	string	next_cursor from the previous page.

  Example response

  {
    "conversations": [
      {
        "conversation_id": "v_90211",
        "contact_id": "c_48120377",
        "contact": "Maya Lopez",
        "channel": "Instagram",
        "label": "Pricing",
        "last_message": "Do you have a plan for two studios?",
        "last_sender": "contact",
        "last_message_at": "2026-11-04T16:12:00Z"
      }
    ],
    "next_cursor": null
  }

• get_conversation Message history of one Inbox conversation with the contact profile details ManyChat shows beside it. read

  Returns the messages of one thread in order, oldest first, each with its sender (contact, bot or a team member). It also returns the contact tags shown beside the chat. Reading does not send anything to the contact.

  MCP callmanychat_read → get_conversation

  REST endpointGET https://cotlet.dev/api/v1/manychat/conversations/{conversation_id}

  Parameters

  Parameters: get_conversation

  Name	Type	Description
  conversation_id string required	string	conversation_id from list_conversations.

  Example input

  {
    "conversation_id": "conversation_8c41d2"
  }

  Example response

  {
    "conversation_id": "v_90211",
    "contact": "Maya Lopez",
    "channel": "Instagram",
    "tags": [
      "lead",
      "webinar"
    ],
    "messages": [
      {
        "sender": "bot",
        "text": "Hi Maya! Want the price list?",
        "at": "2026-11-04T16:08:00Z"
      },
      {
        "sender": "contact",
        "text": "Do you have a plan for two studios?",
        "at": "2026-11-04T16:12:00Z"
      }
    ]
  }

• send_message Reply to a contact in an Inbox conversation. writeasks first

  Types the text into the conversation in the Inbox and sends it as your account, on the contact channel. It returns the sent message with its time. The reply goes to a real person and cannot be unsent. By default you confirm each call; you can switch that off for this tool.

  MCP callmanychat_write → send_message

  REST endpointPOST https://cotlet.dev/api/v1/manychat/conversations/{conversation_id}/messages

  Parameters

  Parameters: send_message

  Name	Type	Description
  conversation_id string required	string	conversation_id from list_conversations.
  text string required	string	Message text.

  Example input

  {
    "conversation_id": "conversation_8c41d2",
    "text": "text"
  }

  Example response

  {
    "conversation_id": "v_90211",
    "sent": true,
    "text": "Yes, the Studio plan covers two locations. Want me to send the details?",
    "at": "2026-11-05T09:21:00Z"
  }

ToolWhat it doesAccess

• list_automations Automations from the Automations tab with name, status and last change. read

  Returns each automation of the workspace with its name and status as the Automations tab shows it. Use the name as the automation parameter of send_broadcast. It lists automations; it never edits or turns one on or off.

  MCP callmanychat_read → list_automations

  REST endpointGET https://cotlet.dev/api/v1/manychat/automations

  Parameters

  Parameters: list_automations

  Name	Type	Description
  search string	string	Text to match against the automation name.

  Example response

  {
    "automations": [
      {
        "automation_id": "a_5521",
        "name": "October offer",
        "status": "live",
        "changed_at": "2026-10-28T10:02:00Z"
      },
      {
        "automation_id": "a_5498",
        "name": "Welcome flow",
        "status": "live",
        "changed_at": "2026-09-14T13:30:00Z"
      }
    ]
  }

• list_broadcasts Broadcasts from the Broadcasting tab with name, state, send time and the stats the tab shows. read

  Returns the broadcasts of the workspace, newest first, with their state (sent, scheduled or draft) and the numbers the Broadcasting tab shows for each. Drafts have no stats. Use it for reports; it changes nothing.

  MCP callmanychat_read → list_broadcasts

  REST endpointGET https://cotlet.dev/api/v1/manychat/broadcasts

  Parameters

  Parameters: list_broadcasts

  Name	Type	Description
  state enum	enum	sent, scheduled or draft. Default: all.
  since date	date	Only broadcasts sent or scheduled on or after this date.

  Example response

  {
    "broadcasts": [
      {
        "broadcast_id": "b_3307",
        "name": "October offer",
        "state": "sent",
        "sent_at": "2026-10-29T08:00:00Z",
        "stats": {
          "sent": 1840,
          "delivered": 1796,
          "clicked": 212
        }
      },
      {
        "broadcast_id": "b_3312",
        "name": "November reminder",
        "state": "scheduled",
        "sent_at": "2026-11-10T08:00:00Z",
        "stats": null
      }
    ]
  }

• send_broadcast Send an automation as a broadcast to all contacts or to a tag or custom field segment. writeasks first

  Opens Broadcasting, starts a broadcast from the automation, sets the Target Audience from the tag and custom field conditions you pass, and presses Send Now. Without conditions ManyChat sends to all available contacts, so the call returns the audience size before it sends and stops if send_now is false. The broadcast reaches many people and cannot be recalled. By default you confirm each call; you can switch that off for this tool.

  MCP callmanychat_write → send_broadcast

  REST endpointPOST https://cotlet.dev/api/v1/manychat/broadcasts

  Parameters

  Parameters: send_broadcast

  Name	Type	Description
  automation string required	string	Automation name from list_automations.
  tag string	string	Only contacts that carry this tag.
  custom_field string	string	Custom field name for a second condition.
  custom_field_value string	string	Value the custom field must have.
  send_now boolean	boolean	true presses Send Now. false only returns the audience size. Default: false.

  Example input

  {
    "automation": "October offer",
    "tag": "customer",
    "send_now": true
  }

  Example response

  {
    "broadcast_id": "b_3315",
    "automation": "October offer",
    "audience": {
      "tag": "customer",
      "contacts": 412
    },
    "state": "sent",
    "sent_at": "2026-11-05T09:30:00Z"
  }

ToolWhat it doesAccess

• list_tags Tags of the workspace with the number of contacts that carry each. read

  Returns every tag with its contact count, sorted by name. Use it to find the exact tag name before filtering contacts or adding a tag.

  MCP callmanychat_read → list_tags

  REST endpointGET https://cotlet.dev/api/v1/manychat/tags

  Parameters

  No parameters.

  Example response

  {
    "tags": [
      {
        "name": "customer",
        "contacts": 412
      },
      {
        "name": "lead",
        "contacts": 238
      },
      {
        "name": "webinar",
        "contacts": 97
      }
    ]
  }

• list_custom_fields Custom fields from Settings > Fields with name and type. read

  Returns the custom fields created in Settings > Fields with their type. Store phone numbers in text fields, because ManyChat number fields drop the plus sign. Use the name as the field parameter of set_custom_field.

  MCP callmanychat_read → list_custom_fields

  REST endpointGET https://cotlet.dev/api/v1/manychat/custom-fields

  Parameters

  No parameters.

  Example response

  {
    "fields": [
      {
        "name": "Budget",
        "type": "text"
      },
      {
        "name": "Business",
        "type": "text"
      },
      {
        "name": "Phone",
        "type": "text"
      }
    ]
  }

• add_tag_to_contact Add a tag to one contact in the Contacts tab. write

  Adds the tag to the contact profile and returns the contact tags after the change. A tag that does not exist yet is created. The tag itself sends nothing to the contact and remove_tag_from_contact undoes it in one call, so it runs without a confirmation.

  MCP callmanychat_write → add_tag_to_contact

  REST endpointPOST https://cotlet.dev/api/v1/manychat/contacts/{contact_id}/tag-to-contacts

  Parameters

  Parameters: add_tag_to_contact

  Name	Type	Description
  contact_id string required	string	contact_id from list_contacts.
  tag string required	string	Tag name, e.g. lead.

  Example input

  {
    "contact_id": "contact_8c41d2",
    "tag": "tag"
  }

  Example response

  {
    "contact_id": "c_48120377",
    "tags": [
      "lead",
      "webinar",
      "qualified"
    ]
  }

• remove_tag_from_contact Remove a tag from one contact. write

  Removes the tag from the contact profile and returns the contact tags after the change. The contact keeps every other tag and field. Adding the tag again undoes it in one call, so it runs without a confirmation.

  MCP callmanychat_write → remove_tag_from_contact

  REST endpointDELETE https://cotlet.dev/api/v1/manychat/contacts/{contact_id}/tag-from-contacts

  Parameters

  Parameters: remove_tag_from_contact

  Name	Type	Description
  contact_id string required	string	contact_id from list_contacts.
  tag string required	string	Tag name to remove.

  Example input

  {
    "contact_id": "contact_8c41d2",
    "tag": "tag"
  }

  Example response

  {
    "contact_id": "c_48120391",
    "tags": [
      "customer"
    ]
  }

• set_custom_field Set the value of a custom field on one contact. write

  Writes the value into the field on the contact profile and returns the saved value. The field must exist in Settings > Fields. The old value is returned as previous, so one more call puts it back. It sends nothing to the contact, so it runs without a confirmation.

  MCP callmanychat_write → set_custom_field

  REST endpointPUT https://cotlet.dev/api/v1/manychat/contacts/{contact_id}/custom-field

  Parameters

  Parameters: set_custom_field

  Name	Type	Description
  contact_id string required	string	contact_id from list_contacts.
  field string required	string	Field name from list_custom_fields.
  value string required	string	New value.

  Example input

  {
    "contact_id": "contact_8c41d2",
    "field": "field",
    "value": "value"
  }

  Example response

  {
    "contact_id": "c_48120377",
    "field": "Budget",
    "value": "500-1000",
    "previous": null
  }