SAM.gov

Check if an entity has any exclusion/debarment records by UEI. Returns exclusion records from the consolidated Excluded Parties List. totalRecords=0 means the entity is not currently excluded. totalRecords>0 means one or more exclusion records exist; check recordStatus='Active' on each entry to determine if the exclusion is currently in effect. This is the single most important check for FAR 9.104-1 responsibility determinations and FAR 9.405 debarment prohibitions.

Check SAM.gov credential presence without returning or validating its value.

Fetch FAPIIS proceedings integrity information for an entity by UEI. integrityInformation is NOT included in the default response or even includeSections=All. Requires explicit request plus proceedingsData=Yes query parameter. Returns proceedings disclosures per FAR 52.209-7/9.

Fetch FAR/DFARS representations and certifications for an entity by UEI. repsAndCerts is NOT included in the default response or even in includeSections=All. It must be explicitly requested. Returns the entity's responses to standard FAR 52.212-3, FAR 52.204-17, FAR 52.209-2, FAR 52.219-1, FAR 52.222-18, FAR 52.225-2, DFARS 252.204-7016, and other certification clauses. Combined with entityRegistration for identification context. Parameters: - summary_only (default True): returns a condensed view (clause ID, title, and answer summary per clause) instead of the full certification text. The full repsAndCerts payload for a large entity can exceed 70KB, which blows the MCP response budget. Set False to get the raw response. - clause_filter: list of FAR/DFARS clause identifiers to include (e.g. ['FAR 52.204-17', 'FAR 52.219-1']). Case-insensitive substring match. Combines with summary_only.

Fetch the full description text for a contract opportunity by notice ID. The 'description' field in search_opportunities results is a URL, not inline text. This tool handles the second fetch to retrieve the actual HTML description. Pass the noticeId from the search results.

Get the immediate child organizations of a federal organization. Pass an FH org ID (use search_federal_organizations to find one) and receive the list of its direct subordinates. To traverse the full tree, call recursively on each child. Pagination uses limit (1-100) / offset.

Look up contract award modifications for a single PIID. Returns up to 100 modification records for the given Procurement Instrument Identifier, sorted by modification number client-side (the API returns them unsorted). Large IDVs can exceed 100 mods; when totalRecords is larger than the returned list a _note flags the truncation. This is the primary way to get the history of a contract action. PIIDs are alphanumeric identifiers assigned by the contracting office. Format varies by agency (e.g. "GS-35F-0119Y", "W912BV22P0112", "N0003925F7516"). The search is exact match. include_sections: comma-separated list of contractId, coreData, awardDetails. Defaults to all sections if not specified. Returns normalized response with awardSummary list containing all modifications. Check totalRecords for the number of mods found.

Look up a federal entity by its CAGE code. CAGE (Commercial and Government Entity) codes are 5-character alphanumeric identifiers assigned by DLA. Useful when you have a CAGE but no UEI.

Look up a federal entity by its Unique Entity ID (UEI). Returns the full entity record from SAM.gov Entity Management v3. The UEI is a 12-character alphanumeric identifier assigned by SAM.gov. Matching is case-insensitive and whitespace-tolerant (live-verified). A UEI is NOT guaranteed unique: live data contains UEIs with multiple (sometimes duplicate) registration records, so totalRecords can exceed 1; inspect every entityData entry rather than assuming [0] is the only one. sam_registered='No' searches a separate ~614k-record population of "ID Assigned" entities (UEI issued, registration never completed). include_sections controls response size: - entityRegistration: UEI, CAGE, name, status, activation/expiration dates (ALWAYS include) - coreData: addresses, POCs at high level, business types, hierarchy - assertions: NAICS and PSC codes (in goodsAndServices subsection) - pointsOfContact: detailed POC records (name, title, address; email/phone FOUO only) - repsAndCerts: FAR/DFARS certification responses (must be explicitly requested) - integrityInformation: FAPIIS proceedings data (must be explicitly requested) - All: entityRegistration + coreData + assertions + pointsOfContact (but NOT repsAndCerts/integrityInformation) Default: entityRegistration + coreData. Always include entityRegistration alongside any other section or the response loses entity identification. sam_registered='Yes' (default) returns only fully registered entities. Use 'No' to find entities with a UEI assigned but incomplete registration.

