GovCon API MCP server

Read from the package source without running it. The installed server may list more.

• _client
• check_exclusion

  Check the SAM.gov exclusions list (debarred / suspended entities).

• discover_offices

  Find which contracting offices buy a NAICS code, ranked, each with its own win-facts.

• find_naics_codes

  Discover NAICS codes by current federal spending and small-business set-aside leverage, use this when you don't already know which NAICS code to look at.

• get_company_awards

  Get the full paginated award history for one company (every individual award, not just the summary totals get_company_profile gives you).

• get_company_contact

  Resolve a vendor's REAL decision-maker contact, SAM registration agents (third-party filing services) are filtered out, so this is the actual point of contact at the company, not their SAM paperwork filer.

• get_company_peers

  Find companies similar to this one by NAICS + agency overlap, the competitive landscape around a firm, not its own history.

• get_company_profile

  Get one company's aggregate profile: SAM registration (legal name, address, NAICS, PSC, certifications) combined with award-history totals.

• get_contract

  Get one contract's LATEST transaction plus a roll-up of obligation/value totals across every modification.

• get_contract_modifications

  Get EVERY transaction row for a contract, oldest action first, the full modification trail (amendments, options exercised, partial terminations), not just the latest snapshot get_contract gives you.

• get_contract_vehicle

  Get the contract vehicle (IDIQ, GWAC, FSS schedule, or BPA) this order was placed against.

• get_entities_expiring

  Find SAM registrations expiring within N days, a monitoring/list question, distinct from a name lookup. A lapsed registration makes a firm invisible to contracting officers and ineligible for award, so this is useful both for self-monitoring and for spotting teammates/subs whose registration needs renewal.

• get_entity

  Get one SAM entity's full registration record by UEI or CAGE code, the same question, two different keys, so this is one tool, not two.

• get_labor_rate_benchmark

  Get the awarded labor-rate (should-cost) benchmark for a labor category, from GSA CALC, the labor-cost input for a proposal, paired with get_price_benchmark's contract-value read.

