Mulesoft Marketing Cloud Customer 360 Bridge

naftiko: 1.0.0-alpha2
info:
  title: Mulesoft Marketing Cloud Customer 360 Bridge
  description: A bridge capability composing MuleSoft + Salesforce Marketing Cloud into a Customer 360 view for marketing-ops agents.
  tags: [Naftiko, MuleSoft, Marketing Cloud, Customer 360]
  created: '2026-05-01'
  modified: '2026-05-04'
binds:
- namespace: salesforce-mc-env
  keys: {SFMC_HOST: SFMC_HOST, SFMC_TOKEN: SFMC_TOKEN}
capability:
  consumes:
  - namespace: sfmc
    type: http
    baseUri: https://{{SFMC_HOST}}
    authentication: {type: bearer, token: '{{SFMC_TOKEN}}'}
    resources:
    - name: contact
      path: '/contacts/v1/contacts/{{contact_key}}'
      operations:
      - {name: get-mc-contact, method: GET, inputParameters: [{name: contact_key, in: path}]}
    - {name: data-extensions, path: '/data/v1/customobjectdata/key/{{key}}/rowset', operations: [{name: get-data-extension-rows, method: GET, inputParameters: [{name: key, in: path}]}]}
  exposes:
  - type: rest
    address: 0.0.0.0
    port: 8080
    namespace: mulesoft-marketing-cloud-customer-360-bridge-rest
    description: REST surface for Marketing Cloud Customer 360.
    resources:
    - {name: contact-360, path: '/customers/{{contact_key}}/360', operations: [{method: GET, name: get-contact-360, inputParameters: [{name: contact_key, in: path, type: string}], call: sfmc.get-mc-contact}]}
  - type: mcp
    address: 0.0.0.0
    port: 3010
    namespace: mulesoft-marketing-cloud-customer-360-bridge-mcp
    description: MCP for Marketing Cloud bridge.
    tools:
    - name: get-contact-360
      hints: {readOnly: true}
      inputParameters: [{name: contact_key, type: string, required: true}]
      call: sfmc.get-mc-contact
  - type: skill
    address: 0.0.0.0
    port: 3011
    namespace: mulesoft-marketing-cloud-customer-360-bridge-skills
    description: Skill for Marketing Cloud bridge.
    skills:
    - name: mulesoft-marketing-cloud-customer-360-bridge
      description: Marketing Cloud Customer 360.
      location: file:///opt/naftiko/skills/mulesoft-marketing-cloud-customer-360-bridge
      allowed-tools: get-contact-360
      tools:
      - {name: get-contact-360, from: {sourceNamespace: mulesoft-marketing-cloud-customer-360-bridge-mcp, action: get-contact-360}}