Architect of the Capitol Data API — Art Collection

naftiko: 1.0.0-alpha2
info:
  label: Architect of the Capitol Data API — Art Collection
  description: 'Architect of the Capitol Data API — Art Collection. 2 operations. Lead operation: List Capitol art collection.
    Self-contained Naftiko capability covering one Architect Of The Capitol business surface.'
  tags:
  - Architect Of The Capitol
  - Art Collection
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    ARCHITECT_OF_THE_CAPITOL_API_KEY: ARCHITECT_OF_THE_CAPITOL_API_KEY
capability:
  consumes:
  - type: http
    namespace: aoc-data-art-collection
    baseUri: https://api.aoc.gov/v1
    description: Architect of the Capitol Data API — Art Collection business capability. Self-contained, no shared references.
    resources:
    - name: artworks
      path: /artworks
      operations:
      - name: listartworks
        method: GET
        description: List Capitol art collection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: medium
          in: query
          type: string
        - name: artist
          in: query
          type: string
        - name: location
          in: query
          type: string
        - name: limit
          in: query
          type: integer
        - name: offset
          in: query
          type: integer
    - name: artworks-artworkId
      path: /artworks/{artworkId}
      operations:
      - name: getartwork
        method: GET
        description: Get artwork details
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: artworkId
          in: path
          type: string
          required: true
  exposes:
  - type: rest
    namespace: aoc-data-art-collection-rest
    port: 8080
    description: REST adapter for Architect of the Capitol Data API — Art Collection. One Spectral-compliant resource per
      consumed operation, prefixed with /v1.
    resources:
    - path: /v1/artworks
      name: artworks
      description: REST surface for artworks.
      operations:
      - method: GET
        name: listartworks
        description: List Capitol art collection
        call: aoc-data-art-collection.listartworks
        with:
          medium: rest.medium
          artist: rest.artist
          location: rest.location
          limit: rest.limit
          offset: rest.offset
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/artworks/{artworkid}
      name: artworks-artworkid
      description: REST surface for artworks-artworkId.
      operations:
      - method: GET
        name: getartwork
        description: Get artwork details
        call: aoc-data-art-collection.getartwork
        with:
          artworkId: rest.artworkId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: aoc-data-art-collection-mcp
    port: 9090
    transport: http
    description: MCP adapter for Architect of the Capitol Data API — Art Collection. One tool per consumed operation, routed
      inline through this capability's consumes block.
    tools:
    - name: list-capitol-art-collection
      description: List Capitol art collection
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: aoc-data-art-collection.listartworks
      with:
        medium: tools.medium
        artist: tools.artist
        location: tools.location
        limit: tools.limit
        offset: tools.offset
      outputParameters:
      - type: object
        mapping: $.
    - name: get-artwork-details
      description: Get artwork details
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: aoc-data-art-collection.getartwork
      with:
        artworkId: tools.artworkId
      outputParameters:
      - type: object
        mapping: $.