naftiko: 1.0.0-alpha2
info:
  label: Webflow CMS and Ecommerce
  description: Unified Webflow capability combining Data API for CMS content management and ecommerce operations. Enables
    content managers to create and publish CMS items, developers to automate workflows via webhooks, and ecommerce managers
    to manage products and orders. Primary workflow for organizations using Webflow as a headless CMS or ecommerce platform.
  tags:
  - Webflow
  - CMS
  - Content Management
  - Ecommerce
  - Publishing
  - Sites
  created: '2026-05-03'
  modified: '2026-05-06'
binds:
- namespace: env
  keys:
    WEBFLOW_API_KEY: WEBFLOW_API_KEY
capability:
  consumes:
  - type: http
    namespace: webflow-data
    baseUri: https://api.webflow.com/v2
    description: Webflow Data API v2
    authentication:
      type: apikey
      key: Authorization
      value: Bearer {{WEBFLOW_API_KEY}}
      placement: header
    resources:
    - name: sites
      path: /sites
      description: Webflow sites within a workspace
      operations:
      - name: list-sites
        method: GET
        description: List Sites
        inputParameters: []
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: get-site
        method: GET
        description: Get Site
        inputParameters:
        - name: site_id
          in: path
          type: string
          required: true
          description: Unique identifier for a Webflow site
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: publish-site
        method: POST
        description: Publish Site
        inputParameters:
        - name: site_id
          in: path
          type: string
          required: true
          description: Unique identifier for a Webflow site
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            customDomains: '{{tools.customDomains}}'
    - name: collections
      path: /sites/{site_id}/collections
      description: CMS collections within a Webflow site
      operations:
      - name: list-collections
        method: GET
        description: List Collections
        inputParameters:
        - name: site_id
          in: path
          type: string
          required: true
          description: Unique identifier for a Webflow site
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: get-collection
        method: GET
        description: Get Collection
        inputParameters:
        - name: collection_id
          in: path
          type: string
          required: true
          description: Unique identifier for a CMS collection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: items
      path: /collections/{collection_id}/items
      description: CMS items within a Webflow collection
      operations:
      - name: list-items
        method: GET
        description: List Collection Items
        inputParameters:
        - name: collection_id
          in: path
          type: string
          required: true
          description: Unique identifier for a CMS collection
        - name: limit
          in: query
          type: integer
          required: false
          description: Maximum number of items to return
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-item
        method: POST
        description: Create Item
        inputParameters:
        - name: collection_id
          in: path
          type: string
          required: true
          description: Unique identifier for a CMS collection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            fieldData: '{{tools.fieldData}}'
            isDraft: '{{tools.isDraft}}'
      - name: update-item
        method: PATCH
        description: Update Item
        inputParameters:
        - name: collection_id
          in: path
          type: string
          required: true
          description: Unique identifier for a CMS collection
        - name: item_id
          in: path
          type: string
          required: true
          description: Unique identifier for a CMS item
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            fieldData: '{{tools.fieldData}}'
      - name: delete-item
        method: DELETE
        description: Delete Item
        inputParameters:
        - name: collection_id
          in: path
          type: string
          required: true
          description: Unique identifier for a CMS collection
        - name: item_id
          in: path
          type: string
          required: true
          description: Unique identifier for a CMS item
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: publish-item
        method: POST
        description: Publish Item
        inputParameters:
        - name: collection_id
          in: path
          type: string
          required: true
          description: Unique identifier for a CMS collection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            itemIds: '{{tools.itemIds}}'
    - name: webhooks
      path: /sites/{site_id}/webhooks
      description: Webhooks for Webflow site event notifications
      operations:
      - name: list-webhooks
        method: GET
        description: List Webhooks
        inputParameters:
        - name: site_id
          in: path
          type: string
          required: true
          description: Unique identifier for a Webflow site
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-webhook
        method: POST
        description: Create Webhook
        inputParameters:
        - name: site_id
          in: path
          type: string
          required: true
          description: Unique identifier for a Webflow site
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            triggerType: '{{tools.triggerType}}'
            url: '{{tools.url}}'
  exposes:
  - type: rest
    port: 8080
    namespace: webflow-cms-ecommerce-api
    description: Unified REST API for Webflow CMS and ecommerce management.
    resources:
    - path: /v1/sites
      name: sites
      description: Webflow site management
      operations:
      - method: GET
        name: list-sites
        description: List all Webflow sites
        call: webflow-data.list-sites
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/sites/{site_id}/publish
      name: site-publish
      description: Publish a Webflow site
      operations:
      - method: POST
        name: publish-site
        description: Publish site to all domains
        call: webflow-data.publish-site
        with:
          site_id: rest.site_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/collections
      name: collections
      description: CMS collection management
      operations:
      - method: GET
        name: list-collections
        description: List CMS collections
        call: webflow-data.list-collections
        with:
          site_id: rest.site_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/items
      name: items
      description: CMS item management
      operations:
      - method: GET
        name: list-items
        description: List CMS items
        call: webflow-data.list-items
        with:
          collection_id: rest.collection_id
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: create-item
        description: Create a CMS item
        call: webflow-data.create-item
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/items/{item_id}
      name: item
      description: Single CMS item operations
      operations:
      - method: PATCH
        name: update-item
        description: Update a CMS item
        call: webflow-data.update-item
        with:
          collection_id: rest.collection_id
          item_id: rest.item_id
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: delete-item
        description: Delete a CMS item
        call: webflow-data.delete-item
        with:
          collection_id: rest.collection_id
          item_id: rest.item_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/webhooks
      name: webhooks
      description: Webhook event subscriptions
      operations:
      - method: GET
        name: list-webhooks
        description: List webhooks
        call: webflow-data.list-webhooks
        with:
          site_id: rest.site_id
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: create-webhook
        description: Create a webhook
        call: webflow-data.create-webhook
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9080
    namespace: webflow-cms-ecommerce-mcp
    transport: http
    description: MCP server for AI-assisted Webflow CMS and ecommerce management.
    tools:
    - name: list-sites
      description: List all Webflow sites accessible with the API key
      hints:
        readOnly: true
        openWorld: true
      call: webflow-data.list-sites
      outputParameters:
      - type: object
        mapping: $.
    - name: publish-site
      description: Publish a Webflow site to make changes live
      hints:
        readOnly: false
        destructive: false
      call: webflow-data.publish-site
      with:
        site_id: tools.site_id
      outputParameters:
      - type: object
        mapping: $.
    - name: list-collections
      description: List CMS collections in a Webflow site
      hints:
        readOnly: true
        openWorld: true
      call: webflow-data.list-collections
      with:
        site_id: tools.site_id
      outputParameters:
      - type: object
        mapping: $.
    - name: list-cms-items
      description: List all items in a Webflow CMS collection
      hints:
        readOnly: true
        openWorld: true
      call: webflow-data.list-items
      with:
        collection_id: tools.collection_id
      outputParameters:
      - type: object
        mapping: $.
    - name: create-cms-item
      description: Create a new content item in a Webflow CMS collection
      hints:
        readOnly: false
        destructive: false
      call: webflow-data.create-item
      with:
        collection_id: tools.collection_id
        fieldData: tools.fieldData
      outputParameters:
      - type: object
        mapping: $.
    - name: update-cms-item
      description: Update an existing Webflow CMS item
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: webflow-data.update-item
      with:
        collection_id: tools.collection_id
        item_id: tools.item_id
        fieldData: tools.fieldData
      outputParameters:
      - type: object
        mapping: $.
    - name: publish-cms-items
      description: Publish CMS items to make them live on the Webflow site
      hints:
        readOnly: false
        destructive: false
      call: webflow-data.publish-item
      with:
        collection_id: tools.collection_id
        itemIds: tools.itemIds
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-cms-item
      description: Delete a CMS item permanently
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: webflow-data.delete-item
      with:
        collection_id: tools.collection_id
        item_id: tools.item_id
      outputParameters:
      - type: object
        mapping: $.
    - name: list-webhooks
      description: List registered webhooks for a Webflow site
      hints:
        readOnly: true
        openWorld: false
      call: webflow-data.list-webhooks
      with:
        site_id: tools.site_id
      outputParameters:
      - type: object
        mapping: $.
    - name: create-webhook
      description: Create a webhook to receive Webflow site events
      hints:
        readOnly: false
        destructive: false
      call: webflow-data.create-webhook
      with:
        site_id: tools.site_id
        triggerType: tools.triggerType
        url: tools.url
      outputParameters:
      - type: object
        mapping: $.