Skip to main content
Glama
GovCon API MCP

GovCon API MCP

Official

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
GOVCONAPI_KEYYesYour GovCon API key. Must start with 'gca_' (e.g., gca_your_key_here).

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
resolveA

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 agency value search filters expect

  • naics: 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

searchA

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

getA

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 options takes 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}.

marketA

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)

priceA

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

contactA

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

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.2/5.0

Scored across 6 tools

Disambiguation4/5

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.

Naming Consistency4/5

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.

Tool Count4/5

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.

Completeness4/5

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

ActivityMaintained
ResponsivenessNo recent community issues