Mailchimp Transactional API — Messages

naftiko: 1.0.0-alpha2
info:
  label: Mailchimp Transactional API — Messages
  description: 'Mailchimp Transactional API — Messages. 11 operations. Lead operation: Mailchimp Cancel a Scheduled Message.
    Self-contained Naftiko capability covering one Mailchimp business surface.'
  tags:
  - Mailchimp
  - Messages
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MAILCHIMP_API_KEY: MAILCHIMP_API_KEY
capability:
  consumes:
  - type: http
    namespace: transactional-messages
    baseUri: https://mandrillapp.com/api/1.0
    description: Mailchimp Transactional API — Messages business capability. Self-contained, no shared references.
    resources:
    - name: messages-cancel-scheduled
      path: /messages/cancel-scheduled
      operations:
      - name: postmessagescancelscheduled
        method: POST
        description: Mailchimp Cancel a Scheduled Message
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: messages-content
      path: /messages/content
      operations:
      - name: postmessagescontent
        method: POST
        description: Mailchimp Get Message Content
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: messages-info
      path: /messages/info
      operations:
      - name: postmessagesinfo
        method: POST
        description: Mailchimp Get Message Info
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: messages-list-scheduled
      path: /messages/list-scheduled
      operations:
      - name: postmessageslistscheduled
        method: POST
        description: Mailchimp List Scheduled Messages
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: messages-parse
      path: /messages/parse
      operations:
      - name: postmessagesparse
        method: POST
        description: Mailchimp Parse a Raw Mime Message
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: messages-reschedule
      path: /messages/reschedule
      operations:
      - name: postmessagesreschedule
        method: POST
        description: Mailchimp Reschedule a Message
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: messages-search
      path: /messages/search
      operations:
      - name: postmessagessearch
        method: POST
        description: Mailchimp Search Sent Messages
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: messages-search-time-series
      path: /messages/search-time-series
      operations:
      - name: postmessagessearchtimeseries
        method: POST
        description: Mailchimp Search Message Time Series
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: messages-send
      path: /messages/send
      operations:
      - name: postmessagessend
        method: POST
        description: Mailchimp Send a Transactional Email
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: messages-send-raw
      path: /messages/send-raw
      operations:
      - name: postmessagessendraw
        method: POST
        description: Mailchimp Send a Raw Mime Message
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: messages-send-template
      path: /messages/send-template
      operations:
      - name: postmessagessendtemplate
        method: POST
        description: Mailchimp Send an Email Using a Template
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    authentication:
      type: apikey
      key: X-MC-ApiKey
      value: '{{env.MAILCHIMP_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: transactional-messages-rest
    port: 8080
    description: REST adapter for Mailchimp Transactional API — Messages. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/messages/cancel-scheduled
      name: messages-cancel-scheduled
      description: REST surface for messages-cancel-scheduled.
      operations:
      - method: POST
        name: postmessagescancelscheduled
        description: Mailchimp Cancel a Scheduled Message
        call: transactional-messages.postmessagescancelscheduled
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/messages/content
      name: messages-content
      description: REST surface for messages-content.
      operations:
      - method: POST
        name: postmessagescontent
        description: Mailchimp Get Message Content
        call: transactional-messages.postmessagescontent
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/messages/info
      name: messages-info
      description: REST surface for messages-info.
      operations:
      - method: POST
        name: postmessagesinfo
        description: Mailchimp Get Message Info
        call: transactional-messages.postmessagesinfo
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/messages/list-scheduled
      name: messages-list-scheduled
      description: REST surface for messages-list-scheduled.
      operations:
      - method: POST
        name: postmessageslistscheduled
        description: Mailchimp List Scheduled Messages
        call: transactional-messages.postmessageslistscheduled
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/messages/parse
      name: messages-parse
      description: REST surface for messages-parse.
      operations:
      - method: POST
        name: postmessagesparse
        description: Mailchimp Parse a Raw Mime Message
        call: transactional-messages.postmessagesparse
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/messages/reschedule
      name: messages-reschedule
      description: REST surface for messages-reschedule.
      operations:
      - method: POST
        name: postmessagesreschedule
        description: Mailchimp Reschedule a Message
        call: transactional-messages.postmessagesreschedule
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/messages/search
      name: messages-search
      description: REST surface for messages-search.
      operations:
      - method: POST
        name: postmessagessearch
        description: Mailchimp Search Sent Messages
        call: transactional-messages.postmessagessearch
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/messages/search-time-series
      name: messages-search-time-series
      description: REST surface for messages-search-time-series.
      operations:
      - method: POST
        name: postmessagessearchtimeseries
        description: Mailchimp Search Message Time Series
        call: transactional-messages.postmessagessearchtimeseries
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/messages/send
      name: messages-send
      description: REST surface for messages-send.
      operations:
      - method: POST
        name: postmessagessend
        description: Mailchimp Send a Transactional Email
        call: transactional-messages.postmessagessend
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/messages/send-raw
      name: messages-send-raw
      description: REST surface for messages-send-raw.
      operations:
      - method: POST
        name: postmessagessendraw
        description: Mailchimp Send a Raw Mime Message
        call: transactional-messages.postmessagessendraw
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/messages/send-template
      name: messages-send-template
      description: REST surface for messages-send-template.
      operations:
      - method: POST
        name: postmessagessendtemplate
        description: Mailchimp Send an Email Using a Template
        call: transactional-messages.postmessagessendtemplate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: transactional-messages-mcp
    port: 9090
    transport: http
    description: MCP adapter for Mailchimp Transactional API — Messages. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: mailchimp-cancel-scheduled-message
      description: Mailchimp Cancel a Scheduled Message
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: transactional-messages.postmessagescancelscheduled
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: mailchimp-get-message-content
      description: Mailchimp Get Message Content
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: transactional-messages.postmessagescontent
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: mailchimp-get-message-info
      description: Mailchimp Get Message Info
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: transactional-messages.postmessagesinfo
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: mailchimp-list-scheduled-messages
      description: Mailchimp List Scheduled Messages
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: transactional-messages.postmessageslistscheduled
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: mailchimp-parse-raw-mime-message
      description: Mailchimp Parse a Raw Mime Message
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: transactional-messages.postmessagesparse
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: mailchimp-reschedule-message
      description: Mailchimp Reschedule a Message
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: transactional-messages.postmessagesreschedule
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: mailchimp-search-sent-messages
      description: Mailchimp Search Sent Messages
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: transactional-messages.postmessagessearch
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: mailchimp-search-message-time-series
      description: Mailchimp Search Message Time Series
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: transactional-messages.postmessagessearchtimeseries
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: mailchimp-send-transactional-email
      description: Mailchimp Send a Transactional Email
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: transactional-messages.postmessagessend
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: mailchimp-send-raw-mime-message
      description: Mailchimp Send a Raw Mime Message
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: transactional-messages.postmessagessendraw
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: mailchimp-send-email-using-template
      description: Mailchimp Send an Email Using a Template
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: transactional-messages.postmessagessendtemplate
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.