G2XGovCon MCPCreate G2X account

GOVCON MCP / DEVELOPER GUIDE

Connect your agent
to G2X.

The intelligence layer for GovCon growth. One hosted endpoint for G2X research and the account actions available to your agent.

Quickstart

You need a G2X account; review G2X plans.

  1. Add https://mcp.g2x.com/mcp to your agent as a remote MCP server. Find your agent's steps.
  2. Sign in with your G2X account when your agent asks.
  3. Ask “Look up [Company Name or UEI] in G2X.”

Installing the agent skill does not connect or authorize your account.

Add the GovCon MCP skill for guidance on choosing tools, keeping citations and completing account workflows.

Sign in before tool discovery: tools/list and every data or tool call require an authenticated G2X account. The transport is stateless, so do not depend on a server session ID.

Official integrations

G2X's own listings on other platforms.

G2X in ChatGPT

G2X's official plugin in ChatGPT, published in ChatGPT's plugin directory.

  1. Open G2X in ChatGPT's plugin directory.
  2. Choose Install plugin.
  3. Sign in with your G2X account when ChatGPT asks.

A G2X account is required. Every G2X plan works, including the free Community Edition.

G2X in ChatGPT's plugin directory

G2X GovCon Growth OS (Grok Bot)

G2X's own bot, published on xAI's Grok Bot.

  1. Open G2X GovCon Growth OS on x.ai.
  2. Choose Add to Grok Bot, then finish in the Grok Bot app.
  3. When Grok Bot prompts you to connect G2X, sign in with your G2X account to approve.

G2X GovCon Growth OS on x.ai

G2X on Vercel Connect

G2X's connector on Vercel Connect, for the apps and agents you deploy on Vercel.

  1. Open G2X on Vercel Connect and choose Create Connector, or run vercel connect create g2x in your linked project.
  2. In your app, request a G2X token for each signed-in user with the Vercel Connect SDK. The first time, send the user to sign in with their G2X account.
  3. Use the token with your MCP client at https://mcp.g2x.com/mcp.

Each user needs a G2X account. Every G2X plan works, and each user's plan sets what G2X returns.

G2X on Vercel Connect

Connect via MCP

Every agent that supports MCP connects to G2X: add https://mcp.g2x.com/mcp and sign in with your G2X account. Pick your agent for its steps.

Tested: a working G2X connection is on record. Steps checked: the steps follow the agent's own guide.

ChatGPT

Steps checked

ChatGPT is an AI agent. Install the G2X plugin from ChatGPT's plugin directory, or add G2X yourself as a custom MCP server.

The quickest way: G2X's official plugin, published in ChatGPT's plugin directory.

  1. Open G2X in ChatGPT's plugin directory.
  2. Choose Install plugin.
  3. Sign in with your G2X account when ChatGPT asks.

A G2X account is required. Every G2X plan works, including the free Community Edition. What ChatGPT can see and do follows your G2X account's permissions.

Or add G2X yourself as a custom MCP server:

  1. In ChatGPT on the web, go to chatgpt.com/plugins, choose +, then Add custom MCP server. If ChatGPT asks, turn on Developer mode first.
  2. Enter G2X as the name. Under Connection, enter https://mcp.g2x.com/mcp as the Server URL. For Authentication, choose the sign-in option.
  3. Read the warning, choose I understand and want to continue, then choose Create as a plugin.
  4. Open your personal plugins at chatgpt.com/plugins?view=personal, open G2X and choose + to install it. If you created it in a workspace, it's in that workspace's plugins.
  5. Sign in with your G2X account when ChatGPT asks.

In a Business, Enterprise or Edu workspace, your admin turns on plugins with MCP servers, and then Add custom MCP server appears.

Steps checked against G2X in ChatGPT's plugin directory and the ChatGPT guide to connecting a server.

ChatGPT setup page

Claude

Tested

Claude is Anthropic's AI agent. You add G2X once as a custom connector.

  1. In Claude, open Customize → Connectors.
  2. Choose + Add, then Add custom connector.
  3. Enter G2X as the name and https://mcp.g2x.com/mcp as the server URL, then choose Continue until Claude shows its sign-in settings.
  4. Keep Sign in now, choose Register automatically, then choose Add. If Claude shows Advanced settings instead, leave the client ID and client secret blank and choose Add.
  5. If Claude shows Connect, choose it. Sign in with your G2X account.
  6. Choose Allow to connect your account to Claude.
  7. In a new chat, choose +, then Connectors, and turn on G2X. Ask “Look up [Company Name or UEI] in G2X.” If Claude asks to use a G2X tool, review the request and choose Allow once.

