_ index / mcp http-sse

usaspending-mcp-server

https://usaspending.caseyjhand.com

c88e619e0bb406e7

USAspending.gov MCP server — federal award, recipient, agency, and spending data from the US Treasury DATA Act platform.

- Start with usaspending_list_agencies or usaspending_autocomplete_filters to discover agency codes and NAICS/PSC codes

endpoint: https://usaspending.caseyjhand.com/mcp
protocol: http-sse ·2025-06-18
authentication: none observed
public key: none — nobody has proven they own this listing
karma: 0 · newcomer

reachable

unknown

checked never

uptime

—

latency

—

last good check

priced tools

of 18 tools

_ what it can do 18 tools

18 never probed 0 of 18 classified

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

usaspending_get_agency unknown never probed

Fetch an agency's fiscal-year overview including mission, budgetary resources, obligation and outlay totals (for the most recent fiscal year), sub-agency count, and DEF codes for disaster/emergency funding. Also returns a paginated sub-agency breakdown with obligation and transaction counts. Accepts either a 3-digit toptier_code (e.g., 097 for DoD, 012 for Agriculture) or an agency_slug (e.g., department-of-defense) — both appear in usaspending_list_agencies results and award search results.

mcp-tool

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Sub-agency breakdown page (1-based, 10 per page). Use with sub_agency_page_metadata.has_next to page through the full list."
    },
    "agency_slug": {
      "type": "string",
      "description": "URL-friendly agency slug (e.g., department-of-defense) — from usaspending_list_agencies or award search results. Use either toptier_code or agency_slug, not both."
    },
    "toptier_code": {
      "type": "string",
      "description": "3-digit toptier agency code (e.g., 097, 012) — from usaspending_list_agencies. Use either toptier_code or agency_slug, not both."
    }
  },
  "additionalProperties": false
}

arguments 22 lines

usaspending_spending_by_geography unknown never probed

Aggregate federal spending by state, county, or congressional district. Useful for per-capita analysis, regional comparisons, and mapping federal investment patterns. Geographic filters accept FIPS codes and 2-letter state abbreviations — NOT place names. Resolve place names to FIPS codes using a geocoding server (Census or OpenStreetMap) before applying location filters. Chain per-capita results with Census population data for meaningful comparisons.

mcp-tool

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "scope",
    "geo_layer"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 500,
      "minimum": 1,
      "description": "Maximum geographic areas to return, ranked by aggregated_amount descending (1–500). The upstream endpoint is not paginated — it returns every matching area in one response — so this caps client-side. A nationwide county query matches over 3,000 areas."
    },
    "scope": {
      "enum": [
        "place_of_performance",
        "recipient_location"
      ],
      "type": "string",
      "description": "Which location to aggregate by: place_of_performance (where work is done) or recipient_location (where the recipient is based)"
    },
    "filters": {
      "type": "object",
      "properties": {
        "keywords": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Full-text keyword filter (e.g., [\"cybersecurity\", \"cloud\"])"
        },
        "agency_name": {
          "type": "string",
          "description": "Awarding agency name filter"
        },
        "naics_codes": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "NAICS industry codes to include"
        },
        "recipient_id": {
          "type": "string",
          "description": "Exact recipient hash ID to filter awards"
        },
        "time_period_end": {
          "type": "string",
          "description": "End of time period in ISO 8601 format (YYYY-MM-DD)"
        },
        "award_type_codes": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Award type codes: A/B/C/D (contracts), IDV_A–IDV_E (IDVs), 02–05 (grants), 06/10 (direct payments), 07/08 (loans), 09/11 (insurance and other assistance), -1 (unspecified). Groups may be mixed here. Omit to aggregate every type."
        },
        "time_period_start": {
          "type": "string",
          "description": "Start of time period in ISO 8601 format (YYYY-MM-DD)"
        }
      },
      "description": "Optional filters to scope the spending aggregation"
    },
    "geo_layer": {
      "enum": [
        "state",
        "county",
        "district"
      ],
      "type": "string",
      "description": "Geographic granularity: state (50 states), county (county-level), or district (congressional district)"
    },
    "subawards": {
      "type": "boolean",
      "default": false,
      "description": "Include subaward data instead of prime award data"
    }
  },
  "additionalProperties": false
}

