GovCon API MCP
OfficialA single MCP server that puts US federal procurement data — opportunities, contracts, companies, subawards, exclusions, protests, wage rates and market analytics — behind one set of tools already joined on UEI, CAGE, PIID and NAICS.
Find opportunities: search SAM.gov notices by NAICS/PSC, agency, keywords, state, set-aside, notice type, dates and value; fetch one by
notice_id; sync changes incrementally withrecent_changes.Research markets: NAICS discovery, curated leaderboards, market size/competition/positioning, simplified-acquisition value bands, plus agency org-tree browsing and contracting-office buying profiles.
Vet and target companies: search firms that have won awards vs. all SAM-registered entities, get profiles/awards/peers, expiring registrations, and decision-maker contacts (vs. contracting-officer contacts on the buyer side).
Chase recompetes: find contracts ending in a window, with incumbent-vulnerability signals like cert lapse and single-agency dependence.
Price and bid: contract-value percentile benchmarks, where your number ranks, GSA CALC awarded labor rates, and SCA/Davis-Bacon wage determinations by location, occupation and rate floor.
Team and subcontract: find partners with real past performance, check SAM exclusions, and run a 7-signal vendor risk report.
Analyze awards: search 10.6M+ FPDS prime transactions and DPAS-style SAM award notices, then pull contract roll-ups, every modification, the vehicle behind an order, vehicle ceilings/holders vs. earners, and FFATA subawards in both directions.
Screen for risk: GAO bid protests by protester, case, outcome or status, and every protest on a single solicitation.
Resolve identifiers: agency names to filter strings, DUNS to UEI, and cross-links between UEI, CAGE and PIID.
Caveats: FPDS-backed data starts FY2025; opportunities refresh daily, not real-time; several tools are Pro-only and return HTTP 402 on the Developer plan.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@GovCon API MCP Find DoD cybersecurity solicitations over $1M posted this month."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
GovCon API MCP
Most SAM.gov MCP servers wrap one dataset behind six to ten tools. This is six tools that reach 53 operations across five federal sources, already joined on the identifiers they share.
US federal procurement data for agents: 668K SAM.gov opportunities, 10.6M FPDS prime contract transactions, 880K SAM-registered entities, 226K FFATA subawards, 164K exclusions, 14K decided GAO protests, and ~262K GSA CALC labor rates. Cross-linked on UEI, CAGE, PIID and NAICS, so one question does not become five integrations.
Counts as of 2026-08-31, rounded. The corpus grows daily, so this file is a snapshot: current per-source totals and freshness dates are always live at /api/v1/status, no key required.
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. Three concrete differences.
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.
Six tools, each named for a job.
resolve,search,get,market,price,contactreach every dataset and record: a model picks the right one more reliably from six than from fifty, and their definitions take about a sixth of the context. The 53 single-purpose tools behind them are one setting away (GOVCONAPI_TOOLS=all).
Related MCP server: EzBiz Government Contracting MCP Server
Connect
Claude, no install. In Claude (web, desktop or mobile), add a custom connector with the address https://mcp.govconapi.com/mcp and sign in with your email. Steps: govconapi.com/mcp/tools#claude-connector.
ChatGPT, no install. In ChatGPT on the web, add a custom MCP server with the same address, authentication OAuth, and sign in with your email. Steps: govconapi.com/mcp/tools#chatgpt.
Local install, for Claude Code, Cursor, VS Code, Zed, Claude Desktop config files and custom agents:
pipx install govconapi-mcppipx 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. To get the 53 single-purpose tools instead of the six, add "GOVCONAPI_TOOLS": "all" to the same env block.
Ask it things like
Find DoD cybersecurity solicitations posted this month over $1M.
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 six tools
Tool | What you ask it |
| Names to IDs: an agency to its filter value, title words to NAICS codes, a company to its UEI, a DUNS to a UEI |
| One of 17 datasets: opportunities, forecasts, contracts, vehicles, subawards, recompetes, companies, entities, partners, protests, exclusions, wage determinations and more |
| One record by ID: an opportunity, contract, vehicle and its holders, recompete, company profile, vendor risk report, protests on a solicitation, wage determination |
| A NAICS market: size, competition, solicitation language, small buys, leaderboards |
| Contract value benchmarks, where a bid ranks, GSA labor rates, SCA and Davis-Bacon wage rates |
| A company's decision-maker, or a contracting officer |
They call the 53 single-purpose tools below, so each capability keeps its plan.
The 53 single-purpose tools (GOVCONAPI_TOOLS=all)
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 |
15 tools require Pro and return HTTP 402 on Developer. 3 more work on Developer with specific fields gated, and the labor-rate benchmark needs any paid plan. The other 34 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 | 50 requests/day |
Developer | $19/mo | 1,000 requests/hour |
Pro | $39/mo | adds the 15 Pro tools and richer fields on 3 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.
Rate limited (429) , free trial is 50 calls/day, Developer 1,000/hour.
A 402 , that tool is Pro. TOOLS.md marks which.
Privacy Policy
Full policy: https://govconapi.com/privacy
What this server does with your data, in short:
Your API key is read from
GOVCONAPI_KEYin your own client's config and sent tohttps://govconapi.comin theAuthorizationheader. This server process does not write it to disk or transmit it anywhere else.Your tool calls become ordinary GovCon API requests. As with any request to the API, we log the timestamp, endpoint, query parameters, response status, response time and which key made the call, for billing, rate-limit enforcement and abuse detection. Usage logs are retained for 90 days.
No conversation content leaves your machine. Only the tool parameters your client fills in are sent, never the surrounding chat, and we log the status a request returned, not the contents of the response.
We do not sell your data.
The data returned is public US federal procurement data from SAM.gov, FPDS, USAspending, SBA DSBS and GSA CALC.
Links
API reference: https://govconapi.com/api-guide
Tool reference: https://govconapi.com/mcp/tools
Live coverage and freshness: https://govconapi.com/api/v1/status
Machine-readable docs: https://govconapi.com/llms.txt and https://govconapi.com/openapi.json
Privacy: https://govconapi.com/privacy · Terms: https://govconapi.com/terms
Support: support@govconapi.com
MIT licensed. Data sourced from SAM.gov, FPDS, USAspending, SBA DSBS and GSA CALC, all public federal data.
Available Tools
6 toolscontactFind who to contactARead-onlyIdempotentInspect
Who to talk to. Both need the Pro plan.
company_decision_maker: a company's decision-maker, from its UEI (resolve(company) finds one); SAM registration agents are filtered out
contracting_officer: a contracting officer's details from their name or email; agency and state narrow it
Inputs: kind (required), uei, name, email, +2 more. Returns: result
getGet one recordARead-onlyIdempotentInspect
Fetch one record by its ID. IDs come from search results or resolve. (Pro) needs the Pro plan.
opportunity: notice_id from search(opportunities)
contract (Pro fields), contract_modifications, contract_vehicle, recompete (Pro): a PIID from search(contracts) or search(recompetes). contract_vehicle is the IDIQ or schedule the contract was ordered under
vehicle, vehicle_holders (Pro): a vehicle PIID from search(vehicles) or get(contract_vehicle)
entity: a UEI (12 characters) or CAGE code (5); company_profile, company_awards, company_peers, vendor_risk (all Pro), prime_subawards, prime_relationships: a UEI from resolve(company)
subaward: subaward_sam_report_id from search(subawards)
protests_on_solicitation (Pro): a solicitation number from an opportunity or contract
wage_determination: wd_id from search(wage_determinations)
office: office_code from search(offices)
organization, organization_relationships: organization_id from resolve(organization); options.direction = children or ancestors for relationships
optionstakes the record's extra arguments: opportunity {attachments: true for the notice's files with names, sizes and download URLs}, company_awards {limit, offset, sort_by, sort_order}, vehicle_holders {limit, awardee_limit}, contract_modifications {limit, offset}, organization_relationships {direction}.
Inputs: id (required), kind (required), options. Returns: result
marketAnalyze a NAICS marketARead-onlyIdempotentInspect
How big a NAICS market is, who wins it, and how it buys, across every agency. A 6-digit naics for the
per-code views, which take no filters (for one agency: search(contracts) with naics and agency).
size: obligated dollars, award count and concentration
competition: offers per award, single-bidder share, set-aside mix
solicitation_language: the phrases contracting officers use in that market's notices
small_buys: how much is bought under the micro-purchase and simplified-acquisition thresholds
leaderboard: ranked NAICS codes;
board= biggest, least_crowded, most_open (no naics needed)find_codes: NAICS codes by market traits; filters: keywords (matches NAICS titles, not topics: use "computer", not "cybersecurity"), sector, prefix, min_market, max_competitors, set_aside_family (total_small_business | 8a | sdvosb | wosb | hubzone), sort_by (market | competitors | setaside_pct)
Inputs: view (required), board, naics, filters. Returns: result
pricePrice a bidARead-onlyIdempotentInspect
Price evidence for a bid. (Pro) needs the Pro plan.
benchmark (Pro): the distribution of comparable contract values. naics (required), psc, agency, date_from, date_to, pricing_type (shorthand: FFP | T&M | CPFF | CPAF | LH), set_aside (code: 8A | SBA | SDVOSBC | WOSB | HZC | NONE), value_basis (current | potential | obligated)
position (Pro): where a value ranks against comparable contracts. naics and value (a string, e.g. "2200000"), required; same optional filters as benchmark
labor_rates: GSA CALC ceiling hourly rates. labor_category (required), match (contains | exact), education_level (HS | AA | BA | MA | PHD), min_experience, max_experience, naics, vendor, worksite, business_size, security_clearance
wage_rates: SCA or Davis-Bacon hourly rates for an occupation. classification (title words, e.g. "Electrician"), occupation_code (SCA 5-digit), type (SCA | DBA), state, wd_number; sort_by: base_rate | classification | wd_number. For one place, get the WD first and read its rates
wage_summary: the spread of those rates. classification or occupation_code, type, state
Inputs: kind (required), filters (required). Returns: result
resolveResolve names to IDsARead-onlyIdempotentInspect
Turn what the user said into the IDs and codes the other tools take. Start here when the user names an agency, describes their work, or names a company.
agency: an agency name or acronym ("Navy", "FEMA") -> the exact
agencyvalue search filters expectnaics: words from NAICS titles ("computer", "engineering", "construction") -> matching codes with market size. It matches titles, not topics: for "cybersecurity" try "computer"
company: a company name -> SAM registrations with their UEI (a large firm has several; pick by name and location, or use search(companies), Pro, which ranks by award history)
identifier: a legacy 9-digit DUNS number -> the matching UEI and company (a CAGE code goes to get(entity))
organization: an agency or sub-agency name -> its organization_id in the federal hierarchy
Inputs: kind (required), query (required). Returns: result
searchSearch federal contracting dataARead-onlyIdempotentInspect
Search one dataset. filters holds that dataset's filters; an unknown filter is refused with the list of valid ones.
Agency values come from resolve(agency), NAICS codes from resolve(naics), UEIs from resolve(company).
Dates are YYYY-MM-DD. (Pro) marks datasets that need the Pro plan. Keep limit small (20-50) and page with
offset: rows are large. Only opportunities, forecasts and partners take keywords.
opportunities: SAM.gov notices. naics, psc, agency, keywords, state, set_aside (HUBZone, WOSB, 8(a), Veteran, Small Business), notice_type (Solicitation, Combined Synopsis/Solicitation, Presolicitation, Sources Sought, Award Notice), posted_after, due_before, due_after, value_min, value_max, solicitation_number (exact: every notice in one procurement), content (Pro: words inside the attached documents), fields (comma-separated columns, e.g. "notice_id,title,response_deadline" for a cheap scan); sort_by: posted_date | due_date | award_amount | title | agency | relevance; sort_order: asc | desc
opportunity_changes: notices added or changed since a time. since (ISO timestamp, required); no other filters
forecasts: work agencies plan to buy. agency, naics, set_aside, state, est_award_fy, keywords, is_recompete, source (fco | dhs | hhs); sort_by: est_award_fy | est_solicitation_date | value_high | agency
award_notices: SAM.gov award announcements. awardee, uei, naics, agency, value_min, value_max, date_from, date_to
contracts: FPDS awards. naics, agency, uei, piid, award_type_code (A | B | C | D), date_from, date_to, amount_min, amount_max; sort_by: action_date | current_total_value_of_award | federal_action_obligation | recipient_name. Find a named vehicle's orders with parent_piid
vehicles: IDIQs, GWACs, GSA Schedules. Needs one of uei, piid, agency, naics, idv_type (IDC | FSS | BPA | GWAC | BOA); active_only, ceiling_min. No name search: find a vehicle's PIID via contracts or the notice
subawards: who subcontracts to whom. prime_uei, sub_uei, sub_name, naics, agency, piid, date_from, date_to, amount_min; sort_by: subaward_action_date | subaward_amount
recompetes (Pro): contracts ending soon. naics, agency, set_aside, state, ends_after_months, ends_within_months, date_anchor (current_end | potential_end), options_exhausted_only, amount_min, early_signal_days (1-365, default 180; 7-30 keeps the market-level early_signals short), early_signal_types; sort_by: ends_soonest | value | mod_churn | de_obligated
companies (Pro): firms with award history, by name. q (name, REQUIRED), naics, agency, naics_small. Ranking firms without a name ("who wins this work") is partners
entities: every SAM registration. q (name), naics, state, business_type (SAM code: "8W" WOSB, "QF" SDVOSB), naics_small (a NAICS the firm is SBA-small for), active_only
expiring_registrations (Pro): SAM registrations about to lapse. within_days, state, naics
partners (Pro): firms ranked by dollars won (FY2025 onward) in a NAICS, agency, state or PSC: who wins this work, the incumbents, teaming candidates. naics, agency, state, psc, keywords, set_aside (sdvosb | vosb | wosb | hubzone | 8a | sdb | minority_owned)
protests: GAO bid protests. agency, protester, status (Open | Closed), outcome (Denied | Dismissed | Sustained | Withdrawn), filed_from, filed_to; sort: recent | oldest | filed | due
exclusions: debarred or suspended parties. name, uei, cage_code
wage_determinations: type (SCA | DBA | CBA), state (2 letters), county, wd_number, active_only
wage_determinations_by_location: every determination for a place. state (2 letters, required), county, type
offices: contracting offices that buy a NAICS. naics (required); sort: biggest | most_open
Inputs: dataset (required), limit, offset, filters. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
The six tools have genuinely distinct roles: resolve maps names to IDs, search queries datasets, get fetches single records, and market/price/contact are analytics or people lookups. The descriptions actively disambiguate known overlap points (resolve(company) vs search(companies) vs get(entity); market/price vs search(contracts) with agency filters), though the heavy sub-action multiplexing inside each tool still leaves room for misselection between e.g. search(recompetes) and search(contracts) with date filters.
All six top-level tools are single lowercase words with no camelCase/snake_case mixing, which is predictable and readable. There is a minor stylistic split between verbs (resolve, search, get) and nouns (market, price, contact), and the sub-actions inside each tool follow a separate snake_case convention, but this is disclosed and consistent within itself.
Six tools is a well-scoped count for a broad federal procurement data API, and each dispatcher earns its place as a coherent category rather than a redundant wrapper. The tradeoff is that the real surface is 40+ sub-operations crammed into tool parameters, which is a lot of hidden complexity for six entries, but it is deliberate and documented.
Coverage is unusually broad for the domain: opportunities, forecasts, awards/FPDS, vehicles, subawards, recompetes, entities, exclusions, protests, wage determinations, market analytics, pricing benchmarks, labor rates and contacts. Gaps are minor — read-only by design, and there is no direct path from an opportunity to its Q&A/amendment history or a teaming/JV construct beyond partners and prime_subawards.
Maintenance
Related MCP Connectors
55 tools for federal/state/local RFPs, awards, vendors, contact graph, contract vehicles, pursuits.
Government contract search and federal procurement data: SAM.gov opportunities + USASpending awards.
Search U.S. federal, state, and local government procurement data and intelligence.
Search U.S. federal contract opportunities (RFPs, bids, awards) from SAM.gov official data.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceFederal procurement intelligence toolkit that searches SAM.gov contract opportunities, analyzes agency spending patterns, tracks competitor wins, and monitors small business set-aside programs (8a, HUBZone, SDVOSB, WOSB). 4 tools using SAM.gov and USASpending.gov data.3-
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to search federal contracts, analyze agency spending, track competitor wins, and monitor small business set-aside opportunities using SAM.gov, USASpending.gov, and FPDS data.1-
- AlicenseNot gradedqualityBmaintenanceFind federal contract opportunities, research awards and vendors, and review exclusion evidence with linked official sources. Public research is free and needs no account.MIT

AwardTape MCP Serverofficial
AlicenseNot gradedqualityCmaintenanceEnables searching and analyzing US defense contract obligations, expiring recompetes, power-grid interconnection queues, and supply-chain compliance screens, plus exporting custom relational datasets.MIT