Treasury Fiscal Data API — National Debt

naftiko: 1.0.0-alpha2
info:
  label: Treasury Fiscal Data API — National Debt
  description: 'Treasury Fiscal Data API — National Debt. 4 operations. Lead operation: Treasury Fiscal Data Get Gift Contributions
    to Reduce the Public Debt. Self-contained Naftiko capability covering one U S Treasury Fiscal Data business surface.'
  tags:
  - U S Treasury Fiscal Data
  - National Debt
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    U_S_TREASURY_FISCAL_DATA_API_KEY: U_S_TREASURY_FISCAL_DATA_API_KEY
capability:
  consumes:
  - type: http
    namespace: treasury-fiscal-data-national-debt
    baseUri: https://api.fiscaldata.treasury.gov/services/api/fiscal_service
    description: Treasury Fiscal Data API — National Debt business capability. Self-contained, no shared references.
    resources:
    - name: v1-accounting-od-gift_contributions
      path: /v1/accounting/od/gift_contributions
      operations:
      - name: getgiftcontributionsdebt
        method: GET
        description: Treasury Fiscal Data Get Gift Contributions to Reduce the Public Debt
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-accounting-od-avg_interest_rates
      path: /v2/accounting/od/avg_interest_rates
      operations:
      - name: getavginterestrates
        method: GET
        description: Treasury Fiscal Data Get Average Interest Rates on U.S. Treasury Securities
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-accounting-od-debt_to_penny
      path: /v2/accounting/od/debt_to_penny
      operations:
      - name: getdebttopenny
        method: GET
        description: Treasury Fiscal Data Get Debt to the Penny
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-accounting-od-interest_expense
      path: /v2/accounting/od/interest_expense
      operations:
      - name: getinterestexpensedebt
        method: GET
        description: Treasury Fiscal Data Get Interest Expense on the Debt Outstanding
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    namespace: treasury-fiscal-data-national-debt-rest
    port: 8080
    description: REST adapter for Treasury Fiscal Data API — National Debt. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/v1/accounting/od/gift-contributions
      name: v1-accounting-od-gift-contributions
      description: REST surface for v1-accounting-od-gift_contributions.
      operations:
      - method: GET
        name: getgiftcontributionsdebt
        description: Treasury Fiscal Data Get Gift Contributions to Reduce the Public Debt
        call: treasury-fiscal-data-national-debt.getgiftcontributionsdebt
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/accounting/od/avg-interest-rates
      name: v2-accounting-od-avg-interest-rates
      description: REST surface for v2-accounting-od-avg_interest_rates.
      operations:
      - method: GET
        name: getavginterestrates
        description: Treasury Fiscal Data Get Average Interest Rates on U.S. Treasury Securities
        call: treasury-fiscal-data-national-debt.getavginterestrates
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/accounting/od/debt-to-penny
      name: v2-accounting-od-debt-to-penny
      description: REST surface for v2-accounting-od-debt_to_penny.
      operations:
      - method: GET
        name: getdebttopenny
        description: Treasury Fiscal Data Get Debt to the Penny
        call: treasury-fiscal-data-national-debt.getdebttopenny
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/accounting/od/interest-expense
      name: v2-accounting-od-interest-expense
      description: REST surface for v2-accounting-od-interest_expense.
      operations:
      - method: GET
        name: getinterestexpensedebt
        description: Treasury Fiscal Data Get Interest Expense on the Debt Outstanding
        call: treasury-fiscal-data-national-debt.getinterestexpensedebt
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: treasury-fiscal-data-national-debt-mcp
    port: 9090
    transport: http
    description: MCP adapter for Treasury Fiscal Data API — National Debt. One tool per consumed operation, routed inline
      through this capability's consumes block.
    tools:
    - name: treasury-fiscal-data-get-gift
      description: Treasury Fiscal Data Get Gift Contributions to Reduce the Public Debt
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: treasury-fiscal-data-national-debt.getgiftcontributionsdebt
      outputParameters:
      - type: object
        mapping: $.
    - name: treasury-fiscal-data-get-average
      description: Treasury Fiscal Data Get Average Interest Rates on U.S. Treasury Securities
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: treasury-fiscal-data-national-debt.getavginterestrates
      outputParameters:
      - type: object
        mapping: $.
    - name: treasury-fiscal-data-get-debt
      description: Treasury Fiscal Data Get Debt to the Penny
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: treasury-fiscal-data-national-debt.getdebttopenny
      outputParameters:
      - type: object
        mapping: $.
    - name: treasury-fiscal-data-get-interest
      description: Treasury Fiscal Data Get Interest Expense on the Debt Outstanding
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: treasury-fiscal-data-national-debt.getinterestexpensedebt
      outputParameters:
      - type: object
        mapping: $.