On the Free plan you can add one custom connector. On a Team or Enterprise plan, an owner adds G2X once in Organization settings → Connectors (Add → Custom → Web), with the same name, address and sign-in settings. Everyone else then opens Customize → Connectors, finds G2X and chooses Connect.

Claude setup page

Grok Bot

Steps checked

Grok Bot is an AI agent on the web and on iOS and Android. You add G2X once as a custom connector.

  1. Go to grok.com/connectors. In the mobile app, open Settings → Connectors.
  2. Choose New Connector, then Custom.
  3. Paste https://mcp.g2x.com/mcp and sign in with your G2X account.

On a business or enterprise account, an admin sets up the connector for your team first.

Steps checked against the Grok Bot connectors guide.

Grok Bot setup page

Microsoft Copilot

Steps checked

Microsoft Copilot uses G2X through Microsoft 365, with a work or school account. A Copilot Studio maker adds G2X to an agent, and people in your organization use that agent in Microsoft Copilot.

Add G2X to a Copilot Studio agent

  1. In Copilot Studio, open your agent and go to Tools. Choose Add a tool → New tool → Model Context Protocol.
  2. Enter G2X as the server name, a short description, and https://mcp.g2x.com/mcp as the server URL.
  3. For authentication, choose the sign-in option, then Dynamic discovery. Choose Create.
  4. Choose Create a new connection, sign in with your G2X account, then choose Add to agent.
  5. Publish the agent to the Teams and Microsoft 365 channel, so people can use it in Microsoft Copilot.

Microsoft 365 admins can also add MCP servers for the whole organization as connectors in the Microsoft 365 admin center. The Copilot app for a personal Microsoft account connects only to a fixed list of services, such as OneDrive and Gmail. It can't add G2X.

Steps checked against Microsoft's guide to adding an MCP server to an agent and Microsoft's guide to connecting Copilot to other services.

Microsoft Copilot setup page

Gemini

Steps checked

Gemini is Google's AI agent. Add G2X to the Gemini app on the web, or to Gemini CLI in your terminal.

Gemini app

  1. On gemini.google.com, open Settings, then Connected Apps.
  2. Under Custom apps, choose Add a custom app and paste https://mcp.g2x.com/mcp.
  3. Choose Next, then sign in with your G2X account.

Google offers custom apps to personal Google Accounts of people 18 or older in the US, using Gemini in English with Keep Activity on.

Gemini CLI

gemini mcp add --transport http govcon https://mcp.g2x.com/mcp
  1. Gemini CLI finds the G2X sign-in on its own. Sign in with your G2X account when it asks.

Steps checked against Google's help on custom apps in Gemini and the Gemini CLI guide to MCP servers.

Gemini setup page

Notion

Steps checked

Notion's AI agents can use G2X on Notion's Business and Enterprise plans. Add G2X to your Notion Agent, or to a Custom Agent your team shares.

Notion Agent

  1. In Notion, open Settings → Connections and choose the Discover tab.
  2. Choose Add Custom MCP and paste https://mcp.g2x.com/mcp.
  3. Sign in with your G2X account when Notion asks.

Custom Agents

  1. Open the agent's Settings and go to Tools & Access.
  2. Choose Add connection → Custom MCP server.
  3. Paste https://mcp.g2x.com/mcp as the server URL, enter G2X as the display name, then choose Connect.
  4. Sign in with your G2X account when Notion asks.

A workspace admin turns on custom MCP servers first, under Settings → Connections → Manage.

Steps checked against Notion's guide to MCP servers for your Notion Agent and Notion's guide to MCP connections for Custom Agents.

Notion setup page

Muse

Steps checked

Muse Code is Meta's AI coding agent. You add G2X to its settings file, then sign in.

Muse Code

Add G2X to the mcp_servers block of ~/.config/muse/settings.json:

{
  "mcp_servers": {
    "govcon": {
      "transport": "streamable_http",
      "url": "https://mcp.g2x.com/mcp",
      "enabled": true
    }
  }
}
  1. Run muse mcp login govcon and sign in with your G2X account in your browser.

The G2X connector for the Muse app is anticipated to be live soon.