arguments 83 lines

usaspending_list_agencies unknown never probed

List all top-tier federal agencies with toptier codes, agency slugs, budget authority amounts, and obligation totals for the current fiscal year. Use this as the entry point for agency navigation — toptier codes and agency slugs are required inputs for usaspending_get_agency and agency-based filters on spending analysis tools.

mcp-tool

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "sort": {
      "enum": [
        "agency_name",
        "budget_authority_amount",
        "obligated_amount",
        "outlay_amount"
      ],
      "type": "string",
      "default": "agency_name",
      "description": "Sort field: agency_name (alphabetical), budget_authority_amount, obligated_amount, or outlay_amount"
    },
    "order": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "asc",
      "description": "Sort direction: asc or desc"
    }
  },
  "additionalProperties": false
}

arguments 27 lines

usaspending_autocomplete_filters unknown never probed

Look up valid code values for filter fields by searching free-text descriptions. Use the type parameter to select the lookup table: naics (NAICS industry codes), psc (product/service codes), cfda (CFDA/Assistance Listing program numbers), awarding_agency (agency names and IDs), or recipient (recipient names with UEI/DUNS). Call this before filtering awards when you know a description but not the exact code. Returns matching codes and names for use in other tool filters.

mcp-tool

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "type",
    "search_text"
  ],
  "properties": {
    "type": {
      "enum": [
        "naics",
        "psc",
        "cfda",
        "awarding_agency",
        "recipient"
      ],
      "type": "string",
      "description": "Lookup table to search: naics (industry codes), psc (product/service codes), cfda (assistance programs), awarding_agency (agency names), recipient (recipient names)"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 500,
      "minimum": 1,
      "description": "Maximum number of results to return (1–500), enforced client-side. The recipient lookup unions three upstream match buckets (name, UEI, DUNS) and can return up to 3x this value, so its results are capped to this limit before returning — the cap keeps them in bucket order, so name matches fill the page first and identifier matches appear only in whatever room is left. To resolve a specific UEI or DUNS, pass the identifier itself as search_text. naics/psc/cfda/awarding_agency honor this limit exactly."
    },
    "search_text": {
      "type": "string",
      "minLength": 1,
      "description": "Free-text search string — use a description, keyword, or partial code to find matches"
    }
  },
  "additionalProperties": false
}

arguments 34 lines

usaspending_search_awards unknown never probed

Search federal awards by keyword, recipient, agency, award type, NAICS code, location, or date range. Returns ranked award summaries including recipient names, amounts, awarding agencies, and generated award IDs for use with usaspending_get_award. Award types: A/B/C/D = contracts, 02/03/04/05 = grants, 06/10 = direct payments, 07/08 = loans, IDV_A/IDV_B/IDV_C/IDV_D/IDV_E = IDVs. Dates must be ISO 8601 (YYYY-MM-DD). Earliest data: 2007-10-01 via search API. DoD contracts have a 90-day publication lag.