Look up a Product/Service Code (PSC) by its code value. Returns the PSC name, full name, level 1 and level 2 category information, and includes/excludes guidance. Useful for validating PSC codes before using them as filters in other searches.

Search FFATA subcontract reports (acquisition subawards). These are subcontracts reported by prime contractors under the Federal Funding Accountability and Transparency Act. Use this to map prime contractors to their subs, see subcontract values, and identify the full distribution of a federal procurement dollar. CRITICAL: dates use ISO yyyy-MM-dd format (NOT MM/dd/yyyy like the rest of SAM.gov). Pagination uses pageNumber/pageSize (NOT limit/offset). Key filters: - prime_contract_key: business key for subawards under a prime - piid: Procurement Instrument ID of the prime contract (returns all subs) - referenced_idv_piid: prime contract family identifier (parent IDV) - referenced_idv_agency_id: agency on the parent IDV - agency_id: four-digit agency code on the prime (e.g. 9700 for DoD) - prime_award_type: type of the parent prime award - from_date / to_date: yyyy-MM-dd window (filters on subaward report date) - status: 'Published' (default) or 'Deleted' for audit trails - page_number: 0-based page index. Stay within ceil(totalRecords/page_size): pages past the end HANG upstream until timeout (live-verified 2026-08) - page_size: 1-1000, default 100 Response: {totalPages, totalRecords, pageNumber, nextPageLink, previousPageLink, data: [...]}.

Search FFATA grant subaward reports (financial assistance subawards). These are subawards reported by prime grant recipients on cooperative agreements and grants. Use this to trace federal grant funds from prime recipient down to subrecipients. CRITICAL: dates use ISO yyyy-MM-dd format (NOT MM/dd/yyyy). Pagination uses pageNumber/pageSize. Key filters: - prime_award_key: business key identifying subawards under a prime grant - fain: Federal Award Identification Number for grants - agency_code: FOUR-DIGIT agency code on the prime (e.g. 9700 for DoD, 7529 for HHS/IHS). The API rejects anything else with "AgencyCode must be a four digit number"; 3-digit CGAC codes like 075 do NOT work here (unlike the Federal Hierarchy tools, which accept CGAC) - from_date / to_date: yyyy-MM-dd window - status: 'Published' (default) or 'Deleted' - page_number: 0-based page index. Stay within ceil(totalRecords/page_size): pages past the end HANG upstream until timeout (live-verified 2026-08) - page_size: 1-1000, default 100

Search contract award records on SAM.gov (FPDS replacement). This is the replacement for FPDS.gov (decommissioned Feb 2026). Same data, new endpoint. Uses limit/offset pagination (NOT page/size), and note that despite the name, offset is a ZERO-BASED PAGE INDEX (live-verified 2026-08): offset=1 with limit=100 returns records 101-200. Never advance offset by limit or you will silently skip almost everything. CRITICAL date format: MM/dd/yyyy for single dates, [MM/dd/yyyy,MM/dd/yyyy] for ranges (brackets included). ISO 8601 dates are rejected. Boolean operators: use ~ for OR (e.g. naics_code="541512~541511"), use ! for NOT (e.g. extent_competed_code="!A"). Key parameters: - awardee_name: awardeeLegalBusinessName (partial match). NOT "vendorName". - awardee_uei: awardeeUniqueEntityId (exact match) - awardee_cage_code: awardeeCageCode (exact match) - piid: Procurement Instrument Identifier. Returns all mods for that PIID. - naics_code: 6-digit NAICS. Supports ~ for OR, ! for NOT. - psc_code: Product/Service Code (4-char). Supports ~ for OR. - contracting_department_code: top-level department (e.g. "9700" for DoD) - contracting_subtier_code: subtier agency (e.g. "1700" for Navy) - contracting_office_code: contracting office (e.g. "N00039") - date_signed: date of award action. MM/dd/yyyy or [MM/dd/yyyy,MM/dd/yyyy] - last_modified_date: when record was last modified. Same format. - fiscal_year: filter by FY (e.g. "2026"). Data observed back to FY1970. - award_or_idv: "AWARD" for contracts/orders, "IDV" for indefinite-delivery vehicles - type_of_contract_pricing_code: J=FFP, U=CPFF, etc. - type_of_set_aside_code: SBA, 8A, HZC, SDVOSBC, etc. - extent_competed_code: A=Full, B=Not Available, CDO=Competed Under SAP, etc. - dollars_obligated: bracket range [min,max] as string - modification_number: "0" for base award, specific mod number, or range - free_text: q parameter for full-text search across all fields - include_sections: comma-separated: contractId, coreData, awardD…

