Rijksmuseum Collection API — Images

naftiko: "1.0.0-alpha2"

info:
  label: "Rijksmuseum Collection API — Images"
  description: >-
    Collection — Images. 1 operation. Lead operation: Get Collection Object
    Image Tiles. Self-contained Naftiko capability covering one Rijksmuseum
    business surface.
  tags:
    - Rijksmuseum
    - Collection
    - Images
  created: "2026-05-29"
  modified: "2026-05-29"

binds:
  - namespace: env
    keys:
      RIJKSMUSEUM_API_KEY: RIJKSMUSEUM_API_KEY

capability:

  consumes:
    - type: http
      namespace: "collection-images"
      baseUri: "https://www.rijksmuseum.nl/api"
      description: "Rijksmuseum Collection API — Images business capability. Self-contained, no shared references."
      authentication:
        type: apikey
        key: key
        value: "{{env.RIJKSMUSEUM_API_KEY}}"
        placement: query
      resources:
        - name: "collection-object-tiles"
          path: "/{culture}/collection/{objectNumber}/tiles"
          operations:
            - name: "getCollectionObjectTiles"
              method: GET
              description: "Return a tile-pyramid description (z0–z6) for an object's web image to power deep-zoom experiences."
              inputParameters:
                - name: "culture"
                  in: path
                  type: string
                  required: true
                  description: "Locale: `nl` or `en`."
                - name: "objectNumber"
                  in: path
                  type: string
                  required: true
                  description: "Case-sensitive object identifier."
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: "$."

  exposes:
    - type: rest
      namespace: "collection-images-rest"
      port: 8080
      description: "REST adapter for Rijksmuseum Collection API — Images."
      resources:
        - path: "/v1/cultures/{culture}/collection/{object-number}/tiles"
          name: "collection-object-tiles"
          description: "REST surface for an object's image-tile pyramid."
          operations:
            - method: GET
              name: "getCollectionObjectTiles"
              description: "Get Collection Object Image Tiles."
              call: "collection-images.getCollectionObjectTiles"
              with:
                culture: "rest.culture"
                objectNumber: "rest.object-number"
              outputParameters:
                - type: object
                  mapping: "$."

    - type: mcp
      namespace: "collection-images-mcp"
      port: 9090
      transport: http
      description: "MCP adapter for Rijksmuseum Collection API — Images."
      tools:
        - name: "get-image-tiles"
          description: "Get Collection Object Image Tiles."
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: "collection-images.getCollectionObjectTiles"
          with:
            culture: "tools.culture"
            objectNumber: "tools.objectNumber"
          outputParameters:
            - type: object
              mapping: "$."