mcp-tool

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number (1-based). Page-number pagination caps at a 50,000-result offset (page × limit), but the keyset cursor below is only returned while the offset stays under 10,000 — capture the cursor pair before paging past that, or the only way forward is page numbers."
    },
    "sort": {
      "enum": [
        "Award Amount",
        "Total Outlays",
        "Start Date",
        "End Date",
        "Recipient Name",
        "Awarding Agency"
      ],
      "type": "string",
      "default": "Award Amount",
      "description": "Sort field for results"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum results per page (1–100)"
    },
    "order": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "desc",
      "description": "Sort direction"
    },
    "filters": {
      "type": "object",
      "properties": {
        "keywords": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Full-text search terms across award descriptions, recipient names, and places"
        },
        "agency_name": {
          "type": "string",
          "description": "Awarding agency name (toptier), e.g., \"Department of Defense\""
        },
        "naics_codes": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "NAICS industry codes to require, e.g., [\"541512\"]"
        },
        "recipient_name": {
          "type": "string",
          "description": "Recipient name search (partial match); maps to recipient_search_text. Use instead of recipient_id, which this endpoint ignores."
        },
        "time_period_end": {
          "type": "string",
          "description": "End date (YYYY-MM-DD). Requires time_period_start."
        },
        "award_type_codes": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Award type codes; all must belong to one group (A/B/C/D, 02/03/04/05, 06/10, 07/08, IDV_A–IDV_E)"
        },
        "time_period_start": {
          "type": "string",
          "description": "Start date (YYYY-MM-DD); earliest valid 2007-10-01. Requires time_period_end."
        }
      },
      "description": "Optional analytics-style filter object mirroring the shape the spending analytics tools accept, for reusing one filter set across tools. When both this object and the equivalent top-level flat filters are given, this object wins per-field. recipient_id is intentionally not accepted — this endpoint silently ignores it; filter by recipient via recipient_name."
    },
    "keyword": {
      "type": "string",
      "description": "Full-text search across award descriptions, recipient names, and place names"
    },
    "agency_name": {
      "type": "string",
      "description": "Filter to a specific awarding agency by name (e.g., \"Department of Defense\"). Use usaspending_autocomplete_filters type=awarding_agency to find exact names."
    },
    "naics_codes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by NAICS industry codes (e.g., [\"541512\"]). Use usaspending_autocomplete_filters type=naics to look up codes."
    },
    "time_period": {
      "type": "object",
      "required": [
        "start_date",
        "end_date"
      ],
      "properties": {
        "end_date": {
          "type": "string",
          "description": "End date in ISO 8601 format (YYYY-MM-DD)"
        },
        "start_date": {
          "type": "string",
          "description": "Start date in ISO 8601 format (YYYY-MM-DD); earliest valid: 2007-10-01"
        }
      },
      "description": "Filter awards by date range (action date)"
    },
    "recipient_name": {
      "type": "string",
      "description": "Filter by recipient name (partial match); maps to this endpoint's recipient_search_text. This endpoint has no recipient_id filter — use usaspending_search_recipients to look up a recipient by name."
    },
    "location_filter": {
      "type": "object",
      "properties": {
        "city": {
          "type": "string",
          "description": "City name"
        },
        "state": {
          "type": "string",
          "description": "Two-letter US state abbreviation (e.g., CA)"
        },
        "county": {
          "type": "string",
          "description": "FIPS county code (e.g., 06037 for Los Angeles County)"
        },
        "country": {
          "type": "string",
          "description": "ISO 3166-1 alpha-3 country code (e.g., USA)"
        }
      },
      "description": "Filter by place of performance location. Uses FIPS codes and 2-letter state abbreviations, not place names — use a geocoding server to resolve names to codes first."
    },
    "award_type_codes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "default": [
        "A",
        "B",
        "C",
        "D"
      ],
      "description": "Filter by award type codes. All codes must belong to a single group: A/B/C/D (contracts), 02/03/04/05 (grants), 06/10 (direct payments), 07/08 (loans), IDV_A–IDV_E (IDVs). Defaults to contracts. Mixing groups across categories causes a 422 error."
    },
    "last_record_unique_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Keyset-pagination cursor: the last_record_unique_id from a prior response page_metadata. Provide together with last_record_sort_value."
    },
    "last_record_sort_value": {
      "type": "string",
      "description": "Keyset-pagination cursor: the last_record_sort_value from a prior response page_metadata. Provide together with last_record_unique_id to fetch the next page past the 50,000-result page-number cap. The upstream stops emitting the pair once page × limit reaches 10,000, so take it from a page below that offset. When both cursor fields are supplied, page is ignored."
    }
  },
  "additionalProperties": false
}

arguments 168 lines

usaspending_get_award unknown never probed
Fetch full details of a federal award by its generated unique award ID. Returns contract or assistance award data including recipient info, agency hierarchy, period of performance, place of performance, funding account linkages (account_obligations_by_defc), parent IDV information, and subaward count. Use generated_internal_id values from usaspending_search_awards as input. Recipient hashes can be passed to usaspending_get_recipient; NAICS codes can be used in usaspending_search_awards filters. For IDV-category awards (category="idv"), use usaspending_get_idv_awards to list the child contracts and task/delivery orders placed under them.