Steps checked against Muse Code's guide to MCP servers.

Muse setup page

Cursor

Steps checked

Cursor is an AI code editor. You can add G2X in one click.

Add G2X to Cursor

  1. Choose Add G2X to Cursor. Cursor opens to add the G2X server, named govcon.
  2. When Cursor opens your browser, sign in with your G2X account.

Add it by hand

Add G2X to ~/.cursor/mcp.json for all your projects, or to .cursor/mcp.json in one project:

{
  "mcpServers": {
    "govcon": {
      "url": "https://mcp.g2x.com/mcp"
    }
  }
}

Steps checked against Cursor's guide to MCP install links and Cursor's MCP guide.

Cursor setup page

Zapier

Steps checked

Zapier connects your apps in automated workflows called Zaps. Its MCP Client app, in beta, connects G2X.

  1. In Zapier, open Apps, choose Add connection, and search for MCP Client.
  2. Paste https://mcp.g2x.com/mcp as the server URL and choose Streamable HTTP.
  3. For the sign-in setting, choose Yes.
  4. Choose Continue and sign in with your G2X account.
  5. Use MCP Client actions in your Zaps to call G2X.

Steps checked against Zapier's MCP Client guide.

Zapier setup page

Devin

Steps checked

Devin is an AI software engineer. An organization admin adds G2X once for the team.

Devin

  1. Open Customize → MCPs and choose Add custom MCP.
  2. Enter G2X as the name, choose HTTP as the transport, and paste https://mcp.g2x.com/mcp.
  3. For authentication, choose the sign-in option, for the whole organization or for each person. Then sign in with your G2X account.

Devin CLI

devin mcp add govcon https://mcp.g2x.com/mcp
devin mcp login govcon
  1. Sign in with your G2X account when Devin CLI asks.

Devin Desktop

Devin Desktop, formerly Windsurf, reads its servers from an MCP config file.

  1. In the Cascade panel, open the … menu and choose Open MCP config file.
  2. Add a server named govcon with serverUrl set to https://mcp.g2x.com/mcp, then save the file.
  3. Sign in with your G2X account when Devin Desktop asks.

Steps checked against Devin's MCP guide, the Devin CLI MCP guide and the Devin Desktop MCP guide.

Devin setup page

Claude Code

Steps checked

Claude Code is Anthropic's AI coding agent for your terminal. You add G2X with one command.

claude mcp add --transport http govcon https://mcp.g2x.com/mcp
  1. In Claude Code, type /mcp, choose govcon and sign in with your G2X account in your browser.

Steps checked against the Claude Code guide to MCP.

Claude Code setup page

VS Code

Steps checked

VS Code is Microsoft's code editor. Its chat, including GitHub Copilot, can use G2X once you add the G2X server. You can add it in one click.

Install G2X in VS Code

  1. Choose Install G2X in VS Code. Or run MCP: Add Server from the Command Palette, choose HTTP, paste https://mcp.g2x.com/mcp and name it govcon.
  2. When VS Code opens your browser, sign in with your G2X account.

If your organization uses GitHub Copilot Business or Enterprise, an admin turns on the MCP servers in Copilot policy first.

Steps checked against VS Code's MCP guide and GitHub's guide to MCP in Copilot Chat.

VS Code setup page

OpenAI Codex

Steps checked

Codex is an AI coding agent. The Codex CLI, the Codex IDE extension and the ChatGPT desktop app share one setup, so you add G2X once.

Codex CLI

codex mcp add govcon --url https://mcp.g2x.com/mcp
codex mcp login govcon
  1. codex mcp login govcon opens your browser. Sign in with your G2X account.

Codex in the app or your editor

  1. In the ChatGPT desktop app or the Codex IDE extension, open Settings → MCP servers → Add server.
  2. Choose Streamable HTTP and paste https://mcp.g2x.com/mcp.
  3. Choose Authenticate and sign in with your G2X account, then restart the app.

Steps checked against the Codex guide to MCP.

OpenAI Codex setup page

Perplexity

Steps checked

Perplexity is an AI answer engine. You add G2X once as a custom remote connector.

  1. Open Account settings → Connectors and choose + Custom connector.
  2. Choose Remote.
  3. Enter G2X as the name and https://mcp.g2x.com/mcp as the MCP server URL.
  4. For Authentication, choose the sign-in option. For Transport, choose Streamable HTTP.
  5. Check the acknowledgement box and choose Add.
  6. Choose the G2X card to sign in with your G2X account and turn the connector on.

