GovCon API MCP
Most SAM.gov MCP servers wrap one dataset behind six to ten tools. This is 53 tools across five federal sources, already joined on the identifiers they share, including full text extracted from inside solicitation attachments.
US federal procurement data for agents: 668,576 SAM.gov opportunities, 10,787,941 FPDS prime contract transactions, 887,310 SAM-registered entities, 225,945 FFATA subawards, 164,322 exclusions, 13,778 decided GAO protests, and ~262,000 GSA CALC labor rates. Cross-linked on UEI, CAGE, PIID and NAICS, so one question does not become five integrations.
Free 14-day trial, no credit card. Get a key, then
pipx install govconapi-mcp.
Why this, and not the next SAM.gov wrapper
Most federal-contracting MCP servers are thin proxies over the official SAM.gov API. Four concrete differences.
- It searches inside the documents, not just the notice. We extracted and indexed the full text of 506,382 documents attached to 209,095 opportunities, 31.4 billion characters, including 57,527 files recovered from archives nested up to five levels deep that never appear in SAM's own attachment list, and 41,764 scanned documents recovered with OCR (measured 2026-07-16). A requirement like CMMC, a clearance level, or an option year is usually in the SOW, not the notice. Most tools structurally cannot see it.
- Five sources, already joined. SAM.gov opportunities and entities, FPDS contract transactions, USAspending/FFATA subawards, SAM exclusions, SBA DSBS certifications and GSA CALC rates, resolved onto shared identifiers. A wrapper hands your agent one dataset and leaves the joins to it.
- No SAM.gov entity registration and no company UEI required. GSA documents 10 requests/day for a non-federal user without a SAM role, and 1,000/day with one. Access here is an email and a key.
- 53 tools, organised by lifecycle stage. Market research, opportunity discovery, capture and teaming, bid and negotiate, award and compliance. You should not have to know our URL structure to know which tool answers your question.
Connect
pipx install govconapi-mcp
pipx puts the binary somewhere Claude Desktop's sandbox can spawn it. On macOS, brew install pipx first. With uv, use uvx --from govconapi-mcp govconapi-mcp. Python 3.10+.
Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):
{
"mcpServers": {
"govconapi": {
"command": "govconapi-mcp",
"env": { "GOVCONAPI_KEY": "gca_your_key_here" }
}
}
}
Restart Claude. For Claude Code, Cursor, VS Code, Zed and custom Python agents, see the install reference.
Ask it things like
Find DoD cybersecurity solicitations posted this month over $1M.
Which active solicitations mention CMMC anywhere in their attachments?
Find RFPs requiring an active Secret clearance, even when the notice itself does not say so.
Who are the entrenched incumbents in NAICS 541512, and how competitive is that market?
Is this contract entering recompete, and is the incumbent's set-aside certification expiring first?
Turn this UEI into a contractor profile: registration, awards, subcontracting activity, exclusions.
Has this vendor ever been excluded from federal contracts?
The 53 tools
Full reference with parameters: TOOLS.md.
| Stage | Tools | Answers |
|---|---|---|
| Market research | 12 | where a NAICS gets bought, by whom, how contested |
| Opportunity discovery | 3 | what is live now that matches my capability |
| Capture and teaming | 12 | who is winning, who to team with, who to call |
| Bid, price and negotiate | 9 | what it should cost, labor rates, is my team clean |
| Award and compliance | 13 | who won, on what terms, was it protested |
| Agencies, awards, exclusions, identifiers | 4 | name resolution, award notices, screening, DUNS to UEI |
13 tools require Pro and return HTTP 402 on Developer. 4 more work on Developer with specific fields or filters gated. The other 36 have no plan distinction. Each is marked in TOOLS.md.
What it is not
- Not a replacement for SAM.gov as the system of record. We normalize public federal data and preserve source provenance. For the authoritative record, or for a submission, go to SAM.gov.
- Not real-time. Opportunities refresh daily. If your use case turns on minute-level freshness, this is the wrong tool and we would rather you knew now.
- Not state or local. US federal procurement only.
- Not a proposal writer, CRM, or BD platform. It is a data layer. If you want an end-to-end capture suite, buy one of those instead and point it here.
- FPDS coverage starts 2024-10-01 (FY2025 onward). Deep multi-year historical market research is a real limitation, not an oversight.
- Source defects pass through. SAM and FPDS contain impossible dates, $0 amounts and null UEIs. We surface them as they are and document the gotchas rather than silently cleaning them, because the corruption belongs to the system of record.
Plans
| Plan | Price | Limits |
|---|---|---|
| Free trial | $0, 14 days | 25 requests/day |
| Developer | $19/mo | 1,000 requests/hour |
| Pro | $39/mo | adds the 13 Pro tools and richer fields on 4 more |
MCP access is included with every plan, including the trial. No separate tier.
Troubleshooting
GOVCONAPI_KEY environment variable is not set , add it to the MCP config above and restart the client.
Invalid API key , keys start with gca_. Get one at govconapi.com.
At least one filter required , search_opportunities needs at least one filter (naics, keywords, state and so on). For a bulk sync, use recent_changes instead.
Rate limited (429) , free trial is 25 calls/day, Developer 1,000/hour.
A 402 naming a specific feature , that tool is Pro. TOOLS.md marks which.
Links
- API reference: https://govconapi.com/api-guide
- Tool reference: https://govconapi.com/mcp/tools
- Machine-readable docs: https://govconapi.com/llms.txt and https://govconapi.com/openapi.json
- Support: support@govconapi.com
MIT licensed. Data sourced from SAM.gov, FPDS, USAspending, SBA DSBS and GSA CALC, all public federal data.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file govconapi_mcp-0.2.1.tar.gz.
File metadata
- Download URL: govconapi_mcp-0.2.1.tar.gz
- Upload date:
- Size: 34.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.15
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
543b19a1b9d62bf3c725de0f5cb788878492d1b7d73526f9b7329cfe53746364
|
|
| MD5 |
f7fd4face575d47170a91c4ae7a8a35a
|
|
| BLAKE2b-256 |
b8256886cef2cb46e42a9a395638ee50fe3ba03044488754c8adc903c21a79b4
|
File details
Details for the file govconapi_mcp-0.2.1-py3-none-any.whl.
File metadata
- Download URL: govconapi_mcp-0.2.1-py3-none-any.whl
- Upload date:
- Size: 36.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.15
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
50d50b0ff3b8354cbc8cc8e57f6421a5c62f45d83824db22d18eede28b527649
|
|
| MD5 |
940b16676f939406b4b965d2cb2de81d
|
|
| BLAKE2b-256 |
5e21b6145bb141aba49e5d294728ea43b93d54a1e02c5a42d6587446b5224d7c
|