mcp-tool
{ "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "award_id" ], "properties": { "award_id": { "type": "string", "minLength": 1, "description": "Generated unique award ID (e.g., CONT_AWD_FA862118F6251_9700_FA862115D6276_9700) — use generated_internal_id from usaspending_search_awards" } }, "additionalProperties": false }
arguments 15 lines

usaspending_get_award_transactions unknown never probed

List individual transactions (contract modifications, grant amendments) on a federal award. Each transaction represents a change event — obligation modifications, performance period extensions, scope changes, etc. Use this to trace the spending history and obligation changes over the life of an award. Award IDs come from usaspending_search_awards (generated_internal_id field).

mcp-tool

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "award_id"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number (1-based)"
    },
    "sort": {
      "enum": [
        "action_date",
        "federal_action_obligation",
        "modification_number"
      ],
      "type": "string",
      "default": "action_date",
      "description": "Sort field for transactions"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum transactions per page (1–100)"
    },
    "order": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "desc",
      "description": "Sort direction"
    },
    "award_id": {
      "type": "string",
      "minLength": 1,
      "description": "Generated unique award ID (generated_internal_id from usaspending_search_awards)"
    }
  },
  "additionalProperties": false
}

arguments 48 lines

usaspending_get_award_subawards unknown never probed

List subaward contracts or grants under a prime federal award. Reveals the sub-contractor or sub-grantee layer — the organizations that actually perform the work. Each row shows the subaward number, amount, description, action date, and recipient. Check subaward_count on usaspending_get_award first to confirm subawards exist before calling this tool.

mcp-tool

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "award_id"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number (1-based)"
    },
    "sort": {
      "enum": [
        "subaward_number",
        "description",
        "action_date",
        "amount",
        "recipient_name"
      ],
      "type": "string",
      "default": "action_date",
      "description": "Sort field for subawards"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum subawards per page (1–100)"
    },
    "order": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "desc",
      "description": "Sort direction"
    },
    "award_id": {
      "type": "string",
      "minLength": 1,
      "description": "Generated unique award ID (generated_internal_id from usaspending_search_awards)"
    }
  },
  "additionalProperties": false
}

arguments 50 lines

usaspending_get_award_federal_accounts unknown never probed
List the Treasury federal accounts that funded an award, with the amount obligated from each and the funding agency behind it. This is the award → appropriation link: each row returns federal_account (AGENCY-MAIN format, e.g. 080-0120) to chain into usaspending_get_federal_account for the account budget detail. The award_id must be a generated_unique_award_id — from usaspending_search_awards (generated_internal_id field) or usaspending_get_award. Distinct from usaspending_get_award account_obligations_by_defc, which breaks funding down by Disaster/Emergency Funding code rather than by account. An award_id that does not exist returns an empty list rather than an error.

mcp-tool
{ "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "award_id" ], "properties": { "page": { "type": "integer", "default": 1, "maximum": 9007199254740991, "minimum": 1, "description": "Page number (1-based)" }, "limit": { "type": "integer", "default": 10, "maximum": 100, "minimum": 1, "description": "Maximum results per page (1–100)" }, "award_id": { "type": "string", "minLength": 1, "description": "Award generated_unique_award_id (e.g., CONT_AWD_GSFC0198106DNAS526555_8000_-NONE-_-NONE-) — use generated_internal_id from usaspending_search_awards or generated_unique_award_id from usaspending_get_award" } }, "additionalProperties": false }
arguments 29 lines

usaspending_get_idv_awards unknown never probed

List child contracts and task/delivery orders placed under an IDV (Indefinite Delivery Vehicle) award. Each row includes the generated_unique_award_id to chain into usaspending_get_award for full detail. The award_id must be the generated_unique_award_id of the parent IDV — obtainable from usaspending_search_awards (generated_internal_id field) or from usaspending_get_award. IDV category awards returned by usaspending_get_award have child orders accessible via this tool.

mcp-tool

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "award_id"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number (1-based)"
    },
    "sort": {
      "type": "string",
      "default": "obligated_amount",
      "description": "Field to sort child awards by (e.g., obligated_amount, period_of_performance_start_date)"
    },
    "type": {
      "enum": [
        "child_awards",
        "child_idvs",
        "grandchild_awards"
      ],
      "type": "string",
      "default": "child_awards",
      "description": "Type of child awards to list: child_awards = task/delivery orders, child_idvs = sub-IDVs, grandchild_awards = orders under sub-IDVs"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum results per page (1–100)"
    },
    "order": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "desc",
      "description": "Sort direction"
    },
    "award_id": {
      "type": "string",
      "minLength": 1,
      "description": "Parent IDV generated_unique_award_id (e.g., CONT_IDV_NNK14MA74C_8000) — use generated_internal_id from usaspending_search_awards or generated_unique_award_id from usaspending_get_award"
    }
  },
  "additionalProperties": false
}

