Skip to content
Agentmart
Submit a tool

SAM.gov

SAM.gov entity registration, exclusions, opportunities, contract awards.

Connector by 1102tools · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 26
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/1102tools-sam-gov-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

SAM.gov entity registration, exclusions, opportunities, contract awards. 15 tools.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
20 read · 0 write · 0 deleteRead-only
Secrets
1 (API keys, tokens or passwords)
Install scripts
None found
Runs as
Python package

Tools by what they do 20

Read from the source code; the running server may list different tools.

Read 20 · Look things up without changing anything.

  • check_exclusion_by_uei
  • get_access_status
  • get_entity_integrity_info
  • get_entity_reps_and_certs
  • get_opportunity_description
  • get_organization_hierarchy
  • lookup_award_by_piid
  • lookup_entity_by_cage
  • lookup_entity_by_uei
  • lookup_psc_code
  • search_acquisition_subawards
  • search_assistance_subawards
Show 8 more tools
  • search_contract_awards
  • search_deleted_awards
  • search_entities
  • search_exclusions
  • search_federal_organizations
  • search_opportunities
  • search_psc_free_text
  • vendor_responsibility_check

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • SAM_API_KEY

Network hosts it talks to 6

  • 1102tools.com · found in code
  • acquisition.gov · found in code
  • api.sam.gov · found in code
  • github.com · found in code
  • sam.1102tools.com · found in code
  • sam.gov · found in code

Tools (20)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • check_exclusion_by_ueiCheck Exclusion by UEIread-only

    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.

  • get_access_statusCheck SAM.gov Data Accessread-only

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

  • get_entity_integrity_infoGet Entity Integrity Inforead-only

    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.

  • get_entity_reps_and_certsGet Entity Reps and Certsread-only

    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. T…

  • get_opportunity_descriptionGet Opportunity Descriptionread-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_organization_hierarchyGet Organization Hierarchyread-only

    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.

  • lookup_award_by_piidLookup Award by PIIDread-only

    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: com…

  • lookup_entity_by_cageLookup Entity by CAGEread-only

    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. Public records only: entities that opted out of public display never appear, so zero results does not mean the entity is unregistered.

  • lookup_entity_by_ueiLookup Entity by UEIread-only

    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). Public records only: entities that opted out of public display never appear, so zero results does not mean the entity is unregistered. 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]…

  • lookup_psc_codeLookup PSC Coderead-only

    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_acquisition_subawardsSearch Acquisition Subawardsread-only

    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 …

  • search_assistance_subawardsSearch Assistance Subawardsread-only

    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 anyth…

  • search_contract_awardsSearch Contract Awardsread-only

    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="…

  • search_deleted_awardsSearch Deleted Awardsread-only

    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_entitiesSearch Entitiesread-only

    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. Public records only: entities that opted out of public display never appear, so zero results does not mean the entity is unregistered. 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 ma…

Show 5 more tools
  • search_exclusionsSearch Exclusionsread-only

    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 th…

  • search_federal_organizationsSearch Federal Organizationsread-only

    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 a…

  • search_opportunitiesSearch Opportunitiesread-only

    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_…

  • search_psc_free_textSearch PSC Free Textread-only

    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'.

  • vendor_responsibility_checkVendor Responsibility Checkread-only

    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 when no public record matched - exclusion: exclusion record count and active exclusion details - flags: list of responsibility concern flags Flag meanings: - NO_PUBLIC_RECORD: no public SAM.gov registration mat…

Signals

Stars
26
Forks
9
Open issues
0
Weekly downloads
320
Last commit (this folder)
Oct 21, 2026 (7 days ago)
Last release
Oct 21, 2026 (7 days ago)
Last package publish
Oct 21, 2026 (7 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
io.github.1102tools/sam-gov-mcp
Version
0.4.1
Auth
API key
Packages
pypi sam-gov-mcp
License
MIT
Repository
github.com/1102tools/federal-contracting-mcps
Website
1102tools.com
First seen
Oct 24, 2026
Last checked
Oct 25, 2026
Source
Official MCP Registrygithub-graphql

More from 1102tools

Cite this page

SAM.gov MCP server. Agent Mart. https://agentmart.dev/connectors/1102tools-sam-gov-mcp (last updated 2026-10-25)