Treasury Fiscal Data Intelligence

naftiko: "1.0.0-alpha1"

info:
  label: "Treasury Fiscal Data Intelligence"
  description: >-
    Workflow capability for economists, policy analysts, financial journalists,
    and researchers to access U.S. Treasury federal financial data including
    national debt trends, exchange rates, interest rates, and Treasury
    financial statement data. Provides AI-assisted access to the Treasury
    Fiscal Data API for data analysis and visualization workflows.
  tags:
    - Treasury
    - Federal Finance
    - National Debt
    - Exchange Rates
    - Government Data
    - Economics
  created: "2026-05-03"
  modified: "2026-05-03"

capability:
  consumes:
    - import: treasury-fiscal
      location: ./shared/treasury-fiscal-data-api.yaml

  exposes:
    - type: rest
      port: 8080
      namespace: fiscal-intelligence-api
      description: "Unified REST API for Treasury fiscal data intelligence."
      resources:
        - path: /v1/debt
          name: national-debt
          description: "U.S. national debt data from the Debt to the Penny dataset."
          operations:
            - method: GET
              name: get-national-debt
              description: "Retrieve current and historical U.S. public debt outstanding."
              call: "treasury-fiscal.get-debt-to-penny"
              with:
                fields: "rest.fields"
                filter: "rest.filter"
                sort: "rest.sort"
                page[number]: "rest.page_number"
                page[size]: "rest.page_size"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/exchange-rates
          name: exchange-rates
          description: "Treasury foreign currency exchange rates."
          operations:
            - method: GET
              name: get-exchange-rates
              description: "Retrieve official Treasury reporting rates of exchange by country and quarter."
              call: "treasury-fiscal.get-exchange-rates"
              with:
                fields: "rest.fields"
                filter: "rest.filter"
                sort: "rest.sort"
                page[number]: "rest.page_number"
                page[size]: "rest.page_size"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/interest-rates
          name: interest-rates
          description: "Average interest rates on U.S. Treasury securities."
          operations:
            - method: GET
              name: get-interest-rates
              description: "Retrieve monthly average interest rates for Treasury securities by type."
              call: "treasury-fiscal.get-avg-interest-rates"
              with:
                fields: "rest.fields"
                filter: "rest.filter"
                sort: "rest.sort"
                page[number]: "rest.page_number"
                page[size]: "rest.page_size"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/daily-treasury
          name: daily-treasury-statement
          description: "Daily Treasury Statement account balances and transactions."
          operations:
            - method: GET
              name: get-daily-treasury
              description: "Retrieve DTS data showing daily Treasury account activity."
              call: "treasury-fiscal.get-daily-treasury-statement"
              with:
                fields: "rest.fields"
                filter: "rest.filter"
                sort: "rest.sort"
                page[number]: "rest.page_number"
                page[size]: "rest.page_size"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/monthly-treasury
          name: monthly-treasury-statement
          description: "Monthly Treasury Statement budget receipts and outlays."
          operations:
            - method: GET
              name: get-monthly-treasury
              description: "Retrieve MTS data showing monthly federal budget activity."
              call: "treasury-fiscal.get-monthly-treasury-statement"
              with:
                fields: "rest.fields"
                filter: "rest.filter"
                sort: "rest.sort"
                page[number]: "rest.page_number"
                page[size]: "rest.page_size"
              outputParameters:
                - type: object
                  mapping: "$."

    - type: mcp
      port: 9090
      namespace: fiscal-intelligence-mcp
      transport: http
      description: "MCP server for AI-assisted federal fiscal data analysis using the Treasury Fiscal Data API."
      tools:
        - name: get-national-debt
          description: >-
            Retrieve current and historical U.S. national debt data from the
            Treasury Debt to the Penny dataset. Returns total public debt
            outstanding, debt held by the public, and intragovernmental
            holdings. Data updated daily. Use filter parameter like
            'record_date:gte:2024-01-01' to limit results by date.
          hints:
            readOnly: true
            openWorld: true
          call: "treasury-fiscal.get-debt-to-penny"
          with:
            fields: "tools.fields"
            filter: "tools.filter"
            sort: "tools.sort"
            page[number]: "tools.page_number"
            page[size]: "tools.page_size"
          outputParameters:
            - type: object
              mapping: "$."

        - name: get-exchange-rates
          description: >-
            Retrieve official U.S. Treasury foreign currency exchange rates
            used for federal reporting purposes. Data updated quarterly.
            Filter by country name or currency using the filter parameter
            (e.g., 'country:eq:Japan'). Covers approximately 170 countries.
          hints:
            readOnly: true
            openWorld: true
          call: "treasury-fiscal.get-exchange-rates"
          with:
            fields: "tools.fields"
            filter: "tools.filter"
            sort: "tools.sort"
            page[number]: "tools.page_number"
            page[size]: "tools.page_size"
          outputParameters:
            - type: object
              mapping: "$."

        - name: get-treasury-interest-rates
          description: >-
            Retrieve monthly average interest rates for U.S. Treasury
            securities by security type (Bills, Notes, Bonds, TIPS, etc.).
            Useful for tracking borrowing costs and monetary policy analysis.
            Filter by security_desc to get rates for a specific security type.
          hints:
            readOnly: true
            openWorld: true
          call: "treasury-fiscal.get-avg-interest-rates"
          with:
            fields: "tools.fields"
            filter: "tools.filter"
            sort: "tools.sort"
            page[number]: "tools.page_number"
            page[size]: "tools.page_size"
          outputParameters:
            - type: object
              mapping: "$."

        - name: get-daily-treasury-statement
          description: >-
            Retrieve Daily Treasury Statement (DTS) data showing federal
            government cash flows including deposits, withdrawals, and account
            balances. The DTS is published each business day by the Bureau
            of the Fiscal Service. Use filter to query by date or account type.
          hints:
            readOnly: true
            openWorld: true
          call: "treasury-fiscal.get-daily-treasury-statement"
          with:
            fields: "tools.fields"
            filter: "tools.filter"
            sort: "tools.sort"
            page[number]: "tools.page_number"
            page[size]: "tools.page_size"
          outputParameters:
            - type: object
              mapping: "$."

        - name: get-monthly-treasury-statement
          description: >-
            Retrieve Monthly Treasury Statement (MTS) data with consolidated
            federal budget receipts, outlays, and surplus/deficit by
            classification. Published monthly by the Bureau of the Fiscal
            Service. Essential for budget analysis and deficit tracking.
          hints:
            readOnly: true
            openWorld: true
          call: "treasury-fiscal.get-monthly-treasury-statement"
          with:
            fields: "tools.fields"
            filter: "tools.filter"
            sort: "tools.sort"
            page[number]: "tools.page_number"
            page[size]: "tools.page_size"
          outputParameters:
            - type: object
              mapping: "$."