Search SAM.gov contract opportunities
search_opportunitiesRead-onlyIdempotent
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.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max results (default 10) | |
| agency | No | Department/agency name filter | |
| keywords | No | Free-text keywords, e.g. "CMMC compliance" | |
| posted_to | No | YYYY-MM-DD (default: today) | |
| set_aside | No | Set-aside codes: SDVOSBC/SDVOSBS (SDVOSB), VSA/VSS (VOSB), SBA/SBP (small business), 8A/8AN, HZC/HZS (HUBZone), WOSB/EDWOSB | |
| naics_codes | No | NAICS codes, e.g. ["541512"] | |
| notice_type | No | 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 | No | YYYY-MM-DD (default: 90 days ago; SAM allows at most a 1-year window) | |
| sam_api_key | No | 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. |