Contentstack Personalize Edge API — Manifest

naftiko: 1.0.0-alpha2
info:
  label: Contentstack Personalize Edge API — Manifest
  description: 'Contentstack Personalize Edge API — Manifest. 1 operations. Lead operation: Get personalization manifest.
    Self-contained Naftiko capability covering one Contentstack business surface.'
  tags:
  - Contentstack
  - Manifest
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    CONTENTSTACK_API_KEY: CONTENTSTACK_API_KEY
capability:
  consumes:
  - type: http
    namespace: personalize-edge-manifest
    baseUri: https://personalize-edge.contentstack.com
    description: Contentstack Personalize Edge API — Manifest business capability. Self-contained, no shared references.
    resources:
    - name: manifest
      path: /manifest
      operations:
      - name: getmanifest
        method: GET
        description: Get personalization manifest
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: x-forwarded-for
          in: header
          type: string
          description: Original client IP address for geolocation-based targeting.
        - name: user-agent
          in: header
          type: string
          description: User agent string for device-based targeting rules.
        - name: referer
          in: header
          type: string
          description: Referring URL for referral-based audience rules.
        - name: x-page-url
          in: header
          type: string
          description: Current page URL for page-based audience targeting rules.
        - name: x-live-attributes
          in: header
          type: string
          description: JSON-encoded object of real-time attribute values to evaluate audience rules against without persisting
            them.
  exposes:
  - type: rest
    namespace: personalize-edge-manifest-rest
    port: 8080
    description: REST adapter for Contentstack Personalize Edge API — Manifest. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/manifest
      name: manifest
      description: REST surface for manifest.
      operations:
      - method: GET
        name: getmanifest
        description: Get personalization manifest
        call: personalize-edge-manifest.getmanifest
        with:
          x-forwarded-for: rest.x-forwarded-for
          user-agent: rest.user-agent
          referer: rest.referer
          x-page-url: rest.x-page-url
          x-live-attributes: rest.x-live-attributes
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: personalize-edge-manifest-mcp
    port: 9090
    transport: http
    description: MCP adapter for Contentstack Personalize Edge API — Manifest. One tool per consumed operation, routed inline
      through this capability's consumes block.
    tools:
    - name: get-personalization-manifest
      description: Get personalization manifest
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: personalize-edge-manifest.getmanifest
      with:
        x-forwarded-for: tools.x-forwarded-for
        user-agent: tools.user-agent
        referer: tools.referer
        x-page-url: tools.x-page-url
        x-live-attributes: tools.x-live-attributes
      outputParameters:
      - type: object
        mapping: $.