naftiko: 1.0.0-alpha2
info:
  label: International Trade — Monthly Time Series
  description: 'International Trade — Monthly Time Series. 4 operations covering imports and exports by HS,
    port-HS, and state-HS slices. Lead operation: Query Monthly Exports By HS Commodity Code.'
  tags:
  - US Census Bureau
  - Trade
  - Imports
  - Exports
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    CENSUS_API_KEY: CENSUS_API_KEY
capability:
  consumes:
  - type: http
    namespace: census-international-trade-timeseries
    baseUri: https://api.census.gov/data
    resources:
    - name: exports-hs
      path: /timeseries/intltrade/exports/hs
      operations:
      - name: queryexportshs
        method: GET
        description: Query Monthly Exports By HS Commodity Code
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: imports-hs
      path: /timeseries/intltrade/imports/hs
      operations:
      - name: queryimportshs
        method: GET
        description: Query Monthly Imports By HS Commodity Code
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: exports-porths
      path: /timeseries/intltrade/exports/porths
      operations:
      - name: queryexportsporths
        method: GET
        description: Query Monthly Exports By Port And HS
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: imports-porths
      path: /timeseries/intltrade/imports/porths
      operations:
      - name: queryimportsporths
        method: GET
        description: Query Monthly Imports By Port And HS
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: apikey
      key: key
      value: '{{env.CENSUS_API_KEY}}'
      placement: query
  exposes:
  - type: mcp
    namespace: census-international-trade-timeseries-mcp
    port: 9090
    transport: http
    tools:
    - name: census-trade-exports-hs
      description: Query Monthly Exports By HS Commodity Code
      hints:
        readOnly: true
      call: census-international-trade-timeseries.queryexportshs
      outputParameters:
      - type: object
        mapping: $.
    - name: census-trade-imports-hs
      description: Query Monthly Imports By HS Commodity Code
      hints:
        readOnly: true
      call: census-international-trade-timeseries.queryimportshs
      outputParameters:
      - type: object
        mapping: $.
    - name: census-trade-exports-porths
      description: Query Monthly Exports By Port And HS
      hints:
        readOnly: true
      call: census-international-trade-timeseries.queryexportsporths
      outputParameters:
      - type: object
        mapping: $.
    - name: census-trade-imports-porths
      description: Query Monthly Imports By Port And HS
      hints:
        readOnly: true
      call: census-international-trade-timeseries.queryimportsporths
      outputParameters:
      - type: object
        mapping: $.