美國聯邦機關年度預算 / 支出

us_get_agency_spending

台灣專屬MIT

**關鍵字 / Keywords**: 美國聯邦機關部會預算支出 obligation outlay budget budgetary_resources FY toptier_code agency DOD DOE NASA GSA Treasury USASpending federal spending rollup

Scope: one federal agency's per-FY budgetary rollup — total
budgetary resources · obligated · outlayed · by-period breakdown.

Endpoint:
    GET https://api.usaspending.gov/api/v2/agency/{toptier_code}/budgetary_resources/
    (with fallback resolution via
     GET https://api.usaspending.gov/api/v2/references/toptier_agencies/
     when the caller passes an agency name substring)

Args:
    toptier_code: 3-4-digit federal `toptier_code`
                  (e.g. `"097"` DOD, `"089"` Energy, `"075"` HHS,
                  `"1500"` Justice sub). Also accepts an agency name
                  substring or abbreviation ("Department of Defense",
                  "DOD", "NASA") — resolved via the toptier reference
                  list on first use.
    fiscal_year: restrict to a single FY (default: all FYs since
                 data started ~FY17).

Returns dict `{toptier_code, agency_name, fiscal_year_filter,
agency_data_by_year: [{fiscal_year, agency_budgetary_resources,
agency_total_obligated, agency_total_outlayed,
total_budgetary_resources,
agency_obligation_by_period: [{period, obligated}, ...]}, ...]}`.
License: "Creative Commons Zero v1.0 Universal (CC0-1.0)".
Rate-limited to ~5 req/sec.

輸入 schema

{
  "properties": {
    "toptier_code": {
      "title": "Toptier Code",
      "type": "string"
    },
    "fiscal_year": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Fiscal Year"
    }
  },
  "required": [
    "toptier_code"
  ],
  "title": "us_get_agency_spendingArguments",
  "type": "object"
}

呼叫方式

配置好 Twinkle Hub 的 MCP client 後，agent 會看到 us_get_agency_spending。直接讓它呼叫即可，例如：

# Ask Claude / any MCP client:
請用 us_get_agency_spending 處理 "…"。

# It will call:
us_get_agency_spending(input="…")

尚未設定 Client？

Claude Desktop 約 3 分鐘即可完成設定 — 下載 .mcpb 檔案並雙擊即可，或參閱文件中的各 Client 安裝步驟。

查看使用者設定文件

輸入 schema

呼叫​方式

呼叫方式