On Perplexity Enterprise, members add custom connectors after an admin allows it.

Steps checked against Perplexity's guide to custom remote connectors.

Perplexity setup page

Le Chat

Steps checked

Le Chat is Mistral AI's agent. An admin adds custom connectors. On Free, Pro and Student plans, the account owner is the admin.

  1. Open the Connectors page and choose + Add Connector.
  2. Choose the Custom MCP Connector tab.
  3. Enter g2x as the name, with no spaces, and paste https://mcp.g2x.com/mcp.
  4. Choose Connect. Le Chat finds the G2X sign-in on its own.

Steps checked against Mistral's guide to MCP connectors in Le Chat.

Le Chat setup page

Manus

Steps checked

Manus is an AI agent that works through tasks for you. You add G2X once as a custom MCP server.

  1. Open Settings → Integrations → Custom MCP Servers and choose Add Server.
  2. Enter G2X as the name, paste https://mcp.g2x.com/mcp, and add the server.

Steps checked against Manus's guide to custom MCP servers.

Manus setup page

Factory

Steps checked

Droid is Factory's AI coding agent. You add G2X to it from your terminal.

droid mcp add govcon https://mcp.g2x.com/mcp --type http
  1. In Droid, type /mcp and choose govcon.
  2. Sign in with your G2X account when your browser opens.

Steps checked against Factory's MCP guide.

Factory setup page

n8n

Steps checked

n8n is a workflow automation tool. Its MCP Client nodes connect G2X to a workflow or to an AI Agent.

  1. Add an MCP Client node to your workflow, or an MCP Client Tool node to an AI Agent.
  2. Choose the streamable HTTP transport and paste https://mcp.g2x.com/mcp as the MCP endpoint URL.
  3. For Authentication, create an MCP sign-in credential with Dynamic Client Registration turned on.
  4. Sign in with your G2X account.

Steps checked against n8n's MCP Client node guide and n8n's MCP credentials guide.

n8n setup page

Make

Steps checked

Make is a visual automation platform. Its MCP Client module connects G2X to a scenario.

  1. Add the MCP Client module to a scenario and choose Create a connection.
  2. Choose + New MCP Server and paste https://mcp.g2x.com/mcp.
  3. If Make asks how to sign in, choose the sign-in option. Save the connection.
  4. Sign in with your G2X account.

Steps checked against Make's MCP Client guide.

Make setup page

Replit

Steps checked

Replit Agent builds apps for you. You add G2X once as an MCP server.

Add G2X to Replit

  1. Choose Add G2X to Replit, finish the install in Replit, and sign in with your G2X account when Replit asks.
  2. Or go to replit.com/integrations, scroll to MCP Servers for Replit Agent and choose + Add MCP server. Enter G2X as the name, paste https://mcp.g2x.com/mcp, then choose Test & save and sign in with your G2X account.

Steps checked against Replit's guide to connecting via MCP and Replit's guide to MCP install links.

Replit setup page

Hermes Agent

Steps checked

Hermes Agent is an open-source AI agent from Nous Research.

Option A: commands

Run these in your terminal:

hermes config set mcp_servers.govcon.url https://mcp.g2x.com/mcp
hermes config set mcp_servers.govcon.auth oauth
hermes config set mcp_servers.govcon.oauth.cimd false
hermes mcp login govcon

The last command opens your browser so you can sign in.

Option B: edit config.yaml

Open ~/.hermes/config.yaml and add G2X under mcp_servers:

mcp_servers:
  govcon:
    url: "https://mcp.g2x.com/mcp"
    auth: oauth
    oauth:
      cimd: false
  1. Save the file. Then, in a new terminal window, run hermes mcp login govcon.

Steps checked against Hermes Agent's MCP guide and MCP config reference.

Hermes Agent setup page

Any agent via MCP

Other agents need to support remote MCP servers with sign-in. Add https://mcp.g2x.com/mcp as a remote MCP server, then sign in with your G2X account when your agent asks.

Authentication

Use G2X OAuth in clients that support it. Without G2X sign-in, tools/list and every tool call return HTTP 401 with a WWW-Authenticate header that links the OAuth protected-resource metadata. Follow the advertised authorization server's authorization-code flow with PKCE S256.