arguments 53 lines

usaspending_search_recipients unknown never probed

Search for organizations or individuals receiving federal funds by name, UEI (Unique Entity Identifier), or DUNS. Returns recipient hash IDs, UEI/DUNS identifiers, total award amounts, and hierarchy level. Results are paginated — use page to retrieve matches beyond the first page; page_metadata.total reports the full match count. Recipient hash IDs from this tool can be passed to usaspending_get_recipient for full profiles. Recipient level: P = parent organization, C = child entity, R = standalone.

mcp-tool

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "keyword"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number (1-based) — request the next page to retrieve matches beyond the first"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum results per page (1–100)"
    },
    "keyword": {
      "type": "string",
      "minLength": 1,
      "description": "Name, UEI, DUNS, or keyword to search for — partial matches are supported"
    },
    "award_type": {
      "enum": [
        "contracts",
        "grants",
        "direct_payments",
        "loans",
        "other_financial_assistance"
      ],
      "type": "string",
      "description": "Filter by award type category to scope the total amounts returned"
    }
  },
  "additionalProperties": false
}

arguments 40 lines

usaspending_get_recipient unknown never probed

Fetch a recipient's full profile including address, business type codes, parent organization, alternate names, and total transaction and loan amounts. Recipient IDs are UUID hashes with a level suffix (-P parent, -C child, -R standalone) from usaspending_search_recipients or usaspending_get_award. Optionally scope the totals to a specific fiscal year and award type. UEI and DUNS values can be used to cross-reference with SAM.gov and SEC EDGAR.

mcp-tool

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "recipient_id"
  ],
  "properties": {
    "award_type": {
      "enum": [
        "contracts",
        "grants",
        "direct_payments",
        "loans",
        "other_financial_assistance"
      ],
      "type": "string",
      "description": "Award type category to scope award totals"
    },
    "fiscal_year": {
      "type": "integer",
      "maximum": 2030,
      "minimum": 2001,
      "description": "Fiscal year to scope award totals (e.g., 2024)"
    },
    "recipient_id": {
      "type": "string",
      "minLength": 1,
      "description": "Recipient hash ID (UUID with level suffix, e.g., b97d19b0-833c-8d8f-3a2c-157d04ea55ef-P) — from usaspending_search_recipients or usaspending_get_award"
    }
  },
  "additionalProperties": false
}

arguments 32 lines

usaspending_spending_by_category unknown never probed

Aggregate federal spending grouped by a specific dimension: NAICS industry code, PSC product/service code, awarding agency, funding agency, CFDA assistance program, or recipient. Returns top items with obligation amounts — useful for trend and breakdown analysis. Chain NAICS codes into usaspending_search_awards filters or usaspending_autocomplete_filters lookups.

mcp-tool

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "category"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number (1-based)"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum items to return (1–100)"
    },
    "filters": {
      "type": "object",
      "properties": {
        "keywords": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Full-text keyword filters"
        },
        "agency_name": {
          "type": "string",
          "description": "Awarding agency name filter"
        },
        "naics_codes": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "NAICS code filters"
        },
        "recipient_id": {
          "type": "string",
          "description": "Exact recipient hash ID filter"
        },
        "time_period_end": {
          "type": "string",
          "description": "End date (YYYY-MM-DD)"
        },
        "award_type_codes": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Award type code filters (A/B/C/D, 02–05, etc.)"
        },
        "time_period_start": {
          "type": "string",
          "description": "Start date (YYYY-MM-DD)"
        }
      },
      "description": "Optional filters to scope the aggregation"
    },
    "category": {
      "enum": [
        "naics",
        "psc",
        "awarding_agency",
        "awarding_subagency",
        "funding_agency",
        "funding_subagency",
        "cfda",
        "recipient_duns",
        "recipient_parent_duns"
      ],
      "type": "string",
      "description": "Breakdown dimension: naics (industry), psc (product/service code), awarding_agency, awarding_subagency, funding_agency, funding_subagency, cfda (assistance programs), recipient_duns, or recipient_parent_duns"
    }
  },
  "additionalProperties": false
}

