naftiko: 1.0.0-alpha2
info:
  label: US Department of Commerce Content
  description: Workflow capability for accessing US Department of Commerce news, blog posts, and media content. Useful for
    journalists, researchers, policy analysts, and citizens who need to monitor Commerce Department announcements, economic
    reports, and agency updates.
  tags:
  - Commerce
  - Federal Government
  - News
  - Content
  - Open Data
  created: '2026-05-03'
  modified: '2026-05-06'
binds:
- namespace: env
  keys: {}
capability:
  consumes:
  - type: http
    namespace: commerce-gov
    baseUri: https://www.commerce.gov
    description: Content API for Commerce.gov news, blogs, and images
    resources:
    - name: news
      path: /api/news
      description: News articles published on Commerce.gov
      operations:
      - name: list-news
        method: GET
        description: List news articles
        inputParameters:
        - name: page
          in: query
          type: integer
          required: false
          description: Page number for pagination
        - name: items_per_page
          in: query
          type: integer
          required: false
          description: Number of items per page
        - name: sort_order
          in: query
          type: string
          required: false
          description: Sort direction (ASC or DESC)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: get-news-article
        method: GET
        description: Get a specific news article by ID
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
          description: News article identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: blogs
      path: /api/blog
      description: Blog posts published on Commerce.gov
      operations:
      - name: list-blogs
        method: GET
        description: List blog posts
        inputParameters:
        - name: page
          in: query
          type: integer
          required: false
          description: Page number for pagination
        - name: items_per_page
          in: query
          type: integer
          required: false
          description: Number of items per page
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: get-blog-post
        method: GET
        description: Get a specific blog post by ID
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
          description: Blog post identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: images
      path: /api/image
      description: Images published on Commerce.gov
      operations:
      - name: list-images
        method: GET
        description: List images
        inputParameters:
        - name: page
          in: query
          type: integer
          required: false
          description: Page number for pagination
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: commerce-content-api
    description: Unified REST API for accessing US Department of Commerce content.
    resources:
    - path: /v1/news
      name: news
      description: Latest news from the US Department of Commerce
      operations:
      - method: GET
        name: list-news
        description: List recent Commerce Department news articles
        call: commerce-gov.list-news
        with:
          page: rest.page
          items_per_page: rest.items_per_page
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/news/{id}
      name: news-item
      description: Single Commerce Department news article
      operations:
      - method: GET
        name: get-news-article
        description: Get a specific Commerce Department news article
        call: commerce-gov.get-news-article
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/blogs
      name: blogs
      description: Blog posts from Commerce Department officials and bureaus
      operations:
      - method: GET
        name: list-blogs
        description: List Commerce Department blog posts
        call: commerce-gov.list-blogs
        with:
          page: rest.page
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/blogs/{id}
      name: blog-item
      description: Single Commerce Department blog post
      operations:
      - method: GET
        name: get-blog-post
        description: Get a specific Commerce Department blog post
        call: commerce-gov.get-blog-post
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/images
      name: images
      description: Media images from Commerce Department
      operations:
      - method: GET
        name: list-images
        description: List Commerce Department images
        call: commerce-gov.list-images
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: commerce-content-mcp
    transport: http
    description: MCP server for AI-assisted monitoring of US Department of Commerce announcements and content.
    tools:
    - name: list-commerce-news
      description: List recent news articles from the US Department of Commerce. Use to monitor agency announcements, trade
        policy updates, economic reports, and bureau news from NOAA, Census, BEA, ITA, and NIST.
      hints:
        readOnly: true
        openWorld: true
      call: commerce-gov.list-news
      with:
        page: tools.page
        items_per_page: tools.items_per_page
      outputParameters:
      - type: object
        mapping: $.
    - name: get-commerce-news-article
      description: Get the full text of a specific Commerce Department news article by ID. Returns title, body, date, tags,
        and featured image.
      hints:
        readOnly: true
        openWorld: false
      call: commerce-gov.get-news-article
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: list-commerce-blog-posts
      description: List blog posts from Commerce Department officials and bureaus. Blog posts provide policy commentary, program
        updates, and feature stories.
      hints:
        readOnly: true
        openWorld: true
      call: commerce-gov.list-blogs
      with:
        page: tools.page
      outputParameters:
      - type: object
        mapping: $.
    - name: get-commerce-blog-post
      description: Get the full content of a specific Commerce Department blog post. Returns author, body text, date, and
        topic tags.
      hints:
        readOnly: true
        openWorld: false
      call: commerce-gov.get-blog-post
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: list-commerce-images
      description: List images and media assets published by the Commerce Department. Useful for finding official images for
        news stories and publications.
      hints:
        readOnly: true
        openWorld: true
      call: commerce-gov.list-images
      outputParameters:
      - type: object
        mapping: $.