GOVCON MCP / TOOL REFERENCE
Every tool, with
inputs and examples.
What each GovCon MCP tool does, the inputs it takes, what it returns and an example of what to ask your agent.
Your agent sees these tools once you connect and sign in. Your G2X account determines which ones you can use.
Opportunities and events
g2x_calibrate_session
Calibrate this session: Call once at the start of a session, before searching.
Reads only
g2x_search_opportunities
Search G2X opportunities: Searches federal opportunities in G2X by keywords, with optional NAICS, fiscal year and posted or due date filters, and returns up to eight bounded rows with G2X record links.
Reads only
g2x_get_record
Get a G2X record: Read the public summary of a G2X opportunity or company, with a link to its record.
Reads only G2X AI results
g2x_search_supplementary
Search opportunities and attachments: Searches federal (SAM), state and local (SLED), DLA DIBBS, and SBIR/STTR opportunities together with the text inside their filed attachments — statements of work, specifications, Q&A.
Reads only
g2x_forecast_scan
Scan procurement forecasts: Finds agencies' published procurement forecasts — planned buys that are not open solicitations yet — filtered by agency acronym, NAICS, status, or fiscal year.
Reads only
g2x_recompete_radar
Recompete radar: Lists contracts ending in a window — yours or a competitor's — each with the open opportunities that could be its recompete, a confidence band, and the reasons it matched.
Reads only
g2x_expiring_awards
List expiring awards: Lists contract or IDV awards whose period of performance ends in a window — give expiry_fiscal_year or pop_end_date_range — scoped by agency, NAICS/PSC, dollar floor, or recipient UEI.
Reads only
g2x_search_events
Search GovCon events: Searches upcoming events on the G2X calendar — conferences, industry days, matchmaking and agency events — by words in the title, organizer or location, start-date window, US state, or virtual format.
Reads only
g2x_get_event
Read a GovCon event: Reads one event on the G2X calendar by its slug: dates, where it is held, organizer, registration link, the event write-up's summary, the speakers it names, and how many agenda days and sponsors it lists, with the event's G2X page.
Reads only
Market research
g2x_search_records
Search G2X procurement records: Searches one G2X dataset — contract awards, IDVs, subawards, OTAs, contract vehicles, protests (COFC/GAO/SBA dockets), forecasts, grants, notices, agencies, NAICS/PSC — and returns bounded rows with G2X record links, result totals, and coverage notes.
Reads only
g2x_query
Query G2X procurement data: Runs one query over G2X's own procurement data — awards, opportunities, contract vehicles, bid protests — with the verbs list, search, get, count and, for awards, aggregate.
Changes your account
g2x_vehicle_usage
Analyze a contract vehicle: Shows how a contract vehicle is used in G2X's award data — contract holders on record, task orders and money obligated on them — found by name, program acronym, solicitation number or vehicle ID.
Reads only
g2x_labor_rates
Published labor rates: Find published hourly ceiling rates by category and filters, or by company UEI.
Reads only
g2x_nsn_lookup
Look up an NSN: Returns what one National Stock Number is: the item, its federal supply class, the part numbers it is known by with the CAGE supplier behind each, and, when DLA cancelled or reclassified the NSN, the items that replaced it.
Reads only
g2x_nsn_search
Search the supply catalog: Finds NSNs by item name, by part number, or by a supplier's CAGE code.
Reads only
Companies and relationships
g2x_search_companies
Search G2X companies: Searches G2X's company directory by company name or 12-character SAM UEI.
Reads only
g2x_get_graph_neighborhood
Get linked G2X relationships: Returns a company's one-hop public contracting relationships from the G2X Company Graph: awards it won and companies it subcontracted with, each with a G2X record link.
Reads only
g2x_company_contract_history
Company contract history: Returns a company's federal contracting portfolio by UEI: prime award counts, IDV awards it holds, associated contract vehicles, and — with expiring_within_days — the awards ending soonest.
Reads only
g2x_teaming_partners
Find teaming partners: Finds companies with proven past performance in a NAICS — potential partners for a pursuit, ranked by awards in that code and carrying their set-aside certifications.
Reads only
g2x_socioeconomic_status
Company certifications: Returns a company's SAM socioeconomic certifications by UEI — 8(a), SDVOSB, HUBZone, WOSB and similar — plus its registration purpose.
Reads only
g2x_company_signals
Company signals from the public web: Recent public web and news signals about a company — announcements, teaming and partnership news, leadership moves, acquisitions — with a link to each source.
Reads only
g2x_company_web_profile
Company public page and recent posts: A company's own public page — tagline, followers, website — and its most recent public posts, each linked.
Reads only
Documents and analysis
g2x_opportunity_documents
List an opportunity's source documents: Lists the opportunity's source documents on file in G2X — solicitation, attachments, amendments — with each document's category, readiness, version and whether its text can be read.
Reads only
g2x_opportunity_attachment_text
Read an opportunity document: Returns the complete text of an opportunity document already on file in G2X — solicitation, statement of work, amendment — as Markdown (the stored parse, byte for byte) or as structured JSON (every page with its text and elements).
Reads only
g2x_prepare_opportunity_documents
Prepare an opportunity's documents: Opens (or creates) your G2X workspace for an opportunity and prepares its source documents for analysis, then lists them.
Changes your account Uses G2X AI
g2x_shred_opportunity
Extract requirements from an opportunity: Reads the opportunity's full document set — solicitation, attachments, amendments — and extracts typed, cited requirements (what the offeror must do, submit, or meet) with their family, kind, and source location.
Changes your account Uses G2X AI
g2x_qualify_opportunity
Run a Bid/No-Bid qualification: Starts G2X's quick Bid/No-Bid analysis for an opportunity against your company profile and returns a run identifier.
Changes your account Uses G2X AI
g2x_get_analysis_run
Check an analysis run: Reports a capture run's status and, once it completes, its results — extracted requirement counts, the compliance matrix totals, and for a Bid/No-Bid run the scored verdict with dimensions, blockers, risks, and supporting evidence.
Reads only G2X AI results
g2x_compliance_matrix
Get a compliance matrix: Reads the compliance matrix a requirements run produced: one row per extracted requirement with its status (met, partial, missing), the evidence it needs, citations to the source documents, and which proposal sections cover it.
Reads only G2X AI results
GovCon CRM
g2x_crm_find
Find in my G2X CRM: Searches the signed-in user's G2X CRM for accounts and contacts by name, UEI, website, email, or G2X id, and returns each match with its G2X id and the fields that tell records apart, how many records match, and which fields were searched.
Reads only
g2x_crm_get_record
Read a G2X CRM record: Reads one account or contact from the signed-in user's G2X CRM as G2X shows it now: its fields, next step, people or account, linked pursuits, and latest notes.
Reads only
g2x_crm_save_account
Save an account to my G2X CRM: Adds an organization to the signed-in user's G2X CRM, or updates one they have; only the fields given change.
Changes your account
g2x_crm_save_contact
Save a contact to my G2X CRM: Adds a person to the signed-in user's G2X CRM, or updates one they have; only the fields given change, and a new email or phone is added to the person.
Changes your account
g2x_crm_add_note
Add a note in my G2X CRM: Adds a relationship note to an account or contact in the signed-in user's G2X CRM, written as the user; it shows on the record's notes and timeline.
Changes your account
g2x_crm_log_interaction
Log a call or meeting in my G2X CRM: Records a call, meeting, email, or event that already happened as one note on the account and on each person involved, and moves each person's last-contacted date forward.
Changes your account
g2x_crm_set_follow_up
Set the next step in my G2X CRM: Sets the next step on an account or contact in the signed-in user's G2X CRM, replacing the current one.
Changes your account
g2x_crm_add_task
Add a task to a pursuit: Adds a task, assigned to the signed-in user, to one of their G2X pursuits; it shows on the pursuit and on the timeline of the account it is linked to.
Changes your account
Watchlists, searches and pipelines
g2x_watch_records
Watch G2X records: Adds up to five opportunities or companies, each identified by the id and title G2X returned, to the signed-in user's G2X watchlist.
Changes your account
g2x_unwatch_records
Stop watching G2X records: Removes up to ten records from the signed-in user's G2X watchlist.
Changes your account
g2x_list_watchlist
List the G2X watchlist: Lists the records on the signed-in user's G2X watchlist, optionally one record kind, with G2X links.
Reads only
g2x_save_search
Save a G2X search: Saves a search as one of the signed-in user's Saved Views on a G2X list page (contracts, SAM.gov opportunities, grants, forecasts, IDVs, vehicles), using that page's own filter keys.
Changes your account
g2x_list_saved_searches
List G2X saved searches: Lists the signed-in user's Saved Views, newest first, optionally for one list page, with each view's filters and G2X link.
Reads only
g2x_update_saved_search
Update a G2X saved search: Changes a Saved View's name, filters or updates.
Changes your account
g2x_run_saved_search
Run a G2X saved search: Runs one of the signed-in user's Saved Views the way its page does, with today's clock, and returns the page's rows with G2X record links plus the view's own page in G2X.
Reads only
g2x_list_pipelines
List G2X pipelines: Lists pipelines with their stages, owner and edit rights.
Reads only
g2x_get_pipeline
Read a G2X pipeline: Reads one pipeline as the signed-in user sees it: its items with their stage, agency, value, last_changed (the last change to the item, not necessarily a stage move), when it moved to its current stage and G2X links, a page at a time; pass next_cursor until it is null to read every item.
Reads only
g2x_add_to_pipeline
Add records to a G2X pipeline: Adds up to ten G2X records (or pursuits by name) to one of the signed-in user's pipelines, into a stage named by id or name.
Changes your account
g2x_move_pipeline_item
Move a G2X pipeline item: Moves a pipeline item to a stage named by id or name.
Changes your account
g2x_add_pipeline_note
Add a note to a G2X pipeline item: Adds a note to a pipeline item, authored by the signed-in user.
Changes your account
g2x_list_pipeline_notes
List a G2X pipeline item's notes: Lists the notes on one pipeline item, newest first, with their authors.
Reads only
g2x_remove_from_pipeline
Remove a G2X pipeline item: Removes an item from a pipeline (the pipeline entry only; the G2X record stays).
Changes your account
g2x_create_pipeline
Create a G2X pipeline: Creates a pipeline owned by the signed-in user, as G2X's Create pipeline does: it gets the default stages a new G2X pipeline gets, or the named stages from the account's stage list.
Changes your account
g2x_delete_pipeline
Delete a G2X pipeline: Deletes one of the signed-in user's pipelines and every item on it, as G2X's Delete pipeline does; the G2X records themselves stay.
Changes your account
Your account
g2x_list_ai_profiles
List my G2X AI profiles: Lists the signed-in user's G2X AI profiles: each one's id, name, the company it represents, UEI and CAGE when linked, its bidding name when one is set, whether it is their default, whether it is shared with their team, which of the five Bid/No-Bid readiness sections are complete and which are missing, and its page in G2X.
Reads only
g2x_get_ai_profile
Read a G2X AI profile: Reads one of the signed-in user's G2X AI profiles in full, by its id from g2x_list_ai_profiles: every field g2x_update_ai_profile can change, by the same names, which fields are empty, readiness for Bid/No-Bid, and whether the user can edit it.
Reads only
g2x_create_ai_profile
Create a G2X AI profile: Creates a new G2X AI profile owned by the signed-in user in their G2X account, as Settings > AI profiles does: for example one per legal entity, or one per market or subvertical.
Changes your account
g2x_update_ai_profile
Update a G2X AI profile: Changes the named fields of one of the signed-in user's G2X AI profiles; fields not named keep their values, a list replaces the whole list, and null clears a field.
Changes your account
g2x_list_my_company_profiles
List my claimed company profiles: Lists the claimed company profiles on the signed-in user's G2X account: each company's UEI and name, its public page in the GovCon Directory, the current value of each field its owner can change (description, employee_count, website, careers_url, jobs_publication_opt_out, dba_name), which are empty, and whether the account's plan lets the owner edit them.
Reads only
g2x_update_my_company_profile
Update my claimed company profile: Changes the named fields of a claimed company profile the signed-in user's account owns, by its UEI from g2x_list_my_company_profiles: description, employee_count, website, careers_url, jobs_publication_opt_out and dba_name.
Changes your account
g2x_usage
Your G2X usage: How much of your G2X Lumen usage this session and this week is used, and when each resets — the same meter the product shows.
Reads only