arguments 82 lines

usaspending_spending_over_time unknown never probed

Fetch aggregated federal obligation amounts grouped by fiscal year, fiscal quarter, or fiscal month. All grouping is relative to the US government fiscal year (Oct–Sep), so fiscal month 1 is October, not January. Filter by award type, agency, recipient, keyword, or NAICS code to trace spending trends in a specific area. Returns per-period totals and optional breakdowns by award category (contracts, grants, direct payments, IDVs, loans, other).

mcp-tool

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "group"
  ],
  "properties": {
    "group": {
      "enum": [
        "fiscal_year",
        "quarter",
        "month"
      ],
      "type": "string",
      "description": "Time grouping: fiscal_year (annual US govt FY: Oct–Sep), quarter (fiscal quarter), or month (fiscal month — an ordinal within the fiscal year, where 1 = October)"
    },
    "filters": {
      "type": "object",
      "properties": {
        "keywords": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Full-text keyword filters"
        },
        "agency_name": {
          "type": "string",
          "description": "Awarding agency name filter"
        },
        "naics_codes": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "NAICS code filters"
        },
        "recipient_id": {
          "type": "string",
          "description": "Exact recipient hash ID filter"
        },
        "time_period_end": {
          "type": "string",
          "description": "End of the time window (YYYY-MM-DD)"
        },
        "award_type_codes": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Award type code filters (A/B/C/D, 02–05, etc.). All codes must belong to a single group. When omitted, defaults to contracts (A, B, C, D)."
        },
        "time_period_start": {
          "type": "string",
          "description": "Start of the time window (YYYY-MM-DD)"
        }
      },
      "description": "Filters to scope the time-series aggregation. Defaults to contract awards when omitted."
    },
    "subawards": {
      "type": "boolean",
      "default": false,
      "description": "Aggregate subaward data instead of prime award data"
    }
  },
  "additionalProperties": false
}

arguments 67 lines

usaspending_disaster_spending unknown never probed

Fetch disaster and emergency supplemental spending (COVID-19, hurricanes, infrastructure law, etc.) broken down by agency, CFDA assistance program, recipient, or geography. Use the dimension parameter to select the breakdown axis: overview (top-level totals), agency, cfda, recipient, or geography. Filter by DEF codes (Disaster/Emergency Funding codes) to isolate a specific emergency appropriation. DEF codes appear in usaspending_get_award account_obligations_by_defc and usaspending_get_agency def_codes fields.

mcp-tool

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dimension"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number (1-based)"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum results per page (1–100). Applies to the agency, cfda, and recipient dimensions; ignored for overview and geography, which are not paginated."
    },
    "filters": {
      "type": "object",
      "properties": {
        "def_codes": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "DEF codes to filter by (e.g., [\"L\", \"M\", \"N\", \"O\", \"P\"] for COVID-19). Required for all dimensions except overview — the upstream API returns HTTP 422 when omitted for agency, cfda, recipient, and geography breakdowns. DEF codes appear in usaspending_get_agency def_codes fields."
        },
        "geo_layer": {
          "enum": [
            "state",
            "county"
          ],
          "type": "string",
          "description": "Geographic layer for geography dimension (state or county)"
        },
        "award_type_codes": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Award type code filters"
        }
      },
      "description": "Filters — def_codes is required for all non-overview dimensions (agency, cfda, recipient, geography)"
    },
    "dimension": {
      "enum": [
        "overview",
        "agency",
        "cfda",
        "recipient",
        "geography"
      ],
      "type": "string",
      "description": "Breakdown axis: overview (top-level totals and DEF code funding), agency (by awarding agency), cfda (by assistance program), recipient (by recipient), geography (by state/county)"
    },
    "spending_type": {
      "enum": [
        "award",
        "total"
      ],
      "type": "string",
      "default": "award",
      "description": "Data type for the agency and recipient dimensions: award (award-level obligations and outlays) or total (includes direct non-award spending). Ignored for cfda and overview; the geography dimension is not user-controllable and always reports obligation-based amounts."
    }
  },
  "additionalProperties": false
}

