US Federal Procurement MCP

Federal contracting intelligence for small businesses — as an MCP server. Search contract opportunities, understand set-asides and NAICS codes, and analyze solicitations for small-business fit and risk — from inside Claude, Cursor, or any MCP client.

This fills the biggest gap in US small-business (SBA) contracting: an LLM trained on the public internet cannot know current contract opportunities or reliably recall the set-aside rules, FAR thresholds, and NAICS structure that determine whether a bid is even worth pursuing. This server makes that real and queryable.

Tools (8)

Everything is deterministic, typed, and honest about its data source.

Install & run

python3 -m venv .venv
.venv/bin/pip install -e .
.venv/bin/pytest tests/ -q      # 41 tests incl. real MCP stdio integration
.venv/bin/us-gov-mcp            # or: .venv/bin/python -m usgovmcp.server

Connect a client

Claude Desktop / Claude Code / Cursor → see configs/. Set PYTHONPATH to this repo; optionally add a SAM_GOV_API_KEY.

Data

• Default: a bundled set of clearly-labeled sample opportunities so it works and is tested with no key.

• Live (SAM.gov): get a free public API key from your SAM.gov account → Account Details → request a public API key. Set SAM_GOV_API_KEY. The provider (SAMGovProvider) already talks to api.sam.gov/opportunities/v2/search and is unit-tested against the real response shape. Live data is never faked — until a key is set, labeled samples are returned.

Layout

us-gov-mcp/
├── usgovmcp/
│   ├── server.py       ← FastMCP server wiring all tools
│   ├── knowledge.py    ← NAICS, set-asides, FAR thresholds, red-flag rules
│   ├── analyzer.py     ← fit scoring + red-flag scan
│   ├── providers.py    ← bundled + SAM.gov live providers
│   ├── models.py       ← typed Opportunity / search params
│   ├── intel.py        ← market-snapshot aggregation
│   └── sample_data.py  ← labeled demo opportunities
├── configs/
├── tests/              ← 41 tests incl. real stdio protocol integration
├── pyproject.toml
└── README.md

MIT licensed. Not legal advice — always read the full solicitation before bidding.