`treasury_outlays`

Pack: treasury-fiscal · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/treasury_outlays for the schema, then POST the same URL with its arguments for the data.

US federal outlays by budget function (Net Interest, National Defense, Social Security, Medicare, Health, …) plus total net outlays, total receipts and the deficit, from the U.S. Treasury Monthly Treasury Statement. Every row carries current-month, fiscal-year-to-date and prior-year-to-date dollars, the statement date it came from, and its basis (net outlays, nominal dollars, fiscal year Oct-Sep). Use for “net interest outlays FY2026”, “federal spending on defense through August”, “total outlays and deficit”. Covers fiscal years 2015 onward; earlier years or statements not yet released return found:false with the reason, never an empty list. Omit fiscal_year/month for the latest statement.

Parameters

Name	Type	Required	Description
`fiscal_year`	number	no	Federal fiscal year (Oct-Sep), e.g. 2026 = Oct 2025 through Sep 2026. With no month, returns the fiscal-year-end (September) statement, or the latest statement released in that year if it is not over.
`month`	string	no	Calendar month of the statement: 1-12 or a name (“September”). With fiscal_year picks that month of that fiscal year; alone picks the most recent such month published.
`function`	string	no	Budget function to return, e.g. “Net Interest”, “National Defense”, “Medicare”. Case-insensitive substring match. Omit for all functions.

Example call

Arguments

{
  "fiscal_year": 2026,
  "function": "Net Interest"
}

curl

curl -X POST https://gateway.pipeworx.io/treasury-fiscal/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"treasury_outlays","arguments":{"fiscal_year":2026,"function":"Net Interest"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('treasury_outlays', {
  "fiscal_year": 2026,
  "function": "Net Interest"
});

More examples

{
  "fiscal_year": 2026,
  "month": "March",
  "function": "Net Interest"
}

Response shape

Field	Type	Description
`found`	boolean	false when the period is not covered or not yet released; see reason
`reason`	string
`incomplete`	boolean
`requested`	string
`requested_function`	string
`fiscal_year`	number
`latest_statement_available`	string \| null
`available_functions`	array
`source`	string
`statement_date`	string
`period`	string
`fiscal_year_complete`	boolean
`note`	string
`basis`	string
`data_as_of`	string
`as_of`	string
`functions`	array
`totals`	object
`reconciliation`	object

Full JSON Schema

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean",
      "description": "false when the period is not covered or not yet released; see reason"
    },
    "reason": {
      "type": "string"
    },
    "incomplete": {
      "type": "boolean"
    },
    "requested": {
      "type": "string"
    },
    "requested_function": {
      "type": "string"
    },
    "fiscal_year": {
      "type": "number"
    },
    "latest_statement_available": {
      "type": [
        "string",
        "null"
      ]
    },
    "available_functions": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "source": {
      "type": "string"
    },
    "statement_date": {
      "type": "string"
    },
    "period": {
      "type": "string"
    },
    "fiscal_year_complete": {
      "type": "boolean"
    },
    "note": {
      "type": "string"
    },
    "basis": {
      "type": "string"
    },
    "data_as_of": {
      "type": "string"
    },
    "as_of": {
      "type": "string"
    },
    "functions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "function": {
            "type": "string"
          },
          "month_usd": {
            "type": [
              "number",
              "null"
            ]
          },
          "fytd_usd": {
            "type": [
              "number",
              "null"
            ]
          },
          "prior_fytd_usd": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "additionalProperties": true
      }
    },
    "totals": {
      "type": "object",
      "properties": {
        "net_outlays": {
          "type": "object",
          "properties": {
            "month_usd": {
              "type": [
                "number",
                "null"
              ]
            },
            "fytd_usd": {
              "type": [
                "number",
                "null"
              ]
            },
            "prior_fytd_usd": {
              "type": [
                "number",
                "null"
              ]
            }
          },
          "additionalProperties": true
        },
        "receipts": {
          "type": "object",
          "properties": {
            "month_usd": {
              "type": [
                "number",
                "null"
              ]
            },
            "fytd_usd": {
              "type": [
                "number",
                "null"
              ]
            },
            "prior_fytd_usd": {
              "type": [
                "number",
                "null"
              ]
            }
          },
          "additionalProperties": true
        },
        "deficit": {
          "type": "object",
          "properties": {
            "month_usd": {
              "type": [
                "number",
                "null"
              ]
            },
            "fytd_usd": {
              "type": [
                "number",
                "null"
              ]
            },
            "prior_fytd_usd": {
              "type": [
                "number",
                "null"
              ]
            }
          },
          "additionalProperties": true
        }
      },
      "additionalProperties": true
    },
    "reconciliation": {
      "type": "object",
      "additionalProperties": true
    }
  },
  "additionalProperties": true
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the treasury-fiscal pack

{
  "mcpServers": {
    "treasury-fiscal": {
      "url": "https://gateway.pipeworx.io/treasury-fiscal/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

treasury_outlays