Claude connects with the server URL alone. Every agent under Connect via MCP follows its own steps to the same sign-in. A G2X API key is not a replacement for this sign-in flow. Keep credentials in the client's connection settings, never in a URL or a prompt.

Every tool requires authentication. Your account determines access and allowances. Signing in never grants access to another account's watchlist, workspace or analysis.

Tool catalog

MCP tools/list is the authoritative source for input schemas, descriptions and annotations. Read the schema before constructing arguments. Record IDs must come from search results.

Every tool, with inputs and examples

g2x_calibrate_session

Match the session to the company profile you claimed in G2X, or learn what to tell your agent instead.

g2x_search_opportunities

Search current and past federal opportunities by keywords, NAICS, fiscal year and dates, or keep only notices with documents G2X has read. Each notice links to its G2X page where G2X has one.

g2x_search_records

Search government contracting records across supported datasets.

g2x_search_supplementary

Search SAM, state and local, DIBBS, and SBIR/STTR opportunities with supporting document passages.

g2x_opportunity_attachment_text

Return the complete text of an opportunity document on file, as Markdown or structured JSON, in exact chunks with a cursor to the next byte. Read one page instead when you ask for it.

g2x_get_record

Retrieve a record using its G2X identifier.

g2x_forecast_scan

Explore forecasts for upcoming procurement.

g2x_recompete_radar

Identify potential follow-on contract opportunities.

g2x_expiring_awards

Research awards approaching the end of their term.

g2x_search_companies

Search contractors by name.

g2x_company_contract_history

Research a company's contract history.

g2x_teaming_partners

Research potential partners for your pursuit.

g2x_vehicle_usage

Explore use of a contract vehicle.

g2x_socioeconomic_status

Review a company's socioeconomic classifications.

g2x_search_events

Search upcoming conferences, industry days and agency events on the G2X calendar by topic, dates, state or format.

g2x_get_event

Review one event's dates, location, organizer, registration link, speakers and G2X page.

g2x_watch_records

Save records to your signed-in G2X account.

g2x_company_signals

Find company news and social activity. Your G2X account access applies.

g2x_company_web_profile

Read public company profile information and posts. Your G2X account access applies.

g2x_opportunity_documents

List the documents on file for an opportunity with their readiness and version, and links to the G2X copy of each file and its parsed Markdown or JSON where they exist, without starting anything.

g2x_prepare_opportunity_documents

Open your workspace for an opportunity and prepare its documents for analysis.

g2x_shred_opportunity

Start a requirements extraction from selected documents.

g2x_qualify_opportunity

Start a qualification against your company profile.

g2x_compliance_matrix

Retrieve the compliance matrix from a qualification run.

g2x_get_analysis_run

Retrieve the status and results of your analysis run.

g2x_nsn_lookup

Find an exact National Stock Number in the federal supply catalog.

g2x_nsn_search

Find federal supply items by description and supported classifications.

g2x_crm_find

Find accounts and contacts in your G2X CRM.

g2x_crm_get_record

Review an accessible account or contact before making a change.

g2x_crm_save_account

Create or update a company account in your G2X CRM.

g2x_crm_save_contact

Create or update a contact in your G2X CRM.

g2x_crm_add_note

Add the requested context to an accessible CRM record.

g2x_crm_log_interaction

Record a meeting or interaction in your G2X CRM.

g2x_crm_set_follow_up

Set the next follow-up on an accessible CRM record.

g2x_crm_add_task

Create a task linked to your CRM work.

g2x_unwatch_records

Remove selected records from your watchlist.

g2x_list_watchlist

List watched records in your G2X account.

g2x_save_search

Save a supported query and its filters to your account.

g2x_list_saved_searches

List the searches saved in your account.

g2x_update_saved_search

Change selected saved-search fields.

g2x_run_saved_search

Run an accessible saved search and inspect its results.

g2x_list_pipelines

List pipelines accessible to your account.

g2x_get_pipeline

Inspect an accessible pipeline and its items.

g2x_add_to_pipeline

Add selected records to a G2X pipeline.

g2x_move_pipeline_item

Move a selected pipeline item to an available stage.

g2x_add_pipeline_note

Record context on a selected pipeline item.

g2x_list_pipeline_notes

Read notes on an accessible pipeline item.

g2x_remove_from_pipeline

Remove a selected pipeline item without deleting the source record.

g2x_create_pipeline