Search contract award records that have been deleted from FPDS/SAM.gov. Uses the same Contract Awards endpoint with deletedStatus=Y. Deleted records are removed from normal search results but remain accessible through this parameter. Useful for audit trails and historical research. Supports the same date format as search_contract_awards: MM/dd/yyyy or [MM/dd/yyyy,MM/dd/yyyy] for ranges. limit: 1-100 (default 10). offset: 0-based pagination.

Search SAM.gov entities with flexible filters. All filters are AND-ed together. Returns paginated results; note that Entity Management has a HARD CAP of 10 records per page (size <= 10). For more results, increment 'page' and make multiple calls. Key filter notes: - legal_business_name does partial matching with no relevance ranking. Cannot contain & or parentheses (API strips them, returns 0 results). For exact lookup use UEI or CAGE. - primary_naics matches the entity's designated primary NAICS only. - any_naics matches any NAICS the entity has on file. - business_type_code covers self-selected types: QF (SDVOSB), A2 (Women-Owned), 8W (WOSB), 23 (Minority-Owned), NB (Native American Owned), A3 (Labor Surplus Area Firm), and any other 2-character code from the SAM Functional Data Dictionary "Business Types" field: the full FDD set passes through. SDVOSB is NOT XS (that's S-Corp). - sba_business_type_code covers SBA-certified programs, which SAM.gov filters through a dedicated sbaBusinessTypeCode parameter: A6 (8(a) Program Participant), XX (HUBZone), JT (8(a) Joint Venture), A4 (Small Disadvantaged Business), A9 (SBA-Certified WOSB), A0 (SBA-Certified EDWOSB). Per the SAM data dictionary, XX is HUBZone and A6 is 8(a); do not swap them. Note A9 is the SBA-CERTIFIED WOSB population; 8W on business_type_code is the broader self-designated WOSB flag. SBA codes passed to business_type_code raise a redirect error. - state_code is 2-letter USPS. - purpose_of_registration: Z1=Federal Assistance Awards only, Z2=All Awards, Z3=IGT-Only (Intra-Governmental Transactions), Z4=Federal Assistance Awards and IGT, Z5=All Awards and IGT. (Pre-1.0.2 releases blocked Z3/Z4 and mislabeled Z5 as "Supplemental grants".) - free_text (q parameter) ANDs multiple words together. "cybersecurity cloud" returns entities matching BOTH words, not either. Default registration_status is 'A' (Active); use 'E' for expired registrations. Only A and E are real filt…

Search SAM.gov exclusion records with flexible filters. All filters are AND-ed. Unlike Entity Management, Exclusions uses 'size' (not 'limit') for pagination. Size can go up to 100 per page. Key filter notes: - entity_name: firm name for classification=Firm; for individuals use the full name. Cannot contain &, |, {, }, ^, backslash. - cage_code: 5-character CAGE of the excluded entity. - classification: Firm, Individual, Vessel, or Special Entity Designation. - exclusion_program: Reciprocal (cross-agency), NonProcurement, or Procurement. - excluding_agency_code: agency code that imposed the exclusion (e.g., DOD, HHS). - country: MUST be 3-character ISO alpha-3 (USA, CAN, GBR). 2-char codes (US, CA, GB) return 0 results. - activation_date_range: use bracket format [MM/DD/YYYY,MM/DD/YYYY]. - free_text (q parameter): supports wildcards (*), AND, OR operators. Example: "acme*" matches any company starting with acme.

