`budget_resolution_targets`

Pack: budget-resolutions · 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/budget_resolution_targets for the schema, then POST the same URL with its arguments for the data.

The levels a congressional budget resolution sets for a fiscal year and the years after it: federal revenues, new budget authority, outlays, deficit and debt, plus new budget authority and outlays for each budget function (National Defense, Health, Medicare, Social Security, Net Interest, …). Returns the adopted resolution; if none was adopted, the most advanced proposal that passed a chamber (clearly marked adopted:false), or found:false with a named reason. Includes a sum check: the function figures added up beside the resolution’s stated totals. Use for “FY2025 budget resolution defense outlays”, “what did the House budget plan for FY2027 assume for revenues?”. Dollars are nominal US dollars. Optional filters narrow function and year. Source: U.S. Congress, as published by the U.S. Government Publishing Office.

Parameters

Name	Type	Required	Description
`fiscal_year`	number	yes	The budget year the resolution is for, e.g. 2025. Its levels also cover the later years in the resolution (typically nine more).
`function`	string	no	Budget function, case-insensitive substring (“Defense”, “Medicare”, “Net Interest”) or the three-digit code (“050”). Omit for all functions.
`target_year`	number	no	Limit the output to one fiscal year inside the resolution (e.g. 2027 within a resolution that runs 2027-2036). Omit for every year.
`adopted_only`	boolean	no	true: return only a resolution adopted by both chambers; otherwise a one-chamber-passed plan may be returned if none was adopted (marked adopted:false).
`package_id`	string	no	Read a specific version, e.g. “BILLS-119hconres113pcs” (ids come from budget_resolution_find).

Example call

Arguments

{
  "fiscal_year": 2027,
  "target_year": 2027
}

curl

curl -X POST https://gateway.pipeworx.io/budget-resolutions/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"budget_resolution_targets","arguments":{"fiscal_year":2027,"target_year":2027}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('budget_resolution_targets', {
  "fiscal_year": 2027,
  "target_year": 2027
});

Response shape

Field	Type	Description
`found`	boolean
`fiscal_year`	number
`reason_code`	string
`reason`	string
`resolution`	string
`package_id`	string
`status`	string
`adopted`	boolean
`status_note`	string
`title`	string
`text_version_date`	string \| null
`covers_fiscal_years`	array
`basis`	string
`aggregates`	object
`functions`	array
`reconciliation`	object
`other_candidates`	array
`data_as_of`	string \| null
`source`	string

Full JSON Schema

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean"
    },
    "fiscal_year": {
      "type": "number"
    },
    "reason_code": {
      "type": "string"
    },
    "reason": {
      "type": "string"
    },
    "resolution": {
      "type": "string"
    },
    "package_id": {
      "type": "string"
    },
    "status": {
      "type": "string"
    },
    "adopted": {
      "type": "boolean"
    },
    "status_note": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "text_version_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "covers_fiscal_years": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "basis": {
      "type": "string"
    },
    "aggregates": {
      "type": "object",
      "additionalProperties": true
    },
    "functions": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "reconciliation": {
      "type": "object",
      "additionalProperties": true
    },
    "other_candidates": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "resolution": {
            "type": "string"
          },
          "package_id": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "adopted": {
            "type": "boolean"
          },
          "status_note": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "date_issued": {
            "type": [
              "string",
              "null"
            ]
          },
          "versions_seen": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          }
        },
        "additionalProperties": true
      }
    },
    "data_as_of": {
      "type": [
        "string",
        "null"
      ]
    },
    "source": {
      "type": "string"
    }
  },
  "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 budget-resolutions pack

{
  "mcpServers": {
    "budget-resolutions": {
      "url": "https://gateway.pipeworx.io/budget-resolutions/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

budget_resolution_targets