SAM.gov contract opportunities and entity lookup (BYOK) plus USASpending federal award data.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Resolve a federal agency name fragment to its official awarding-agency names (toptier and subtier) as USAspending knows them - use before search_awards or spending_by_category when unsure of the exact agency name. Keyless.
Agency name fragment, e.g. "navy" or "DISA"
Resolve a federal agency name fragment to its official awarding-agency names (toptier and subtier) as USAspending knows them - use before search_awards or spending_by_category when unsure of the exact agency name. Keyless.
| Argument | Type | Description |
|---|---|---|
| query* | string | Agency name fragment, e.g. "navy" or "DISA" |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Agency name fragment, e.g. \"navy\" or \"DISA\""
}
}
}Resolve an industry description to NAICS codes (or look up what a NAICS code means). Use before search_opportunities/search_awards to get the right code. Keyless.
| Argument | Type | Description |
|---|---|---|
| query* | string | Industry description ("cybersecurity services") or a NAICS code ("541512") |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Industry description (\"cybersecurity services\") or a NAICS code (\"541512\")"
}
}
}Get full detail for one federal award from USAspending.gov by its generated award id (from search_awards results, e.g. "CONT_AWD_...") - description, obligations, period of performance, awarding/funding agencies, recipient, and place of performance. Keyless.
| Argument | Type | Description |
|---|---|---|
| award_id* | string | generated_internal_id / generated_unique_award_id from search_awards |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"award_id"
],
"properties": {
"award_id": {
"type": "string",
"description": "generated_internal_id / generated_unique_award_id from search_awards"
}
}
}Look up a federal contractor registration in SAM.gov by Unique Entity ID (UEI) or legal business name: registration status, CAGE code, physical address, business types (SDVOSB, 8(a), HUBZone, etc.), and NAICS codes. Call this to vet a teaming partner, check a competitor, or confirm an entity is award-eligible. Public registration sections only. Requires the caller's own free SAM.gov API key (X-Sam-Api-Key header or sam_api_key argument).
| Argument | Type | Description |
|---|---|---|
| uei | string | 12-character Unique Entity ID |
| name | string | Legal business name (partial match allowed) - used when no UEI given |
| sam_api_key | string | Your own free SAM.gov API key. Required unless it is already set as the X-Sam-Api-Key header on the MCP connection; this server has no shared SAM.gov key. Get one free at sam.gov: sign in, open your profile (Account Details), request a public API key. Docs: https://open.gsa.gov/api/get-opportunities-public-api/. Never logged or stored. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"uei": {
"type": "string",
"description": "12-character Unique Entity ID"
},
"name": {
"type": "string",
"description": "Legal business name (partial match allowed) - used when no UEI given"
},
"sam_api_key": {
"type": "string",
"description": "Your own free SAM.gov API key. Required unless it is already set as the X-Sam-Api-Key header on the MCP connection; this server has no shared SAM.gov key. Get one free at sam.gov: sign in, open your profile (Account Details), request a public API key. Docs: https://open.gsa.gov/api/get-opportunities-public-api/. Never logged or stored."
}
}
}Search actual federal contract awards on USAspending.gov - who won what, from which agency, for how much. Filter by keywords, NAICS, PSC, recipient name, agency, date range, and award amount. Keyless and unlimited. Call this for competitive intelligence ("who holds contracts in this space"), incumbent research, or agency spending patterns.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max results (default 10) |
| end_date | string | YYYY-MM-DD (default: today) |
| keywords | array | Keyword filters |
| psc_codes | array | |
| recipient | string | Recipient (contractor) name search |
| max_amount | number | |
| min_amount | number | |
| start_date | string | YYYY-MM-DD (default: 1 year ago) |
| agency_name | string | Awarding toptier agency name, e.g. "Department of Defense" |
Search active federal contract opportunities on SAM.gov: solicitations, presolicitations, sources sought, RFIs, and award notices - filterable by keywords, NAICS, set-aside (SDVOSB, 8(a), HUBZone, WOSB, small business), notice type, agency, and posted-date range (max 1 year). Call this when the user wants to find federal bidding opportunities or market intelligence on what agencies are buying. Requires the caller's own free SAM.gov API key (X-Sam-Api-Key header or sam_api_key argument); without one it returns an error explaining how to get and pass a key.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max results (default 10) |
| agency | string | Department/agency name filter |
| keywords | string | Free-text keywords, e.g. "CMMC compliance" |
| posted_to | string | YYYY-MM-DD (default: today) |
| set_aside | array | Set-aside codes: SDVOSBC/SDVOSBS (SDVOSB), VSA/VSS (VOSB), SBA/SBP (small business), 8A/8AN, HZC/HZS (HUBZone), WOSB/EDWOSB |
| naics_codes | array | NAICS codes, e.g. ["541512"] |
| notice_type | array | o=solicitation, p=presolicitation, r=sources sought, k=combined synopsis, g=surplus, s=special notice, a=award notice, i=intent to bundle, u=J&A |
Aggregate federal contract spending by NAICS, PSC, recipient, or awarding agency over a date range, optionally filtered by keywords/NAICS/agency - market sizing in one call ("top contractors in NAICS 541512 last year", "which agencies buy the most cybersecurity"). Keyless.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Top N (default 10) |
| category* | string | |
| end_date | string | YYYY-MM-DD (default: today) |
| keywords | array | |
| start_date | string | YYYY-MM-DD (default: 1 year ago) |
| agency_name | string | |
| naics_codes | array |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"category"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Top N (default 10)"
},
"category": {
"enum": [
"naics",
"psc",
"recipient",
"awarding_agency"
],
"type": "string"
},
"end_date": {
"type": "string",
"description": "YYYY-MM-DD (default: today)"
},
"keywords": {
"type": "array",
"items": {
"type": "string"
}
},
"start_date": {
"type": "string",
"description": "YYYY-MM-DD (default: 1 year ago)"
},
"agency_name": {
"type": "string"
},
"naics_codes": {
"type": "array",
"items": {
"type": "string"
}
}
}
}| naics_codes | array |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 25,
"minimum": 1,
"description": "Max results (default 10)"
},
"end_date": {
"type": "string",
"description": "YYYY-MM-DD (default: today)"
},
"keywords": {
"type": "array",
"items": {
"type": "string"
},
"description": "Keyword filters"
},
"psc_codes": {
"type": "array",
"items": {
"type": "string"
}
},
"recipient": {
"type": "string",
"description": "Recipient (contractor) name search"
},
"max_amount": {
"type": "number"
},
"min_amount": {
"type": "number"
},
"start_date": {
"type": "string",
"description": "YYYY-MM-DD (default: 1 year ago)"
},
"agency_name": {
"type": "string",
"description": "Awarding toptier agency name, e.g. \"Department of Defense\""
},
"naics_codes": {
"type": "array",
"items": {
"type": "string"
}
}
}
}| posted_from | string | YYYY-MM-DD (default: 90 days ago; SAM allows at most a 1-year window) |
| sam_api_key | string | Your own free SAM.gov API key. Required unless it is already set as the X-Sam-Api-Key header on the MCP connection; this server has no shared SAM.gov key. Get one free at sam.gov: sign in, open your profile (Account Details), request a public API key. Docs: https://open.gsa.gov/api/get-opportunities-public-api/. Never logged or stored. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 25,
"minimum": 1,
"description": "Max results (default 10)"
},
"agency": {
"type": "string",
"description": "Department/agency name filter"
},
"keywords": {
"type": "string",
"description": "Free-text keywords, e.g. \"CMMC compliance\""
},
"posted_to": {
"type": "string",
"description": "YYYY-MM-DD (default: today)"
},
"set_aside": {
"type": "array",
"items": {
"enum": [
"SDVOSBC",
"SDVOSBS",
"VSA",
"VSS",
"SBA",
"SBP",
"8A",
"8AN",
"HZC",
"HZS",
"WOSB",
"EDWOSB"
],
"type": "string"
},
"description": "Set-aside codes: SDVOSBC/SDVOSBS (SDVOSB), VSA/VSS (VOSB), SBA/SBP (small business), 8A/8AN, HZC/HZS (HUBZone), WOSB/EDWOSB"
},
"naics_codes": {
"type": "array",
"items": {
"type": "string"
},
"description": "NAICS codes, e.g. [\"541512\"]"
},
"notice_type": {
"type": "array",
"items": {
"enum": [
"o",
"p",
"r",
"k",
"g",
"s",
"a",
"i",
"u"
],
"type": "string"
},
"description": "o=solicitation, p=presolicitation, r=sources sought, k=combined synopsis, g=surplus, s=special notice, a=award notice, i=intent to bundle, u=J&A"
},
"posted_from": {
"type": "string",
"description": "YYYY-MM-DD (default: 90 days ago; SAM allows at most a 1-year window)"
},
"sam_api_key": {
"type": "string",
"description": "Your own free SAM.gov API key. Required unless it is already set as the X-Sam-Api-Key header on the MCP connection; this server has no shared SAM.gov key. Get one free at sam.gov: sign in, open your profile (Account Details), request a public API key. Docs: https://open.gsa.gov/api/get-opportunities-public-api/. Never logged or stored."
}
}
}