• get_naics_competition

  Get how contested a NAICS market is, over the whole FPDS prime-award market: offers received per award, single-bidder share, top place-of-performance states, award-volume trend by quarter, the share of recent winners holding only one or two awards (the long-tail signal that a market ISN'T locked up by incumbents), and the winner-cert socioeconomic mix (the dollar share going to firms holding each

• get_naics_leaderboard

  Browse curated, ranked NAICS market leaderboards, a fixed set of named rankings, distinct from find_naics_codes' open filtered search.

• get_naics_market

  Get the federal market profile for one NAICS code: spending, competition, set-aside leverage, top buyers, and top incumbents.

• get_naics_positioning

  Get the language and set-aside makeup for a NAICS code's SOLICITATION side: the phrase vocabulary contracting officers actually use in notices, the set-aside share of notices, and the top soliciting agencies, over the last 24 months of SAM opportunities.

• get_naics_simplified_acquisition

  Get the award-value breakdown for a NAICS code over the last 12 months of FPDS prime awards: counts of micro / simplified-acquisition / above-SAT awards, and which offices are making simplified-acquisition-band awards, with distinct-firm and set-aside counts for that band.

• get_office_profile

  Get one contracting office's full buying profile: obligations, competition, set-aside lean, and every NAICS it buys.

• get_opportunity

  Fetch a single contract opportunity by its notice_id.

• get_org_relationships

  Get JUST an organization's immediate children or its ancestor chain, without the rest of the record (get_organization already includes both if you need everything).

• get_organization

  Get one federal organization's full record, with its parent, immediate children, and full ancestor chain (root department down to immediate parent) all included in one call.

• get_price_benchmark

  Get the percentile distribution of comparable contract VALUE for a NAICS, broken out by pricing type. A price-analysis / market-range read for the Negotiate stage, not a win predictor. Factual, not scored.

• get_price_position

  Get where YOUR specific contract/bid value sits (percentile rank) against real comparable contracts, plus a sample of the nearest ones by value.

• get_prime_relationships

  Get every prime that has paid THIS company as a subcontractor, "who subcontracts to them," the opposite direction from get_prime_subawards.

• get_prime_subawards

  Get every subaward THIS company (as a prime) paid out, "who did they subcontract to."

• get_protests_on_solicitation

  Get every protest filed on ONE solicitation, the contestability read for a specific opportunity or award: any protest pending right now, and the statutory date GAO must decide by.

• get_recompete

  Get one recompeting/expiring contract by PIID, plus incumbent-vulnerability signals (cert-lapse, lone-holder, single-agency dependence) composed from the incumbent's DSBS certifications and FPDS obligation history.

• get_subaward

  Get one FFATA subaward report by its SAM report ID.

• get_vehicle

  Get one contract vehicle's detail: ceiling, period, and what's been ordered through it.

• get_vehicle_holders

  Get who holds a vehicle AND who's actually earning through it, two distinct populations, don't conflate them: a firm can hold a vehicle for years and earn nothing on it.

• get_vendor_risk_report

  Get a 7-signal vendor risk report for one UEI, screening facts for teaming or subcontracting due diligence, before you commit to a partner.

• get_wage_determination

  Get one wage determination's full record: location array, every classification's hourly wage + fringe, and (for CBAs) the contractor/union detail block.

• get_wage_rate_summary

  Get the labor-cost FLOOR for one occupation, aggregated across wage determinations: base hourly percentiles + Health & Welfare fringe + how many WDs set it, what a services bidder needs to price loaded labor, which on an SCA contract drives the bid far more than the award value.

• get_wage_rates

  Query prevailing-wage rates ACROSS wage determinations, by occupation, "what does a given trade actually pay," distinct from search_wage_determinations / get_wds_by_location which answer "which WDs apply."

• get_wds_by_location

  The compliance shortcut: "I'm bidding a contract in this state/county, which wage determinations apply?" Returns every currently-active DBA, SCA, and CBA record covering that jurisdiction.

• list_organizations

  Search the federal agency organization tree (~907 departments/agencies/offices).

• lookup_agency

  Resolve an agency acronym or partial name to canonical SAM.gov agency strings.

• main

  Entry point, runs the MCP server over stdio.

• recent_changes

  List opportunities added or updated since a timestamp.

• resolve_identifier

  Resolve between legacy DUNS (9 digits, or 13-digit DUNS+4) and current UEI (12 alphanumeric), accepts either side, returns both plus the entity name.

• search_awards

  Search SAM Award Notices (who won, how much, when), a SPARSE, self-reported subset of federal awards (~52K notices), NOT the comprehensive federal award record. ~60% of contractors here have only a single notice; a diversified contractor's real award book is usually much bigger than what shows here. For the comprehensive, authoritative award record (10.6M+ FPDS/USAspending transactions), use searc

• search_companies

  Search companies that have WON at least one federal award, by name, across both SAM Award Notices and FPDS prime contracts. For ALL registered SAM firms (won an award or not), use search_entities instead.

• search_contacts

  Look up a CONTRACTING OFFICER's contact info, the buyer side, distinct from get_company_contact (the vendor/teammate side).

• search_contracts

  Search FPDS prime contract transactions, the comprehensive, authoritative award record (10.6M+ transactions). For the sparse SAM Award Notice slice specifically, use search_awards instead (see its docstring for when that's actually the right tool).

• search_entities

  Search ALL SAM-registered entities by name (won a federal award or not). For companies that have actually WON an award, use search_companies instead, it has richer award-history fields; use this one when you need the full registry, including firms with no award history yet.

• search_forecasts

  Search agency procurement forecasts, the only FORWARD-LOOKING layer in this API. These are pre-solicitation: work an agency has planned but hasn't posted an opportunity for yet.

• search_opportunities
• search_partners

  Find teaming/partner firms with REAL past performance, by NAICS + agency + state + set-aside, who's actually done this kind of work, not just who's registered for it.

• search_protests

  Search GAO bid protests: who protested, on which solicitation, when, and the outcome.

• search_recompetes

  Find contracts entering recompete within a window, a market read for NEW business (who else's contract is about to be up for grabs), and also useful post-award to watch your OWN contract's expiration (see get_recompete for the single-contract form of that).

• search_subawards

  Search FFATA subawards: who primes paid as subcontractors.

• search_vehicles

  Search contract vehicles: IDIQs, GWACs, FSS schedules, BPAs, BOAs.

• search_wage_determinations

  Search Davis-Bacon (DBA), Service Contract Act (SCA), and CBA wage determinations by jurisdiction, number, or revision date.

• Code scan16 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenancelast push 20 days ago15/15
• Maintainer identityregistry namespace matches repository owner7/10

GovCon API: common questions

Is GovCon API MCP server safe?

Mostly: it is graded B (82/100). Read the GovCon API safety report

How do I install GovCon API?

It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.

Does GovCon API need an API key?

Yes. The registry entry asks for GOVCONAPI_KEY.

Is GovCon API maintained?

The last commit was 20 days ago (2026-08-31). The latest release is v0.2.3.