SAM.gov MCP

SAM.gov MCP

A Model Context Protocol server that wraps the SAM.gov REST APIs as deterministic tool calls. Built for federal contracting officers, GS-1102 contract specialists, and small business government contractors who need plain-English access to SAM.gov entity, exclusion, opportunity, and contract award data.

19 tools. Live-tested across 6 audit rounds against production SAM.gov endpoints. MIT licensed.

What it does

Entity Management (UEI, CAGE, registration status)

• Look up entities by UEI, CAGE code, or DUNS legacy
• Check registration status, expiration date, and core data section flags
• Pull business types, NAICS codes, PSC codes
• Retrieve representations and certifications (FAR/DFARS reps and certs)
• Get points of contact and physical/mailing addresses
• Validate entities for award eligibility

Exclusions (debarment and suspension)

• Check a single UEI or CAGE for active exclusions
• Search the exclusion list by name, agency, or exclusion type
• Returns exclusion type (Reciprocal, Procurement, Nonprocurement), CT codes, and termination dates

Contract Opportunities (active solicitations and sources sought)

• Search active solicitations by NAICS, set-aside type, agency, posting date, and response deadline
• Filter by Total Small Business, 8(a), SDVOSB, WOSB, EDWOSB, HubZone, or unrestricted
• Pull sources sought notices, presolicitations, combined synopsis/solicitations, and award notices
• Retrieve full opportunity descriptions and attachments

Contract Awards (FPDS replacement)

• Search awards by PIID, vendor UEI, agency, NAICS, PSC, or fiscal year
• Pull modification history for a contract (mods, options, exercised periods)
• Get vendor award profiles across all federal agencies
• Returns ceiling value, obligated amount, contract type, and competition data

Federal Hierarchy (agency normalization)

• Look up the federal hierarchy by department, sub-agency, or office
• Normalize CGAC, sub-tier, and office codes
• Map between FPDS contracting office codes and SAM.gov hierarchy

FFATA Subaward Reporting

• Search subawards reported under FFATA
• Pull subaward detail by prime award PIID

Compatibility

Works with any local MCP client:

• Claude Desktop (one-click .mcpb install or Copy JSON)
• Codex (ChatGPT) via TOML config or codex mcp add
• Gemini CLI via ~/.gemini/settings.json
• Copilot via .vscode/mcp.json in VS Code
• Claude Code, Cursor, Cline, Zed, Continue, and any other MCP-compatible client that can launch local stdio servers

Install

Requires a free SAM.gov API key from https://sam.gov (rotates every 90 days).

JSON config (Claude Desktop, Gemini CLI, JSON-based clients):

{
  "mcpServers": {
    "sam-gov": {
      "command": "uvx",
      "args": ["--refresh-package", "sam-gov-mcp", "--from", "sam-gov-mcp", "sam-gov-mcp"],
      "env": { "SAM_API_KEY": "your-key-here" }
    }
  }
}
TOML config (Codex):

[mcp_servers.sam-gov]
command = "uvx"
args = ["--refresh-package", "sam-gov-mcp", "--from", "sam-gov-mcp", "sam-gov-mcp"]
[mcp_servers.sam-gov.env]
SAM_API_KEY = "your-key-here"
PyPI: pip install sam-gov-mcp or uvx sam-gov-mcp

Example prompts
"Show me 8(a) and SDVOSB set-aside opportunities posted in the last 30 days under NAICS 541512. Include title, agency, response deadline, and place of performance."
"Look up Leidos in SAM.gov by UEI QVZMH5JLF274. Show me their registration status, CAGE code, physical address, and primary NAICS."
"Pull the 12-month award history for Booz Allen Hamilton. Break down by agency, NAICS, and ceiling vs obligated amounts."
"Find IDIQ vehicles at DoD under NAICS 541512 awarded in the last 24 months so I can see which primes I could team on."
"Check this vendor list for active exclusions before we cut a purchase order."
Hardening
Independently hardened across 6 live audit rounds against production SAM.gov endpoints, plus Hypothesis-driven property tests. Each release ships a testing.md documenting bugs found and fixed. Pydantic models use extra="forbid" to surface API drift instead of silently dropping fields. Defensive response parsing guards against partial outages.

Source
GitHub: https://github.com/1102tools/federal-contracting-mcps/tree/main/servers/sam-gov-mcp
PyPI: https://pypi.org/project/sam-gov-mcp/
Docs and install walkthrough: https://1102tools.com/install
Part of the 1102tools suite: 8 federal contracting MCPs + 6 Claude Skills