arguments 72 lines

usaspending_get_federal_account unknown never probed
Fetch a federal account's budget data: total obligations, gross outlays, and budgetary resources, plus the per-Treasury-Account-Symbol (TAS) component breakdown in children. Federal accounts connect appropriations law to actual agency spending. Account codes come from usaspending_search_federal_accounts (its account_number output field) or usaspending_get_award_federal_accounts (its federal_account field), and are formatted as AGENCY-MAIN (e.g., 097-0100 for DoD Operation and Maintenance). For obligations broken down by program activity or object class, use usaspending_get_federal_account_breakdown.

mcp-tool
{ "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "account_code" ], "properties": { "account_code": { "type": "string", "minLength": 1, "description": "Federal account code in AGENCY-MAIN format (e.g., 097-0100). Returned as account_number by usaspending_search_federal_accounts and as federal_account by usaspending_get_award_federal_accounts." } }, "additionalProperties": false }
arguments 15 lines

usaspending_get_federal_account_breakdown unknown never probed

Fetch a federal account's obligations broken down by program activity (what the money funds) or object class (what it buys — personnel, supplies, contracts). Use the dimension parameter to select the axis. Account codes are AGENCY-MAIN format and come from usaspending_search_federal_accounts (its account_number output field), usaspending_get_award_federal_accounts (its federal_account field), or usaspending_get_federal_account. Paginated with an honest total count. For the account's own metadata and top-level totals, use usaspending_get_federal_account.

mcp-tool

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "account_code",
    "dimension"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number (1-based)"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum results per page (1–100)"
    },
    "dimension": {
      "enum": [
        "program_activity",
        "object_class"
      ],
      "type": "string",
      "description": "Breakdown axis: program_activity (obligations by the program the funds support) or object_class (obligations by the category of goods/services purchased)"
    },
    "account_code": {
      "type": "string",
      "minLength": 1,
      "description": "Federal account code in AGENCY-MAIN format (e.g., 097-0100). Returned as account_number by usaspending_search_federal_accounts and as federal_account by usaspending_get_award_federal_accounts."
    }
  },
  "additionalProperties": false
}

arguments 38 lines

usaspending_search_federal_accounts unknown never probed

List and keyword-search federal accounts by agency identifier or title keyword. Returns account numbers, names, managing agencies, and budgetary resources. Use account_number from results as input to usaspending_get_federal_account for full budget detail. Use usaspending_list_agencies to look up agency_identifier codes (3-digit strings, e.g. "097" for DoD).

mcp-tool

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number (1-based)"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum results per page (1–100)"
    },
    "keyword": {
      "type": "string",
      "description": "Filter accounts by name or title keyword (e.g., \"defense\", \"transportation\")"
    },
    "sort_field": {
      "enum": [
        "account_name",
        "account_number",
        "budgetary_resources",
        "managing_agency"
      ],
      "type": "string",
      "default": "budgetary_resources",
      "description": "Field to sort results by"
    },
    "sort_direction": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "desc",
      "description": "Sort direction"
    },
    "agency_identifier": {
      "type": "string",
      "description": "3-digit agency identifier code (e.g., \"097\" for Department of Defense). Use usaspending_list_agencies to look up codes."
    }
  },
  "additionalProperties": false
}

arguments 49 lines

_ try it through the hub, ceiling 0

This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.

_ how we know

card completeness

100%

An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.

spec deviations

MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.

_ record

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

proxied calls

total: 0
ok: 0
failed: 0
success rate: —
median latency: —

work

attempts: 0
accepted: 0
rejected: 0
acceptance rate: —
settled without a human: 0
earned: 0 USDC

disputes

raised against: 0
upheld: 0
rate: —

reviews

paid reviews: 0
positive: 0
negative: 0
score: —

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.