SpendQuery is an MCP server published by com.spendquery, hosted at api.spendquery.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 26 tools, including get_catalog, run_plan, search_codes, search_recipients, browse_codes.
US federal spending, contracts, SAM.gov notices, FAR clauses and SBIR awards, in plain English.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
What SpendQuery can answer: data coverage, metrics, dimensions (with examples and whether they apply to contracts or assistance), analyses, the QueryPlan JSON schema, planning rules and example question -> plan pairs. Call this first (no arguments): the federal catalog. section: "states" (state, county and city checkbooks in brief: each jurisdiction, their dimensions, rules and examples), "state:<CODE>" (one jurisdiction in full, e.g. "state:MA"), "rules" (every planning rule), "examples" (every worked example) or "full" (everything).
| Parameter | Type | Description |
|---|---|---|
| section | any | Omit for the federal catalog. "states" (state, county and city checkbooks in brief), "state:<CODE>" for one jurisdiction in full (e.g. "state:MA"), "rules", "examples" or "full". |
None yet. Changes appear after a server's second daily check.
{
"name": "get_catalog",
"title": "What SpendQuery can answer",
"description": "What SpendQuery can answer: data coverage, metrics, dimensions (with examples and whether\n they apply to contracts or assistance), analyses, the QueryPlan JSON schema, planning rules\n and example question -> plan pairs. Call this first (no arguments): the federal catalog.\n section: \"states\" (state, county and city checkbooks in brief: each jurisdiction, their\n dimensions, rules and examples), \"state:<CODE>\" (one jurisdiction in full, e.g. \"state:MA\"),\n \"rules\" (every planning rule), \"examples\" (every worked example) or \"full\" (everything).",
"inputSchema": {
"type": "object",
"title": "get_catalogArguments",
"properties": {
"section": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Section",
"default": null,
"description": "Omit for the federal catalog. \"states\" (state, county and city checkbooks in brief), \"state:<CODE>\" for one jurisdiction in full (e.g. \"state:MA\"), \"rules\", \"examples\" or \"full\"."
}
}
},
"outputSchema": {
"type": "object",
"title": "get_catalogDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "What SpendQuery can answer",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Run a QueryPlan (see get_catalog.plan_schema). Returns status (ok | clarify | unsupported | error), a one-paragraph answer, columns, rows (max 100), the SQL that ran, caveats, how names were resolved to codes, and `page`: the same answer on spendquery.com, run live, to cite or open.
| Parameter | Type | Description |
|---|---|---|
| plan * | object | A QueryPlan object in business terms, following get_catalog's plan_schema, e.g. {"intent": "aggregate", "metric": "obligations", "group_by": ["agency"], "fiscal_years": [2025], "award_category": "contract"} (award_category is a field of its own, not a filter). |
{
"name": "run_plan",
"title": "Run a spending query",
"description": "Run a QueryPlan (see get_catalog.plan_schema). Returns status (ok | clarify |\n unsupported | error), a one-paragraph answer, columns, rows (max 100), the SQL that ran,\n caveats, how names were resolved to codes, and `page`: the same answer on spendquery.com,\n run live, to cite or open.",
"inputSchema": {
"type": "object",
"title": "run_planArguments",
"required": [
"plan"
],
"properties": {
"plan": {
"type": "object",
"title": "Plan",
"description": "A QueryPlan object in business terms, following get_catalog's plan_schema, e.g. {\"intent\": \"aggregate\", \"metric\": \"obligations\", \"group_by\": [\"agency\"], \"fiscal_years\": [2025], \"award_category\": \"contract\"} (award_category is a field of its own, not a filter).",
"additionalProperties": true
}
}
},
"outputSchema": {
"type": "object",
"title": "run_planDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Run a spending query",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Look up codes and official names. kind: agency | bureau | state | county | naics | psc | program. Matches names (substring, case-insensitive) or code prefixes. Plans can use either the names or the codes.
| Parameter | Type | Description |
|---|---|---|
| kind * | string | What to look up: agency, bureau (sub-agency), state, county, naics (industry), psc (product or service code) or program (Assistance Listing). |
| limit | integer | Most rows to return, 1-50. |
| query * | string | Words in the name, or the code itself, e.g. "veterans affairs", "541511", "D302". |
{
"name": "search_codes",
"title": "Search agencies, industries and product codes",
"description": "Look up codes and official names. kind: agency | bureau | state | county | naics | psc |\n program. Matches names (substring, case-insensitive) or code prefixes. Plans can use either\n the names or the codes.",
"inputSchema": {
"type": "object",
"title": "search_codesArguments",
"required": [
"kind",
"query"
],
"properties": {
"kind": {
"enum": [
"agency",
"bureau",
"state",
"county",
"naics",
"psc",
"program"
],
"type": "string",
"title": "Kind",
"description": "What to look up: agency, bureau (sub-agency), state, county, naics (industry), psc (product or service code) or program (Assistance Listing)."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20,
"description": "Most rows to return, 1-50."
},
"query": {
"type": "string",
"title": "Query",
"description": "Words in the name, or the code itself, e.g. \"veterans affairs\", \"541511\", \"D302\"."
}
}
},
"outputSchema": {
"type": "object",
"title": "search_codesDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Search agencies, industries and product codes",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Find award recipients (companies, universities, governments) by name or UEI. Returns each registration's UEI, parent, listed-company ticker (if matched) and its OWN obligations across loaded years, largest first. A parent's money sits on its units, so a parent UEI's own obligations can be small or negative: for a company's total use run_plan with a company filter (name or ticker). A UEI that is a parent also returns parent_rollup (its units).
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Most rows to return, 1-50. |
| query * | string | A company or recipient name, or a 12-character UEI, e.g. "booz allen" or "ZFN2JJXBLZT3". |
{
"name": "search_recipients",
"title": "Search companies and recipients",
"description": "Find award recipients (companies, universities, governments) by name or UEI. Returns\n each registration's UEI, parent, listed-company ticker (if matched) and its OWN obligations\n across loaded years, largest first. A parent's money sits on its units, so a parent UEI's own\n obligations can be small or negative: for a company's total use run_plan with a company\n filter (name or ticker). A UEI that is a parent also returns parent_rollup (its units).",
"inputSchema": {
"type": "object",
"title": "search_recipientsArguments",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 10,
"description": "Most rows to return, 1-50."
},
"query": {
"type": "string",
"title": "Query",
"description": "A company or recipient name, or a 12-character UEI, e.g. \"booz allen\" or \"ZFN2JJXBLZT3\"."
}
}
},
"outputSchema": {
"type": "object",
"title": "search_recipientsDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Search companies and recipients",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Browse what the government buys, with contract spend. kind: psc (products and services) | naics (industries). No group and no query -> the groups (PSC: services by letter, e.g. D = IT services, R = professional support; products by 2 digits, e.g. 84 = clothing and individual equipment; NAICS: 2-digit sectors), largest first. group -> the codes in it. query -> codes whose name contains the words. Default year: last complete fiscal year. Use a code or its name in a plan's psc / naics filter.
| Parameter | Type | Description |
|---|---|---|
| kind | string | psc (products and services) or naics (industries). |
| group | any | A group to list the codes in: a PSC letter or 2-character group (e.g. "D", "84") or a 2-digit NAICS sector (e.g. "54"). |
| limit | integer | Most rows to return, 1-200. |
| query | any | Words in a code's name, e.g. "body armor", "janitorial". |
| fiscal_year | any | Federal fiscal year (October-September), e.g. 2025; default the last complete one. |
{
"name": "browse_codes",
"title": "Browse industry and product codes",
"description": "Browse what the government buys, with contract spend. kind: psc (products and services)\n | naics (industries). No group and no query -> the groups (PSC: services by letter, e.g. D =\n IT services, R = professional support; products by 2 digits, e.g. 84 = clothing and\n individual equipment; NAICS: 2-digit sectors), largest first. group -> the codes in it.\n query -> codes whose name contains the words. Default year: last complete fiscal year.\n Use a code or its name in a plan's psc / naics filter.",
"inputSchema": {
"type": "object",
"title": "browse_codesArguments",
"properties": {
"kind": {
"enum": [
"psc",
"naics"
],
"type": "string",
"title": "Kind",
"default": "psc",
"description": "psc (products and services) or naics (industries)."
},
"group": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Group",
"default": null,
"description": "A group to list the codes in: a PSC letter or 2-character group (e.g. \"D\", \"84\") or a 2-digit NAICS sector (e.g. \"54\")."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 50,
"description": "Most rows to return, 1-200."
},
"query": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Query",
"default": null,
"description": "Words in a code's name, e.g. \"body armor\", \"janitorial\"."
},
"fiscal_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Fiscal Year",
"default": null,
"description": "Federal fiscal year (October-September), e.g. 2025; default the last complete one."
}
}
},
"outputSchema": {
"type": "object",
"title": "browse_codesDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Browse industry and product codes",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}One SAM.gov contract notice as SpendQuery's brief sees it, no AI: the decision card (what the buyer needs, blockers, unknowns, a next step; each line labelled record / files / unknown), the timeline of the buy (planned buy, the contract it follows, earlier and newer notices, the award and the contract it became, each link confirmed / likely / possible) and what changed between versions of its public files. notice_id: from run_plan lists of contract_opportunities, or the id in a SAM.gov notice URL.
| Parameter | Type | Description |
|---|---|---|
| notice_id * | string | A SAM.gov notice id: the 32-character hex id in a SAM.gov notice URL (sam.gov/opp/<id>/view) or from run_plan's contract_opportunities rows, e.g. "0a1b2c3d4e5f60718293a4b5c6d7e8f9". |
{
"name": "get_notice",
"title": "Look up a contract notice",
"description": "One SAM.gov contract notice as SpendQuery's brief sees it, no AI: the decision card (what\n the buyer needs, blockers, unknowns, a next step; each line labelled record / files /\n unknown), the timeline of the buy (planned buy, the contract it follows, earlier and newer\n notices, the award and the contract it became, each link confirmed / likely / possible) and\n what changed between versions of its public files. notice_id: from run_plan lists of\n contract_opportunities, or the id in a SAM.gov notice URL.",
"inputSchema": {
"type": "object",
"title": "get_noticeArguments",
"required": [
"notice_id"
],
"properties": {
"notice_id": {
"type": "string",
"title": "Notice Id",
"description": "A SAM.gov notice id: the 32-character hex id in a SAM.gov notice URL (sam.gov/opp/<id>/view) or from run_plan's contract_opportunities rows, e.g. \"0a1b2c3d4e5f60718293a4b5c6d7e8f9\"."
}
}
},
"outputSchema": {
"type": "object",
"title": "get_noticeDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Look up a contract notice",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}SBA small business size standards (13 CFR 121.201, the eCFR table): a NAICS code, a code prefix (5415) or industry words -> receipts ($ millions) or employees, exceptions and footnotes, and the programs that use them. Each row also carries `proposed`: the standard SBA proposed on August 20, 2026 (91 FR 53741) for the code's 4- or 5-digit group, and whether it is higher, the same, or measured another way. The proposal is NOT in force: say so, and answer "am I small?" from today's standard. With `receipts` and/or `employees`, `simulation` says for each code whether a firm of that size is small today and would be under the proposal (newly_small, stays_small, stays_large).
| Parameter | Type | Description |
|---|---|---|
| query * | string | A 6-digit NAICS code (e.g. "541511"), a code prefix (e.g. "5415") or industry words (e.g. "custom software"). |
| receipts | any | The firm's average annual receipts in dollars (last 5 fiscal years), to test it against today's and the proposed standard, e.g. 40000000. |
| employees | any | The firm's average number of employees (last 24 months), for the same test, e.g. 180. |
{
"name": "size_standard",
"title": "Check an SBA size standard",
"description": "SBA small business size standards (13 CFR 121.201, the eCFR table): a NAICS code, a code\n prefix (5415) or industry words -> receipts ($ millions) or employees, exceptions and\n footnotes, and the programs that use them. Each row also carries `proposed`: the standard\n SBA proposed on August 20, 2026 (91 FR 53741) for the code's 4- or 5-digit group, and whether\n it is higher, the same, or measured another way. The proposal is NOT in force: say so, and\n answer \"am I small?\" from today's standard. With `receipts` and/or `employees`, `simulation`\n says for each code whether a firm of that size is small today and would be under the proposal\n (newly_small, stays_small, stays_large).",
"inputSchema": {
"type": "object",
"title": "size_standardArguments",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"title": "Query",
"description": "A 6-digit NAICS code (e.g. \"541511\"), a code prefix (e.g. \"5415\") or industry words (e.g. \"custom software\")."
},
"receipts": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Receipts",
"default": null,
"description": "The firm's average annual receipts in dollars (last 5 fiscal years), to test it against today's and the proposed standard, e.g. 40000000."
},
"employees": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Employees",
"default": null,
"description": "The firm's average number of employees (last 24 months), for the same test, e.g. 180."
}
}
},
"outputSchema": {
"type": "object",
"title": "size_standardDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Check an SBA size standard",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Describe the work in plain words -> the NAICS codes buyers actually use for it (codes on SAM.gov notices whose titles have the words and on federal contracts described with them), each with its SBA size standard.
| Parameter | Type | Description |
|---|---|---|
| description * | string | The work in plain words, e.g. "commercial janitorial and floor care" or "drone mapping surveys". |
{
"name": "naics_finder",
"title": "Find NAICS codes for a business",
"description": "Describe the work in plain words -> the NAICS codes buyers actually use for it (codes on\n SAM.gov notices whose titles have the words and on federal contracts described with them),\n each with its SBA size standard.",
"inputSchema": {
"type": "object",
"title": "naics_finderArguments",
"required": [
"description"
],
"properties": {
"description": {
"type": "string",
"title": "Description",
"description": "The work in plain words, e.g. \"commercial janitorial and floor care\" or \"drone mapping surveys\"."
}
}
},
"outputSchema": {
"type": "object",
"title": "naics_finderDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Find NAICS codes for a business",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}For 6-digit NAICS codes (and an optional agency): the shared contract vehicles (GWACs, multiple-award IDIQs, GSA Schedule, BPAs) carrying last complete year's contract money in those codes, the share through each and who each is reserved for (read from its name).
| Parameter | Type | Description |
|---|---|---|
| naics * | array | One or more 6-digit NAICS codes, e.g. ["541511", "541512"]. |
| agency | any | An agency to limit to, by name or code, e.g. "Department of Veterans Affairs" or "036". |
{
"name": "vehicle_match",
"title": "Find contract vehicles for an industry",
"description": "For 6-digit NAICS codes (and an optional agency): the shared contract vehicles (GWACs,\n multiple-award IDIQs, GSA Schedule, BPAs) carrying last complete year's contract money in those\n codes, the share through each and who each is reserved for (read from its name).",
"inputSchema": {
"type": "object",
"title": "vehicle_matchArguments",
"required": [
"naics"
],
"properties": {
"naics": {
"type": "array",
"items": {
"type": "string"
},
"title": "Naics",
"description": "One or more 6-digit NAICS codes, e.g. [\"541511\", \"541512\"]."
},
"agency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Agency",
"default": null,
"description": "An agency to limit to, by name or code, e.g. \"Department of Veterans Affairs\" or \"036\"."
}
}
},
"outputSchema": {
"type": "object",
"title": "vehicle_matchDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Find contract vehicles for an industry",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Check the facts of a draft (a capture brief, a market report, an e-mail) against the records before it goes out. Send each fact as a claim; each comes back `matches`, `differs` (with what the record says), `not_found` or `not_checked`, and the page that shows it. A dollar figure matches when the record rounds to the words it was stated in ("$4.2 billion" covers 4.15 to 4.25). Nothing is judged by an AI here: every claim is a lookup. Use it after writing, on the figures, dates, names, certifications and quoted rules the draft relies on; fix or drop what differs, and say what could not be checked.
| Parameter | Type | Description |
|---|---|---|
| claims * | array | The facts to check, up to 25, each an object with `kind` and, optionally, `text` (the sentence it comes from). amount: {"kind": "amount", "plan": <QueryPlan>, "stated": "$4.2 billion"} (or "value": 4200000000; "row": "Leidos" picks a row of a ranking). notice: {"kind": "notice", "notice_id": "<id>",… |
{
"name": "check_claims",
"title": "Check facts in a draft against the records",
"description": "Check the facts of a draft (a capture brief, a market report, an e-mail) against the\n records before it goes out. Send each fact as a claim; each comes back `matches`, `differs`\n (with what the record says), `not_found` or `not_checked`, and the page that shows it. A\n dollar figure matches when the record rounds to the words it was stated in (\"$4.2 billion\"\n covers 4.15 to 4.25). Nothing is judged by an AI here: every claim is a lookup. Use it after\n writing, on the figures, dates, names, certifications and quoted rules the draft relies on;\n fix or drop what differs, and say what could not be checked.",
"inputSchema": {
"type": "object",
"title": "check_claimsArguments",
"required": [
"claims"
],
"properties": {
"claims": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"title": "Claims",
"description": "The facts to check, up to 25, each an object with `kind` and, optionally, `text` (the sentence it comes from). amount: {\"kind\": \"amount\", \"plan\": <QueryPlan>, \"stated\": \"$4.2 billion\"} (or \"value\": 4200000000; \"row\": \"Leidos\" picks a row of a ranking). notice: {\"kind\": \"notice\", \"notice_id\": \"<id>\", \"deadline\": \"2026-12-01\", \"set_aside\": \"SDVOSB\", \"naics\": \"541512\"}. contract: {\"kind\": \"contract\", \"award\": \"<award key or number>\", \"incumbent\": \"Leidos\", \"end_date\": \"2027-03-31\", \"stated\": \"$12.5M\"}. company: {\"kind\": \"company\", \"company\": \"<UEI or name>\", \"certification\": \"8(a)\", \"state\": \"VA\", \"registered\": true, \"excluded\": false}. far: {\"kind\": \"far\", \"section\": \"19.502-2\", \"quote\": \"<words quoted>\"}."
}
}
},
"outputSchema": {
"type": "object",
"title": "check_claimsDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Check facts in a draft against the records",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}New federal project grants and cooperative agreements to state and local governments (USAspending assistance awards), largest first: the government, the program, the purpose, the dollars obligated, and where that government posts its bids (its entry in SpendQuery's bid-portal directory: portal, open-bids list, vendor registration) when the name matches a listed state, county or city. Use it for "which cities near me just won federal money for X": the government usually buys the work itself, later, on its own portal. A grant is a sign, not a solicitation; say so, and send the user to the portal to look for the bid.
| Parameter | Type | Description |
|---|---|---|
| q | any | Words in the grant's purpose, program or recipient, e.g. "runway" or "water". |
| days | integer | Grants made in the last 30, 90, 180 or 365 days of loaded data (default 90). |
| level | enum | Only this kind of government. |
| limit | integer | How many grants to return, 1-50 (default 20). |
| state | any | A 2-letter state code, e.g. "KS". |
| min_amount | number | Smallest grant in dollars: 250000, 1000000 (default), 5000000 or 25000000. |
{
"name": "follow_the_grant",
"title": "Follow new federal grants to state and local governments",
"description": "New federal project grants and cooperative agreements to state and local governments\n (USAspending assistance awards), largest first: the government, the program, the purpose, the\n dollars obligated, and where that government posts its bids (its entry in SpendQuery's\n bid-portal directory: portal, open-bids list, vendor registration) when the name matches a\n listed state, county or city. Use it for \"which cities near me just won federal money for\n X\": the government usually buys the work itself, later, on its own portal. A grant is a\n sign, not a solicitation; say so, and send the user to the portal to look for the bid.",
"inputSchema": {
"type": "object",
"title": "follow_the_grantArguments",
"properties": {
"q": {
"anyOf": [
{
"type": "string",
"maxLength": 60
},
{
"type": "null"
}
],
"title": "Q",
"default": null,
"description": "Words in the grant's purpose, program or recipient, e.g. \"runway\" or \"water\"."
},
"days": {
"type": "integer",
"title": "Days",
"default": 90,
"description": "Grants made in the last 30, 90, 180 or 365 days of loaded data (default 90)."
},
"level": {
"enum": [
"state",
"county",
"city",
"other",
null
],
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Level",
"default": null,
"description": "Only this kind of government."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20,
"description": "How many grants to return, 1-50 (default 20)."
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "State",
"default": null,
"description": "A 2-letter state code, e.g. \"KS\"."
},
"min_amount": {
"type": "number",
"title": "Min Amount",
"default": 1000000,
"description": "Smallest grant in dollars: 250000, 1000000 (default), 5000000 or 25000000."
}
}
},
"outputSchema": {
"type": "object",
"title": "follow_the_grantDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Follow new federal grants to state and local governments",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Buildings and spaces GSA leases for federal agencies whose leases end soon (GSA's Inventory of Owned and Leased Properties, weekly, public domain): address, city, state, rentable square feet, the lease's start and end dates and days left, soonest first, with the count by state and by year. A lease ending is a renewal, a move or a new build-out: early work for janitorial, security, moving, furniture, cabling and construction firms nearby. The end date is a signal: GSA often extends or stays past it; the list names no tenant agency, owner or rent.
| Parameter | Type | Description |
|---|---|---|
| q | any | Words in the building's name or street address. |
| city | any | A city, e.g. "Richmond". |
| limit | integer | How many leases to return, 1-50 (default 20). |
| state | any | A 2-letter state code, e.g. "VA". |
| months | integer | Leases ending within this many months, 1-60 (default 24). |
| min_sqft | any | Smallest rentable area in square feet, e.g. 20000. |
{
"name": "federal_leases",
"title": "Find federal leases that end soon",
"description": "Buildings and spaces GSA leases for federal agencies whose leases end soon (GSA's Inventory\n of Owned and Leased Properties, weekly, public domain): address, city, state, rentable square\n feet, the lease's start and end dates and days left, soonest first, with the count by state\n and by year. A lease ending is a renewal, a move or a new build-out: early work for janitorial,\n security, moving, furniture, cabling and construction firms nearby. The end date is a signal:\n GSA often extends or stays past it; the list names no tenant agency, owner or rent.",
"inputSchema": {
"type": "object",
"title": "federal_leasesArguments",
"properties": {
"q": {
"anyOf": [
{
"type": "string",
"maxLength": 60
},
{
"type": "null"
}
],
"title": "Q",
"default": null,
"description": "Words in the building's name or street address."
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "City",
"default": null,
"description": "A city, e.g. \"Richmond\"."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20,
"description": "How many leases to return, 1-50 (default 20)."
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "State",
"default": null,
"description": "A 2-letter state code, e.g. \"VA\"."
},
"months": {
"type": "integer",
"title": "Months",
"default": 24,
"description": "Leases ending within this many months, 1-60 (default 24)."
},
"min_sqft": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Min Sqft",
"default": null,
"description": "Smallest rentable area in square feet, e.g. 20000."
}
}
},
"outputSchema": {
"type": "object",
"title": "federal_leasesDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Find federal leases that end soon",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Rule of Two evidence (FAR 19.502-2: set an acquisition aside when at least two responsible small businesses can be expected to offer): the small firms, or the 8(a), HUBZone, SDVOSB or WOSB firms, that the government recorded as small on contract actions in an industry over the last three fiscal years, at the agency and in the state when given, and that are still registered in SAM.gov. Returns the count for each scope (here, the agency anywhere, government-wide), the firms with their awards, how the work has been bought (share to small businesses and through set-asides, by year), the registered pool, the size standard and `text`, the pack ready to send. It counts the record; the contracting officer decides.
| Parameter | Type | Description |
|---|---|---|
| naics * | string | The industry: a NAICS code or words, e.g. "561720" or "janitorial". |
| state | any | Where the work is performed, e.g. "VA" or "Virginia". |
| agency | any | The buying agency, bureau or office, e.g. "VA", "Army". |
| program | string | Which firms to count: "small" (default), "8a", "hubzone", "sdvosb" or "wosb". |
{
"name": "rule_of_two",
"title": "Count the small businesses that can do a kind of work",
"description": "Rule of Two evidence (FAR 19.502-2: set an acquisition aside when at least two responsible\n small businesses can be expected to offer): the small firms, or the 8(a), HUBZone, SDVOSB or\n WOSB firms, that the government recorded as small on contract actions in an industry over the\n last three fiscal years, at the agency and in the state when given, and that are still\n registered in SAM.gov. Returns the count for each scope (here, the agency anywhere,\n government-wide), the firms with their awards, how the work has been bought (share to small\n businesses and through set-asides, by year), the registered pool, the size standard and\n `text`, the pack ready to send. It counts the record; the contracting officer decides.",
"inputSchema": {
"type": "object",
"title": "rule_of_twoArguments",
"required": [
"naics"
],
"properties": {
"naics": {
"type": "string",
"title": "Naics",
"description": "The industry: a NAICS code or words, e.g. \"561720\" or \"janitorial\"."
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "State",
"default": null,
"description": "Where the work is performed, e.g. \"VA\" or \"Virginia\"."
},
"agency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Agency",
"default": null,
"description": "The buying agency, bureau or office, e.g. \"VA\", \"Army\"."
},
"program": {
"type": "string",
"title": "Program",
"default": "small",
"description": "Which firms to count: \"small\" (default), \"8a\", \"hubzone\", \"sdvosb\" or \"wosb\"."
}
}
},
"outputSchema": {
"type": "object",
"title": "rule_of_twoDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Count the small businesses that can do a kind of work",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Search the FAR and the DFARS (48 CFR chapters 1 and 2, as codified in the eCFR): sections whose title or text has every word, or a section number (e.g. 52.219-14) straight to it. reg: FAR | DFARS to limit. Returns section numbers, titles and a snippet; read one with get_far_section. The codified text lags the Revolutionary FAR Overhaul's class deviations.
| Parameter | Type | Description |
|---|---|---|
| reg | enum | Limit to one regulation: FAR or DFARS; omit for both. |
| query * | string | Words that must all appear in the section's title or text (e.g. "limitations on subcontracting"), or a section number (e.g. "52.219-14"). |
{
"name": "search_far",
"title": "Search the FAR and DFARS",
"description": "Search the FAR and the DFARS (48 CFR chapters 1 and 2, as codified in the eCFR): sections\n whose title or text has every word, or a section number (e.g. 52.219-14) straight to it.\n reg: FAR | DFARS to limit. Returns section numbers, titles and a snippet; read one with\n get_far_section. The codified text lags the Revolutionary FAR Overhaul's class deviations.",
"inputSchema": {
"type": "object",
"title": "search_farArguments",
"required": [
"query"
],
"properties": {
"reg": {
"enum": [
"FAR",
"DFARS",
null
],
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Reg",
"default": null,
"description": "Limit to one regulation: FAR or DFARS; omit for both."
},
"query": {
"type": "string",
"title": "Query",
"description": "Words that must all appear in the section's title or text (e.g. \"limitations on subcontracting\"), or a section number (e.g. \"52.219-14\")."
}
}
},
"outputSchema": {
"type": "object",
"title": "search_farDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Search the FAR and DFARS",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}One FAR or DFARS section's full text (paragraphs), its part and subpart, the sections it refers to and the ones referring to it, and Federal Register rules changing its part. Cite it as FAR <section> (or DFARS) with the as-of date in source.
| Parameter | Type | Description |
|---|---|---|
| section * | string | A FAR or DFARS section number, e.g. "52.204-21", "19.502-2" or "252.204-7012". |
{
"name": "get_far_section",
"title": "Read a FAR or DFARS section",
"description": "One FAR or DFARS section's full text (paragraphs), its part and subpart, the sections it\n refers to and the ones referring to it, and Federal Register rules changing its part. Cite\n it as FAR <section> (or DFARS) with the as-of date in source.",
"inputSchema": {
"type": "object",
"title": "get_far_sectionArguments",
"required": [
"section"
],
"properties": {
"section": {
"type": "string",
"title": "Section",
"description": "A FAR or DFARS section number, e.g. \"52.204-21\", \"19.502-2\" or \"252.204-7012\"."
}
}
},
"outputSchema": {
"type": "object",
"title": "get_far_sectionDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Read a FAR or DFARS section",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}State, county and city government bids and contracts (not federal awards), from the governments that publish them as open data: Los Angeles (the City, LA County, LADWP, LAUSD, airports, port, Metro), New York City, San Francisco, Washington DC, Chicago, Cook County, Austin, Detroit, Richmond, Sacramento, Baton Rouge, Montgomery County MD, Delaware, Texas DOT, California state departments (Cal eProcure), SUNY construction, E-Rate and others. kind: "open" (taking responses, soonest due first), "planned" (forecasts: TxDOT's planned lettings, Illinois CDB, San Diego County), "awarded" (contracts first awarded in the last year: who won, net amounts) or "current" (in force today, soonest ending first: the re-bids). q: words in the title or description; state: two-letter code (open and planned bids); source: one source key from the reply's sources. Coverage is partial: no tool has every state, county and city; say so when the place asked about isn't covered. Each row links to the government's own record (source_url).
| Parameter | Type | Description |
|---|---|---|
| q | any | Words in the title or description, e.g. "roofing" or "janitorial". |
| kind | string | open (taking responses, soonest due first), planned (forecasts), awarded (contracts first awarded in the last year) or current (in force today, soonest ending first). |
| limit | integer | Most rows to return, 1-50. |
| state | any | Two-letter state code, e.g. "TX" (open and planned bids). |
| source | any | One source key from the reply's sources, e.g. "txdot", "nyc", "lacity". |
{
"name": "search_local_bids",
"title": "Search state and local bids and contracts",
"description": "State, county and city government bids and contracts (not federal awards), from the\n governments that publish them as open data: Los Angeles (the City, LA County, LADWP, LAUSD,\n airports, port, Metro), New York City, San Francisco, Washington DC, Chicago, Cook County,\n Austin, Detroit, Richmond, Sacramento, Baton Rouge, Montgomery County MD, Delaware, Texas DOT,\n California state departments (Cal eProcure), SUNY construction, E-Rate and others.\n kind: \"open\" (taking responses, soonest due first), \"planned\" (forecasts: TxDOT's planned\n lettings, Illinois CDB, San Diego County), \"awarded\" (contracts first awarded in the last\n year: who won, net amounts) or \"current\" (in force today, soonest ending first: the re-bids).\n q: words in the title or description; state: two-letter code (open and planned bids);\n source: one source key from the reply's sources. Coverage is partial: no tool has every\n state, county and city; say so when the place asked about isn't covered. Each row links to\n the government's own record (source_url).",
"inputSchema": {
"type": "object",
"title": "search_local_bidsArguments",
"properties": {
"q": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Q",
"default": null,
"description": "Words in the title or description, e.g. \"roofing\" or \"janitorial\"."
},
"kind": {
"enum": [
"open",
"planned",
"awarded",
"current"
],
"type": "string",
"title": "Kind",
"default": "open",
"description": "open (taking responses, soonest due first), planned (forecasts), awarded (contracts first awarded in the last year) or current (in force today, soonest ending first)."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 25,
"description": "Most rows to return, 1-50."
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "State",
"default": null,
"description": "Two-letter state code, e.g. \"TX\" (open and planned bids)."
},
"source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source",
"default": null,
"description": "One source key from the reply's sources, e.g. \"txdot\", \"nyc\", \"lacity\"."
}
}
},
"outputSchema": {
"type": "object",
"title": "search_local_bidsDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Search state and local bids and contracts",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Where to bid in a place: the state's, county's or city's own bid / procurement portal, the platform it runs on (Bonfire, OpenGov, DemandStar, PlanetBids, BidNet Direct...), its open bids list when known (open_bids_url: give that link first), department bid pages (more_links), where vendors register, and the levels above it (a city's county and state). Covers every state and territory, every county with a county government and the cities and towns of 10,000+; a smaller place gets its state's portal. status: confirmed (the bid page was checked), listed (added by hand; the site blocks automated checks) or site_only (only the official site so far: say the bid page isn't confirmed; no site means no working official website was found, so point to the county and state instead). in_spendquery: sources whose bids or contracts search_local_bids already has. certification_and_help: the state's own small-business certifications (Texas HUB, Virginia SWaM...; empty when it has none) and the national help (APEX Accelerators, SBDCs, SBA certifications). For a city, open_federal_notices_url lists the open SAM.gov notices performed there (search_notices with state and city gives them as data). SpendQuery links to these portals; it doesn't copy their bids.
| Parameter | Type | Description |
|---|---|---|
| place * | string | A state, county or city as people write it: "Simi Valley, CA", "Ventura County, California", "Texas". |
{
"name": "find_bid_portals",
"title": "Find where a state, county or city posts its bids",
"description": "Where to bid in a place: the state's, county's or city's own bid / procurement portal,\n the platform it runs on (Bonfire, OpenGov, DemandStar, PlanetBids, BidNet Direct...), its open\n bids list when known (open_bids_url: give that link first), department bid pages (more_links),\n where vendors register, and the levels above it (a city's county and state). Covers every state and\n territory, every county with a county government and the cities and towns of 10,000+; a smaller place gets its state's\n portal. status: confirmed (the bid page was checked), listed (added by hand; the site blocks\n automated checks) or site_only (only the official site so far: say the bid page isn't\n confirmed; no site means no working official website was found, so point to the county and\n state instead). in_spendquery: sources whose bids or contracts search_local_bids already has.\n certification_and_help: the state's own small-business certifications (Texas HUB, Virginia\n SWaM...; empty when it has none) and the national help (APEX Accelerators, SBDCs, SBA\n certifications). For a city, open_federal_notices_url lists the open SAM.gov notices performed\n there (search_notices with state and city gives them as data).\n SpendQuery links to these portals; it doesn't copy their bids.",
"inputSchema": {
"type": "object",
"title": "find_bid_portalsArguments",
"required": [
"place"
],
"properties": {
"place": {
"type": "string",
"title": "Place",
"description": "A state, county or city as people write it: \"Simi Valley, CA\", \"Ventura County, California\", \"Texas\"."
}
}
},
"outputSchema": {
"type": "object",
"title": "find_bid_portalsDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Find where a state, county or city posts its bids",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}SBIR and STTR awards since 1983 from SBA's SBIR.gov records, and who received them: totals, awards by year (Phase I / II), by agency, the companies with the most, and the latest awards (company, title, agency, phase, amount, year). Filters: agency (as SBIR.gov names it, e.g. "Department of Defense"), phase ("Phase I" or "Phase II"), program ("SBIR" or "STTR"), state (the winner's), q (words in the award title), company_uei, since (first award year). open_topics: also the SBIR/STTR solicitations open now (SAM.gov and Grants.gov). SBIR.gov counts awards by award year; USAspending (run_plan) counts money by fiscal year, so the two differ.
| Parameter | Type | Description |
|---|---|---|
| q | any | Words in the award title, e.g. "hypersonic" or "battery". |
| phase | enum | The award phase: Phase I or Phase II. |
| since | any | First award year to count, e.g. 2020. |
| state | any | The winner's two-letter state code, e.g. "VA". |
| agency | any | The awarding agency as SBIR.gov names it, e.g. "Department of Defense", "National Science Foundation". |
| program | enum | The program: SBIR or STTR. |
| company_uei | any | A winner's 12-character UEI, e.g. "ZFN2JJXBLZT3". |
| open_topics | boolean | Also list the SBIR/STTR solicitations open now (SAM.gov and Grants.gov). |
{
"name": "sbir_awards",
"title": "Search SBIR and STTR awards",
"description": "SBIR and STTR awards since 1983 from SBA's SBIR.gov records, and who received them:\n totals, awards by year (Phase I / II), by agency, the companies with the most, and the\n latest awards (company, title, agency, phase, amount, year). Filters: agency (as SBIR.gov\n names it, e.g. \"Department of Defense\"), phase (\"Phase I\" or \"Phase II\"), program (\"SBIR\" or\n \"STTR\"), state (the winner's), q (words in the award title), company_uei, since (first award\n year). open_topics: also the SBIR/STTR solicitations open now (SAM.gov and Grants.gov).\n SBIR.gov counts awards by award year; USAspending (run_plan) counts money by fiscal year, so\n the two differ.",
"inputSchema": {
"type": "object",
"title": "sbir_awardsArguments",
"properties": {
"q": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Q",
"default": null,
"description": "Words in the award title, e.g. \"hypersonic\" or \"battery\"."
},
"phase": {
"enum": [
"Phase I",
"Phase II",
null
],
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Phase",
"default": null,
"description": "The award phase: Phase I or Phase II."
},
"since": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Since",
"default": null,
"description": "First award year to count, e.g. 2020."
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "State",
"default": null,
"description": "The winner's two-letter state code, e.g. \"VA\"."
},
"agency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Agency",
"default": null,
"description": "The awarding agency as SBIR.gov names it, e.g. \"Department of Defense\", \"National Science Foundation\"."
},
"program": {
"enum": [
"SBIR",
"STTR",
null
],
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Program",
"default": null,
"description": "The program: SBIR or STTR."
},
"company_uei": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Company Uei",
"default": null,
"description": "A winner's 12-character UEI, e.g. \"ZFN2JJXBLZT3\"."
},
"open_topics": {
"type": "boolean",
"title": "Open Topics",
"default": false,
"description": "Also list the SBIR/STTR solicitations open now (SAM.gov and Grants.gov)."
}
}
},
"outputSchema": {
"type": "object",
"title": "sbir_awardsDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Search SBIR and STTR awards",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Federal grant opportunities on Grants.gov: open ones soonest closing first (or forecast), by words and by who may apply, each with its number, agency, close date, award ceiling and estimated funding, and its spendquery.com page, plus up to 5 forecast grants on the same words (expected, not yet open). The search wants every word in the listing: with no match it tries fewer words and says what it searched for.
| Parameter | Type | Description |
|---|---|---|
| q | any | Words in the grant's title or description, e.g. "homelessness" or "rural broadband". |
| who | enum | Who may apply: nonprofit, local (cities and counties), state, tribe, university, small_business, business or individual. |
| stage | string | open (taking applications, soonest closing first) or forecast (expected). |
{
"name": "grant_opportunities",
"title": "Find federal grant opportunities",
"description": "Federal grant opportunities on Grants.gov: open ones soonest closing first (or forecast),\n by words and by who may apply, each with its number, agency, close date, award ceiling and\n estimated funding, and its spendquery.com page, plus up to 5 forecast grants on the same words\n (expected, not yet open). The search wants every word in the listing: with no match it tries\n fewer words and says what it searched for.",
"inputSchema": {
"type": "object",
"title": "grant_opportunitiesArguments",
"properties": {
"q": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Q",
"default": null,
"description": "Words in the grant's title or description, e.g. \"homelessness\" or \"rural broadband\"."
},
"who": {
"enum": [
"nonprofit",
"local",
"state",
"tribe",
"university",
"small_business",
"business",
"individual",
null
],
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Who",
"default": null,
"description": "Who may apply: nonprofit, local (cities and counties), state, tribe, university, small_business, business or individual."
},
"stage": {
"enum": [
"open",
"forecast"
],
"type": "string",
"title": "Stage",
"default": "open",
"description": "open (taking applications, soonest closing first) or forecast (expected)."
}
}
},
"outputSchema": {
"type": "object",
"title": "grant_opportunitiesDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Find federal grant opportunities",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Who does a kind of work, for the last complete fiscal year: the primes (with their certifications), the subcontractors primes reported paying (FSRS subawards), and prime -> subcontractor pairs, the teaming and subcontracting leads. Give at least one of naics, psc or agency; state narrows to where the work is done.
| Parameter | Type | Description |
|---|---|---|
| psc | any | A product or service code (PSC), e.g. "S201" (custodial). |
| naics | any | A NAICS code, e.g. "561720" (janitorial services). |
| state | any | A state the work is done in, two letters, e.g. "VA". |
| agency | any | An agency by name or code, e.g. "Department of the Navy". |
{
"name": "primes_and_subcontractors",
"title": "Find primes and subcontractors for a kind of work",
"description": "Who does a kind of work, for the last complete fiscal year: the primes (with their\n certifications), the subcontractors primes reported paying (FSRS subawards), and prime ->\n subcontractor pairs, the teaming and subcontracting leads. Give at least one of naics, psc\n or agency; state narrows to where the work is done.",
"inputSchema": {
"type": "object",
"title": "primes_and_subcontractorsArguments",
"properties": {
"psc": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Psc",
"default": null,
"description": "A product or service code (PSC), e.g. \"S201\" (custodial)."
},
"naics": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Naics",
"default": null,
"description": "A NAICS code, e.g. \"561720\" (janitorial services)."
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "State",
"default": null,
"description": "A state the work is done in, two letters, e.g. \"VA\"."
},
"agency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Agency",
"default": null,
"description": "An agency by name or code, e.g. \"Department of the Navy\"."
}
}
},
"outputSchema": {
"type": "object",
"title": "primes_and_subcontractorsDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Find primes and subcontractors for a kind of work",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Open SAM.gov contract notices still taking responses, in one call (no QueryPlan): by words (also matched by meaning), NAICS, place, set-aside, agency and notice type, soonest deadline first. Each notice has its id (for get_notice), set-aside, deadline with time zone, days left, the stated or likely size, a single-bid risk flag and its SAM.gov link; with counts by notice type and set-aside. near + miles: only work within that many miles of a ZIP, city or county (each notice then has `miles`; notices that name only a state are left out: say so). For past awards and money use run_plan.
| Parameter | Type | Description |
|---|---|---|
| q | any | Words for the work, e.g. "janitorial" or "cloud migration" (matched by meaning too). |
| days | integer | Responses due within this many days, 1-365 (default 60). |
| near | any | Work within `miles` of a ZIP code, city or county, e.g. "93065", "Los Angeles, CA". |
| sort | string | due (soonest deadline first), posted (newest first) or size. |
| limit | integer | How many notices to return, 1-50 (default 20). |
| miles | number | The radius for `near`, 1-200 miles (default 25). |
| naics | any | A NAICS code or industry words, e.g. "561720" or "IT services". |
| state | any | Place of performance: a state code or name, e.g. "VA" or "Texas". |
| agency | any | A department, bureau or office, e.g. "Navy", "VA", "Department of Energy". |
| set_aside | any | A set-aside as people say it, e.g. "SDVOSB", "8(a)", "small business", "HUBZone". |
| notice_type | any | A notice type, e.g. "Solicitation", "Sources Sought", "Combined Synopsis/Solicitation". |
{
"name": "search_notices",
"title": "Search open contract notices",
"description": "Open SAM.gov contract notices still taking responses, in one call (no QueryPlan): by\n words (also matched by meaning), NAICS, place, set-aside, agency and notice type, soonest\n deadline first. Each notice has its id (for get_notice), set-aside, deadline with time zone,\n days left, the stated or likely size, a single-bid risk flag and its SAM.gov link; with\n counts by notice type and set-aside. near + miles: only work within that many miles of a ZIP,\n city or county (each notice then has `miles`; notices that name only a state are left out:\n say so). For past awards and money use run_plan.",
"inputSchema": {
"type": "object",
"title": "search_noticesArguments",
"properties": {
"q": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Q",
"default": null,
"description": "Words for the work, e.g. \"janitorial\" or \"cloud migration\" (matched by meaning too)."
},
"days": {
"type": "integer",
"title": "Days",
"default": 60,
"description": "Responses due within this many days, 1-365 (default 60)."
},
"near": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Near",
"default": null,
"description": "Work within `miles` of a ZIP code, city or county, e.g. \"93065\", \"Los Angeles, CA\"."
},
"sort": {
"enum": [
"due",
"posted",
"size"
],
"type": "string",
"title": "Sort",
"default": "due",
"description": "due (soonest deadline first), posted (newest first) or size."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20,
"description": "How many notices to return, 1-50 (default 20)."
},
"miles": {
"type": "number",
"title": "Miles",
"default": 25,
"description": "The radius for `near`, 1-200 miles (default 25)."
},
"naics": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Naics",
"default": null,
"description": "A NAICS code or industry words, e.g. \"561720\" or \"IT services\"."
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "State",
"default": null,
"description": "Place of performance: a state code or name, e.g. \"VA\" or \"Texas\"."
},
"agency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Agency",
"default": null,
"description": "A department, bureau or office, e.g. \"Navy\", \"VA\", \"Department of Energy\"."
},
"set_aside": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Set Aside",
"default": null,
"description": "A set-aside as people say it, e.g. \"SDVOSB\", \"8(a)\", \"small business\", \"HUBZone\"."
},
"notice_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Notice Type",
"default": null,
"description": "A notice type, e.g. \"Solicitation\", \"Sources Sought\", \"Combined Synopsis/Solicitation\"."
}
}
},
"outputSchema": {
"type": "object",
"title": "search_noticesDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Search open contract notices",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}One company in one call: federal money by year (all its registrations rolled up), top agencies, industries, places and largest awards, SAM.gov registration (expiry, size and certifications), exclusions, state payments and a short brief, each section with its answer and first rows, and its spendquery.com page. Uses the page as built for the site when there is one (fast), else builds it (5-15 s).
| Parameter | Type | Description |
|---|---|---|
| company * | string | A company UEI (12 characters, e.g. "YMZ1PCB5LEM9"), name or ticker, e.g. "Leidos". |
{
"name": "company_profile",
"title": "Look up a company's federal profile",
"description": "One company in one call: federal money by year (all its registrations rolled up), top\n agencies, industries, places and largest awards, SAM.gov registration (expiry, size and\n certifications), exclusions, state payments and a short brief, each section with its\n answer and first rows, and its spendquery.com page. Uses the page as built for the site\n when there is one (fast), else builds it (5-15 s).",
"inputSchema": {
"type": "object",
"title": "company_profileArguments",
"required": [
"company"
],
"properties": {
"company": {
"type": "string",
"title": "Company",
"description": "A company UEI (12 characters, e.g. \"YMZ1PCB5LEM9\"), name or ticker, e.g. \"Leidos\"."
}
}
},
"outputSchema": {
"type": "object",
"title": "company_profileDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Look up a company's federal profile",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}The recompete pipeline: contracts ending in the next months with the incumbent, value, how they were bought (offers received, set-aside, vehicle) and the likeliest follow-on SAM.gov notice when one is posted, soonest ending first. Filters take names as people say them (VA, 541512, IT services, Leidos). Each contract's `open_seat` lists the reasons its incumbent could not win it again as bought (empty for most); open_seat=true keeps only those. They are leads from the registration, to be checked, not findings. `health` reads the contract's own numbers: the share of its term gone, option months not yet exercised, obligations against its value and ceiling (contracts that started in the loaded years), and `signals` in words (near its ceiling, under-spent, options left). `expected_notice`, where no likely follow-on notice is posted yet: the window in which this office usually posts one (from, to, status ahead | open | passed), measured from its past follow-ons.
| Parameter | Type | Description |
|---|---|---|
| q | any | Words in the contract description, e.g. "help desk". |
| limit | integer | How many contracts to return, 1-50 (default 20). |
| naics | any | A NAICS code or industry words, e.g. "541512" or "janitorial". |
| agency | any | An agency, bureau or office, e.g. "Army", "VA". |
| months | integer | Contracts ending within this many months, 1-24 (default 12). |
| company | any | An incumbent by name or UEI, e.g. "Leidos". |
| min_value | number | Smallest current contract value in dollars (default 1,000,000). |
| open_seat | boolean | Only re-bids the incumbent's SAM.gov registration says it could not win again as bought: registration expired, excluded, no longer small for the NAICS on a small-business set-aside, or without the set-aside's certification. |
| set_aside | any | The set-aside of the current contract, e.g. "8(a)", "SDVOSB". |
{
"name": "recompetes",
"title": "Find contracts coming up for re-bid",
"description": "The recompete pipeline: contracts ending in the next months with the incumbent, value,\n how they were bought (offers received, set-aside, vehicle) and the likeliest follow-on\n SAM.gov notice when one is posted, soonest ending first. Filters take names as people say\n them (VA, 541512, IT services, Leidos). Each contract's `open_seat` lists the reasons its\n incumbent could not win it again as bought (empty for most); open_seat=true keeps only\n those. They are leads from the registration, to be checked, not findings. `health` reads\n the contract's own numbers: the share of its term gone, option months not yet exercised,\n obligations against its value and ceiling (contracts that started in the loaded years),\n and `signals` in words (near its ceiling, under-spent, options left). `expected_notice`,\n where no likely follow-on notice is posted yet: the window in which this office usually\n posts one (from, to, status ahead | open | passed), measured from its past follow-ons.",
"inputSchema": {
"type": "object",
"title": "recompetesArguments",
"properties": {
"q": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Q",
"default": null,
"description": "Words in the contract description, e.g. \"help desk\"."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20,
"description": "How many contracts to return, 1-50 (default 20)."
},
"naics": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Naics",
"default": null,
"description": "A NAICS code or industry words, e.g. \"541512\" or \"janitorial\"."
},
"agency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Agency",
"default": null,
"description": "An agency, bureau or office, e.g. \"Army\", \"VA\"."
},
"months": {
"type": "integer",
"title": "Months",
"default": 12,
"description": "Contracts ending within this many months, 1-24 (default 12)."
},
"company": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Company",
"default": null,
"description": "An incumbent by name or UEI, e.g. \"Leidos\"."
},
"min_value": {
"type": "number",
"title": "Min Value",
"default": 1000000,
"description": "Smallest current contract value in dollars (default 1,000,000)."
},
"open_seat": {
"type": "boolean",
"title": "Open Seat",
"default": false,
"description": "Only re-bids the incumbent's SAM.gov registration says it could not win again as bought: registration expired, excluded, no longer small for the NAICS on a small-business set-aside, or without the set-aside's certification."
},
"set_aside": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Set Aside",
"default": null,
"description": "The set-aside of the current contract, e.g. \"8(a)\", \"SDVOSB\"."
}
}
},
"outputSchema": {
"type": "object",
"title": "recompetesDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Find contracts coming up for re-bid",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}One notice (or expiring contract) as its SpendQuery brief, no AI: the notice's facts and deadline, the contract it likely follows and how sure the match is, the incumbent and its money at the agency, other contracts it may follow, who else wins this work at the agency (with set-aside eligibility from their own SAM.gov registrations and how likely each is to bid, read from award history only), the contracting office (active contracts, how often its competed contracts drew one offer, how it usually buys), what similar work was awarded for (award values with options, not bids; prepared by a job, so "pending" the first time: ask again in a few minutes), the competitors' GSA ceiling rates and the agency's IT budget. For the decision card, the timeline of the buy and file changes: get_notice.
| Parameter | Type | Description |
|---|---|---|
| notice_id * | string | A SAM.gov notice id (the 32-character hex id in sam.gov/opp/<id>/view, or from search_notices), or an expiring contract's award key from recompetes (e.g. "CONT_AWD_N0010426FB406_9700_N0010426GB401_9700"). |
{
"name": "opportunity_brief",
"title": "Get a notice's opportunity brief",
"description": "One notice (or expiring contract) as its SpendQuery brief, no AI: the notice's facts and\n deadline, the contract it likely follows and how sure the match is, the incumbent and its\n money at the agency, other contracts it may follow, who else wins this work at the agency\n (with set-aside eligibility from their own SAM.gov registrations and how likely each is to\n bid, read from award history only), the contracting office (active contracts, how often its\n competed contracts drew one offer, how it usually buys), what similar work was awarded for\n (award values with options, not bids; prepared by a job, so \"pending\" the first time: ask\n again in a few minutes), the competitors' GSA ceiling rates and the agency's IT budget. For\n the decision card, the timeline of the buy and file changes: get_notice.",
"inputSchema": {
"type": "object",
"title": "opportunity_briefArguments",
"required": [
"notice_id"
],
"properties": {
"notice_id": {
"type": "string",
"title": "Notice Id",
"description": "A SAM.gov notice id (the 32-character hex id in sam.gov/opp/<id>/view, or from search_notices), or an expiring contract's award key from recompetes (e.g. \"CONT_AWD_N0010426FB406_9700_N0010426GB401_9700\")."
}
}
},
"outputSchema": {
"type": "object",
"title": "opportunity_briefDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Get a notice's opportunity brief",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}What is new with one company (a competitor, a teaming partner, a prime), from the records, no AI: its new awards (base awards to it or a subsidiary in the last 45 days of loaded data, largest first; Defense publishes about 90 days late), its contracts ending within 12 months as incumbent (with the follow-on SAM.gov notice when one is posted: the re-bids to watch), and open SAM.gov notices in its main industries (its top NAICS codes by contract dollars in the last two fiscal years), newest first. On spendquery.com a signed-in user can follow the company and get these weekly by e-mail.
| Parameter | Type | Description |
|---|---|---|
| company * | string | A company UEI (12 characters), name or ticker, e.g. "Leidos" or "YMZ1PCB5LEM9". |
{
"name": "competitor_watch",
"title": "Watch a company: its new awards, re-bids and notices",
"description": "What is new with one company (a competitor, a teaming partner, a prime), from the\n records, no AI: its new awards (base awards to it or a subsidiary in the last 45 days of\n loaded data, largest first; Defense publishes about 90 days late), its contracts ending\n within 12 months as incumbent (with the follow-on SAM.gov notice when one is posted: the\n re-bids to watch), and open SAM.gov notices in its main industries (its top NAICS codes by\n contract dollars in the last two fiscal years), newest first. On spendquery.com a signed-in\n user can follow the company and get these weekly by e-mail.",
"inputSchema": {
"type": "object",
"title": "competitor_watchArguments",
"required": [
"company"
],
"properties": {
"company": {
"type": "string",
"title": "Company",
"description": "A company UEI (12 characters), name or ticker, e.g. \"Leidos\" or \"YMZ1PCB5LEM9\"."
}
}
},
"outputSchema": {
"type": "object",
"title": "competitor_watchDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Watch a company: its new awards, re-bids and notices",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}For pricing a bid: what contracts in an industry (and state) are typically worth over the last three complete fiscal years (percentiles of award values by kind: definitive contracts, purchase orders, orders under vehicles; by set-aside and competition), and GSA schedule ceiling hourly rates (CALC+) for a labor category. Never a suggested price.
| Parameter | Type | Description |
|---|---|---|
| naics | any | A NAICS code, 2-6 digits, e.g. "561720". |
| state | any | A state code to narrow award sizes, e.g. "VA". |
| labor_category | any | A labor category for GSA ceiling rates, e.g. "senior software engineer". |
| small_business_rates | boolean | Labor rates of small businesses only. |
{
"name": "award_prices",
"title": "Look up typical award sizes and labor rates",
"description": "For pricing a bid: what contracts in an industry (and state) are typically worth over the\n last three complete fiscal years (percentiles of award values by kind: definitive contracts,\n purchase orders, orders under vehicles; by set-aside and competition), and GSA schedule\n ceiling hourly rates (CALC+) for a labor category. Never a suggested price.",
"inputSchema": {
"type": "object",
"title": "award_pricesArguments",
"properties": {
"naics": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Naics",
"default": null,
"description": "A NAICS code, 2-6 digits, e.g. \"561720\"."
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "State",
"default": null,
"description": "A state code to narrow award sizes, e.g. \"VA\"."
},
"labor_category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Labor Category",
"default": null,
"description": "A labor category for GSA ceiling rates, e.g. \"senior software engineer\"."
},
"small_business_rates": {
"type": "boolean",
"title": "Small Business Rates",
"default": false,
"description": "Labor rates of small businesses only."
}
}
},
"outputSchema": {
"type": "object",
"title": "award_pricesDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Look up typical award sizes and labor rates",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}SpendQuery answers questions about US federal spending (USAspending.gov prime awards: contracts, grants, loans, direct payments). Amounts are obligations (money committed), not outlays. How to answer a question: 1. Call get_catalog once: it lists metrics, dimensions, analyses, the QueryPlan JSON schema, planning rules and worked examples for federal questions (section="states" for state, county and city checkbooks). 2. Write a QueryPlan in business terms (e.g. filters [{"dimension": "agency", "values": ["DoD"]}]). Put names as the user said them; the server resolves them. Use search_codes / search_recipients when you need to check a name, code or company first, and browse_codes to explore products/services (PSC) or industries (NAICS) with their spend. 3. Call run_plan. If status is "clarify", ask the user the returned question. 4. Report the answer with its caveats; mention that amounts are obligations. Things that trip planners up: - A company's total comes from run_plan with a company filter (it rolls up subsidiaries). search_recipients' obligations are one registration's own money: a parent UEI often has little or none of its own (it can even be negative), because the money sits on its units. - Give fiscal_years. Without them a plan sums every loaded year, including the year in progress (see coverage in run_plan's reply; Defense publishes about 90 days late). - award_category is singular: "contract" or "assistance". Growth is analysis "compare" with baseline_years. "Businesses only" is a filter (business_type / recipient_type), not a field. - Company and recipient rankings leave out payments with no recipient ID (aggregate payments to individuals); the answer says how much was left out. - For one contract notice's brief (the contract it follows, the incumbent, who else wins this work at the agency, the contracting office, what similar work was awarded for, GSA rates), call opportunity_brief with its id (or an expiring contract's award key); for its decision card, the timeline of the buy and what changed in its files, get_notice. For small-business size, size_standard; to find a company's NAICS codes, naics_finder; for which GWACs or IDIQs carry an industry's money, vehicle_match. - Where a state, county or city posts its own bids (portal, platform, vendor registration): find_bid_portals ("Simi Valley, CA"); its bids themselves, where SpendQuery loads them: search_local_bids. - Within a distance of a place ("40 miles of Los Angeles", "near 93065"): search_notices with near + miles for open notices (each with its miles); for money, run_plan with a filter {"dimension": "near", "values": ["40 miles of Los Angeles, CA"]} (the counties in the circle). - State, county and city bids and contracts (not federal awards): search_local_bids. SBIR and STTR awards and who received them (SBA's SBIR.gov records since 1983): sbir_awards. The FAR and DFARS: search_far, then get_far_section. Federal grant opportunities open on Grants.gov (or forecast), by topic and who may apply: grant_opportunities. Who does a kind of work as prime and as subcontractor, and prime -> subcontractor pairs (teaming leads): primes_and_subcontractors. - One-step tools that need no QueryPlan: search_notices (open SAM.gov notices by words, NAICS, place, set-aside, agency), company_profile (one company's federal profile), competitor_watch (what's new with a company: new awards, contracts ending, notices in its lines), recompetes (contracts ending soon, with the incumbent) and award_prices (typical award sizes and GSA labor rates, for pricing). Prefer them to run_plan for those questions. - recompetes also says, per contract: open_seat (why the incumbent could not win it again as it was bought, from its SAM.gov registration), health (options left, money against the ceiling) and expected_notice (the window in which its office usually posts the follow-on). These are leads to check, not findings: say so.
Names, descriptions and schemas were written by the server and are shown as data.