Create a pipeline in your account, ready for pursuits.

g2x_delete_pipeline

Delete a pipeline you own and its items without deleting the source records.

g2x_list_ai_profiles

List the G2X AI profiles in your account, with readiness and the name each one bids under.

g2x_get_ai_profile

Review everything a G2X AI profile tells Lumen and Bid Hub about your company.

g2x_create_ai_profile

Add a G2X AI profile for another entity or market, with its own bidding name.

g2x_update_ai_profile

Improve a G2X AI profile you can edit, including the name you bid under.

g2x_list_my_company_profiles

See the public GovCon Directory profiles your account claimed, and what their owner can change.

g2x_update_my_company_profile

Keep your company's public description, headcount, website and careers page current.

g2x_usage

See how much of your G2X Lumen usage is used this session and this week, and when each resets.

g2x_search_government_people

Find government buyers and points of contact named on federal notices. Search names, listed titles and roles, or offices; filter by agency, office, NAICS, product/service code, set-aside or state. Or find buyers by exact email address (up to 25 at once); addresses that match no one are listed. Returns notice-listed contact details and notice counts. Follow next_cursor with the same filters for more buyers. Requires G2X Starter or above.

g2x_get_government_person

Read a government buyer by the person ID from government buyer search: notice-listed contact details, dated offices, buying patterns, office awards, coworkers and notices. Each person read uses Lumen usage; a missing person and further notices pages do not. The notices page returns at most 25; pass next_cursor as notices_cursor for more. Each notice lists its G2X page link where G2X has a page for it; the link accompanies the notice. Requires G2X Starter or above.

g2x_query

Reads G2X procurement data with list, search, get, count and awards aggregate. Use "help" for sources and "<source> --help" for filters. Large results are cut inline and never saved. To save a workbook, explicitly use the separate save action. It also reads BLS OEWS occupational wages: wages get 15-1252 --area national. It also reads GSA per diem rates (CONUS, by fiscal year): per-diem rates --state AL --city Huntsville, or --zip 35739. It also reads Federal Register documents since 1994: federal-register search "limitations on subcontracting", federal-register list --published 2026-09-18 --type proposed-rule, or federal-register cfr 52.204-27 for a section's source-note citations (a full revision restarts the note). For one award, awards actions <award key or PIID> lists its contract actions (the base award and each modification) with their dates, modification numbers and obligation changes.

g2x_save_query_workbook

Runs a list or search command and saves all fetched records as a workbook in your G2X account. This explicit action creates a new file. Use the separate read-only query to read without saving.

g2x_resolve

Use this when you have a PIID, award key, SAM UEI, solicitation number, notice id or company name and need the canonical id and the record_id the record read takes. Hyphens and spaces in a PIID are accepted. Do not use for keyword, agency or NAICS searches: use the procurement records search. Examples: {"query":"M67854-22-D-8001"}; {"query":"Meridian","kind":"company"}.

g2x_get_award

Use this when you need one federal award's facts by PIID or award key: holder (name, UEI, parent), awarding and funding agency, obligated, current value, ceiling (base and all options), current and potential end dates and an IDV's ordering end, each with its source. Do not use for finding awards (use the procurement records search) or an IDV's orders (use the IDV summary). Examples: {"identifier":"ZZ0001-26-D-0042"}, {"identifier":"CONT_AWD_ZZ000125C0107_9700_-NONE-_-NONE-"}.

g2x_idv_summary

Use this when you need one IDV's size and use in a single call: its ceiling (base and all options), its order count, the total obligated across its orders, and up to five largest orders by obligation among the first ten orders read (PIID, holder, obligated, end date). Do not use for a vehicle program spanning many IDVs (use the contract vehicle analysis) or one award's own facts (use the award facts read). Examples: {"idv":"ZZ0001-26-D-0042"}, {"idv":"CONT_IDV_ZZ000126D0042_9700"}.

g2x_award_transactions

Use this when a question needs one award's modification history: which modifications it has, what each one obligated (the change on that action, not a running total), which one last added funds, and the award's cumulative obligated total. Newest first, with dates, modification numbers and when served an action type and description. Do not use for finding awards by contractor, agency or keyword, or for comparing several awards. Examples: {"piid":"W912DY24C0012"}; {"piid":"W912DY-24-C-0012","positive_funding_only":true}.

spending

