CPSC Recalls API — Recalls

naftiko: 1.0.0-alpha2
info:
  label: CPSC Recalls API — Recalls
  description: 'CPSC Recalls API — Recalls. 1 operations. Lead operation: Search CPSC recalls. Self-contained Naftiko capability
    covering one Consumer Product Safety Commission business surface.'
  tags:
  - Consumer Product Safety Commission
  - Recalls
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    CONSUMER_PRODUCT_SAFETY_COMMISSION_API_KEY: CONSUMER_PRODUCT_SAFETY_COMMISSION_API_KEY
capability:
  consumes:
  - type: http
    namespace: cpsc-recalls-recalls
    baseUri: https://www.saferproducts.gov/RestWebServices
    description: CPSC Recalls API — Recalls business capability. Self-contained, no shared references.
    resources:
    - name: Recall
      path: /Recall
      operations:
      - name: searchrecalls
        method: GET
        description: Search CPSC recalls
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: format
          in: query
          type: string
        - name: RecallID
          in: query
          type: integer
        - name: RecallNumber
          in: query
          type: string
        - name: RecallTitle
          in: query
          type: string
        - name: RecallDateStart
          in: query
          type: string
        - name: RecallDateEnd
          in: query
          type: string
        - name: LastPublishDateStart
          in: query
          type: string
        - name: LastPublishDateEnd
          in: query
          type: string
        - name: RecallURL
          in: query
          type: string
        - name: ConsumerContact
          in: query
          type: string
        - name: ProductName
          in: query
          type: string
        - name: ProductDescription
          in: query
          type: string
        - name: ProductModel
          in: query
          type: string
        - name: ProductType
          in: query
          type: string
        - name: InconjunctionURL
          in: query
          type: string
        - name: ImageURL
          in: query
          type: string
        - name: Injury
          in: query
          type: string
        - name: Manufacturer
          in: query
          type: string
        - name: Retailer
          in: query
          type: string
        - name: Importer
          in: query
          type: string
        - name: Distributor
          in: query
          type: string
        - name: ManufacturerCountry
          in: query
          type: string
        - name: UPC
          in: query
          type: string
        - name: Hazard
          in: query
          type: string
        - name: Remedy
          in: query
          type: string
        - name: RemedyOption
          in: query
          type: string
  exposes:
  - type: rest
    namespace: cpsc-recalls-recalls-rest
    port: 8080
    description: REST adapter for CPSC Recalls API — Recalls. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/recall
      name: recall
      description: REST surface for Recall.
      operations:
      - method: GET
        name: searchrecalls
        description: Search CPSC recalls
        call: cpsc-recalls-recalls.searchrecalls
        with:
          format: rest.format
          RecallID: rest.RecallID
          RecallNumber: rest.RecallNumber
          RecallTitle: rest.RecallTitle
          RecallDateStart: rest.RecallDateStart
          RecallDateEnd: rest.RecallDateEnd
          LastPublishDateStart: rest.LastPublishDateStart
          LastPublishDateEnd: rest.LastPublishDateEnd
          RecallURL: rest.RecallURL
          ConsumerContact: rest.ConsumerContact
          ProductName: rest.ProductName
          ProductDescription: rest.ProductDescription
          ProductModel: rest.ProductModel
          ProductType: rest.ProductType
          InconjunctionURL: rest.InconjunctionURL
          ImageURL: rest.ImageURL
          Injury: rest.Injury
          Manufacturer: rest.Manufacturer
          Retailer: rest.Retailer
          Importer: rest.Importer
          Distributor: rest.Distributor
          ManufacturerCountry: rest.ManufacturerCountry
          UPC: rest.UPC
          Hazard: rest.Hazard
          Remedy: rest.Remedy
          RemedyOption: rest.RemedyOption
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: cpsc-recalls-recalls-mcp
    port: 9090
    transport: http
    description: MCP adapter for CPSC Recalls API — Recalls. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: search-cpsc-recalls
      description: Search CPSC recalls
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cpsc-recalls-recalls.searchrecalls
      with:
        format: tools.format
        RecallID: tools.RecallID
        RecallNumber: tools.RecallNumber
        RecallTitle: tools.RecallTitle
        RecallDateStart: tools.RecallDateStart
        RecallDateEnd: tools.RecallDateEnd
        LastPublishDateStart: tools.LastPublishDateStart
        LastPublishDateEnd: tools.LastPublishDateEnd
        RecallURL: tools.RecallURL
        ConsumerContact: tools.ConsumerContact
        ProductName: tools.ProductName
        ProductDescription: tools.ProductDescription
        ProductModel: tools.ProductModel
        ProductType: tools.ProductType
        InconjunctionURL: tools.InconjunctionURL
        ImageURL: tools.ImageURL
        Injury: tools.Injury
        Manufacturer: tools.Manufacturer
        Retailer: tools.Retailer
        Importer: tools.Importer
        Distributor: tools.Distributor
        ManufacturerCountry: tools.ManufacturerCountry
        UPC: tools.UPC
        Hazard: tools.Hazard
        Remedy: tools.Remedy
        RemedyOption: tools.RemedyOption
      outputParameters:
      - type: object
        mapping: $.