Search the SAM.gov Federal Hierarchy. Returns federal organizations (departments, agencies, sub-agencies, offices) with their FH IDs, codes, hierarchical relationships, and status. Useful for normalizing agency names to canonical FH IDs before passing them to Contract Awards, Opportunities, or Subaward searches. Filter notes: - fh_org_id: exact lookup by Federal Hierarchy organization ID (numeric). - fh_org_name: partial substring match on the organization name. - fh_org_type: case-insensitive substring filter. Live values from the API look like 'Department/Ind. Agency', but the API also accepts shorthand like 'DEPARTMENT' or 'AGENCY' and matches loosely. Pass whatever the response showed, or one of: department, agency, sub-agency, office, major command, field activity. - status: ACTIVE (default if filter omitted), INACTIVE (retired), or MERGED. Live audit (April 2026): the API defaults to ACTIVE-only when no filter is sent, so passing status='ACTIVE' is a no-op vs. the unfiltered call. Pass 'INACTIVE' to expand the search to retired orgs. - agency_code: legacy agency code if known. - cgac: Common Government-wide Accounting Classification (Treasury) code. Pagination uses limit (1-100) / offset (0-based). The Federal Hierarchy API uses lowercase 'totalrecords' and 'orglist' in responses (unlike the camelCase used elsewhere in SAM.gov); the normalizer preserves both keys.

Search contract opportunities on SAM.gov. posted_from and posted_to are MANDATORY. Format is MM/DD/YYYY (not ISO 8601). The date range cannot exceed 364 days. For older notices or longer ranges, chain multiple calls with sequential date windows. Notice type codes: - p = Presolicitation - o = Solicitation - k = Combined Synopsis/Solicitation - r = Sources Sought - s = Special Notice - i = Intent to Bundle - a = Award Notice - u = Justification (J&A) - g = Sale of Surplus Property WORKING filters: title, solicitation_number, notice_id, notice_type, naics_code, psc_code, set_aside, state, zip_code, response_deadline_from, response_deadline_to. BROKEN filters (do not use): deptname, subtier. The SAM.gov API silently ignores these. To filter by agency, use agency_keyword: this tool will post-filter the results by checking fullParentPathName for a substring match. PSC code filter (psc_code) requires exact 4-character match. Prefix matching (e.g. 'R4') returns 0 results; use 'R425'. Set-aside codes: SBA, SBP, 8A, 8AN, HZC, HZS, SDVOSBC, SDVOSBS, WOSB, WOSBSS, EDWOSB, EDWOSBSS, LAS (Local Area), IEE (Buy Indian Act), ISBEE (Buy Indian Act small business), BICiv (IHS Buy Indian), VSA, VSS. Case-insensitive; documented casing goes on the wire. The 'description' field in each result is a URL, not inline text. Use get_opportunity_description() to fetch the actual description HTML. Pagination (live-verified 2026-08): offset is a ZERO-BASED PAGE INDEX (page size = limit), not a record skip count; offset=1 with limit=100 returns records 101-200. Compute the last page from totalRecords and stop there: pages past the end do NOT come back empty, they return one arbitrary record, so an empty-page loop terminator never fires.

Free-text search for Product/Service Codes (PSC). Searches across PSC names, descriptions, and category hierarchy. Returns matching PSC codes with full context. Useful for discovering PSCs from plain-language descriptions like 'engineering' or 'application development'.

Composite pre-award vendor responsibility check per FAR 9.104-1. Performs TWO API calls in sequence: 1. Entity Management lookup (registration status, business types, CAGE, activation/expiration dates, exclusion flag on the entity record) 2. Exclusions lookup (active debarment/suspension records) Returns a structured summary with: - registration: full registration details or None if not registered - exclusion: exclusion record count and active exclusion details - flags: list of responsibility concern flags Flag meanings: - NOT_REGISTERED: entity has no SAM registration (cannot receive award per FAR 4.1102) - REGISTRATION_NOT_ACTIVE: registration expired or inactive - EXCLUSION_FLAG_ON_ENTITY: entity record indicates exclusion exists - ACTIVE_EXCLUSION_FOUND: confirmed active exclusion (FAR 9.405 prohibits award) No flags = clear for responsibility determination.