Use this when you need federal obligation totals and rankings by agency, place-of-performance state, NAICS, or recipient in one call, with award record IDs behind top rows. Choose contracts, idvs, or all explicitly; all includes contracts and IDVs only. Fiscal years measure annual net obligations. Date ranges select award dates and return the matching annual obligation buckets. Do not use for grants, transaction-date spending, award ceilings, or a parent family's total; use recipient_profile for family totals.

recipient_profile

Use this when you need a recipient's identity, award-reported ultimate parent when known, and fiscal-year net obligations for the recipient and its parent family, each separately labelled. A UEI selects one recipient; an ambiguous name returns candidates. Family totals cover contracts and are reported only when available, never replaced with direct totals. Choose contracts, idvs, or all (contracts plus IDVs; excludes grants). Do not use for current legal ownership, grants, award details, or cross-recipient rankings; use spending for rankings.

g2x_search_tools

Use this when you do not know which G2X tool answers a question. Searches tool descriptions, field definitions and worked examples. Returns five distinct tools by default, with input schemas, matching fields, a recipe, required inputs and availability. Check needs before calling a tool; a relevant award or company reader may require an identifier or parent lookup first.

Document formats and completeness

Ask for the complete document in Markdown, JSON or both. Markdown is for readable text; JSON preserves the supplied document structure. A page, excerpt or list of document names does not satisfy that request. Keep the document version, tables and citations with the result.

If your connection cannot return a complete artifact, use a supported source-document link. Do not present partial text as the full document or start analysis just to obtain it.

Capture workflow

  1. Find an opportunity and keep its record ID.
  2. Retrieve stored document content and existing analysis first. Keep each document's version and citations, and distinguish complete artifacts from excerpts.
  3. Use the user's chosen agent for new interpretation, qualification and drafting by default. Save requested outputs through supported G2X actions. Do not start hosted analysis merely to read documents or save work.
  4. Only if the user explicitly chooses G2X-hosted analysis, select the documents and use g2x_shred_opportunity for requirements or g2x_qualify_opportunity for company fit. Follow the connected tool schemas.
  5. For a hosted run, poll g2x_get_analysis_run with the returned run ID. An accepted run is not a completed result. Retrieve the compliance matrix with the qualification run ID when its schema requires that identifier.

Make only the account changes the user asked for, and resolve an ambiguous target before acting. If a response is slow, resume the run by its existing ID instead of starting another.

Plans and usage

G2X pricing is the source for G2X plans and features. Sign in with your G2X account; its permissions apply to every tool. Your AI agent or model subscription is separate.

The service applies usage and request limits. Each plan also sets a pace, a number of requests a minute, shared by all of your connections. Checking your usage or an analysis run's status does not count toward it. When a request goes past a limit, it returns HTTP 429 with a message that names the limit and when to try again, for example “You've reached your plan's limit of 30 requests a minute. Try again in 2 seconds.” Wait that long; repeating the request sooner will not increase your access.

Open your G2X account menu to check Lumen usage. An agent can report the balance only when its connection provides an account-usage capability. A request limit is not a price, and it is not a measure of your remaining Lumen usage. Do not estimate an account balance from the number of tool calls. Machine-readable access information.

When to add Tango

Use GovCon MCP to research markets, analyze opportunities and manage work in G2X. Add Tango by MakeGov when you need direct procurement data for your own software, data warehouse or custom analysis. Tango offers an API, SDKs and its own MCP connection.

G2X Professional members receive 50% off any Tango plan. Contact G2X support for help applying the member discount.

Errors & recovery

  • 401: Reconnect using the authentication method configured in your client. If sign-in keeps failing, contact G2X support.
  • 429: You reached a limit. The message says which one and when to try again; wait that long and do not retry in a loop.
  • 503: G2X is busy right now. The request did not run; try again in a few seconds.
  • Tool error: Inspect isError and the returned message. Check the input schema, your access and the required preceding workflow step.
  • 405 on GET /mcp: Use MCP JSON-RPC POST requests with Content-Type: application/json and Accept: application/json, text/event-stream. The endpoint is not a browser page.

When no record matches, refine the question instead of inventing a result. Use bounded retries and keep run IDs for analysis requests.

Machine discovery

Request the home page or this guide with Accept: text/markdown for the text version. Responses include Vary: Accept.

Versioning: the MCP handshake negotiates the protocol version. Tool schemas are discoverable once you are signed in, so review them when you upgrade your client.