io.github.smythmyke/govtoolspro-mcp-server

Official

by smythmyke · TypeScript

Workflow tools for federal contractors: go/no-go scoring, incumbent intel, recompete, NECO.

Workflow tools for federal contractors including scoring, intelligence, and recompete analysis.

GovToolsPro MCP Server

An MCP server that gives Claude (and any MCP client) workflow tools for federal contractors — not raw data access, but decisions: go/no-go scoring, incumbent intelligence, teaming-partner search, recompete prediction, Navy NECO lookup, SAM.gov solicitation retrieval, and market intelligence (labor rates, award patterns, market analysis).

It wraps the live GovToolsPro API. You bring an API key; the server proxies your calls.

Tools

Tool	Cost	What it does
`balance`	free	Credit balance + subscription status.
`get_solicitation`	free	Notice ID (or solicitation number) → structured SAM.gov fields (NAICS, PSC, set-aside, place of performance, deadline, contacts, attachment links). The workflow entry point.
`score_go_no_go`	free	Score a solicitation GO / NO-GO (0–100) against your company profile, with hard-blocker detection (CMMC, geographic, set-aside).
`find_incumbents`	free	Identify the current incumbent via USAspending + FPDS, with competition signals and anticipated next-award date.
`find_partners_near`	free	Rank nearby teaming partners / subcontractors by proximity for a place of performance.
`predict_recompete`	free	Discover expiring contracts (recompete opportunities) by NAICS/PSC/state/value, enriched with option-exercise signals.
`lookup_neco_data`	free	Parse a Navy NECO (neco.navy.mil) solicitation into structured fields. No other govcon MCP has this.
`lookup_labor_rates`	free	Benchmark federal labor rates for a NAICS / labor category — GSA CALC awarded ceiling rates + BLS OEWS wages with a government wrap estimate.
`analyze_award_patterns`	3 credits	How contracts in a NAICS are awarded: award-size distribution, competition mix, bid intensity, contract vehicles, pricing types.
`analyze_market`	5 credits	Market-intelligence snapshot for a NAICS: 5-year spend trend, industry size, top contractors + HHI concentration, set-aside mix, geography, contract vehicles.

Every tool returns decision-support output with a disclaimer — verify against the official solicitation before relying on results. Credits are drawn from the shared GovToolsPro pool (extension + API + connector all bill the same balance); free tools never deduct.

Install

Add to your MCP client config (Claude Desktop, Claude Code, Cursor, Cline, Zed, …):

jsonc

{
  "mcpServers": {
    "govtoolspro": {
      "command": "npx",
      "args": ["-y", "govtoolspro-mcp-server"],
      "env": { "GOVTOOLSPRO_API_KEY": "gtp_live_..." }
    }
  }
}

Get an API key

Create a key in the GovToolsPro extension → Profile → API Keys tab (format gtp_live_... / gtp_test_...).

Use as a Claude connector (remote MCP)

Prefer not to run anything locally? GovToolsPro is also a hosted remote MCP server you can add to Claude as a connector — no install, no API key, sign in with your GovToolsPro account.

Remote MCP URL: https://mcp.govtoolspro.com/api/mcp
In Claude: Settings → Connectors → Add custom connector, paste the URL, and leave the OAuth fields blank (the server self-registers via Dynamic Client Registration).
You'll be sent to auth.govtoolspro.com to sign in; Claude then connects over OAuth 2.1. Toggle the connector on in a conversation to use its tools.

The same 10 tools are available over the connector, billed against the same shared credit balance as the extension and the stdio package.

Configuration

Env var	Required	Default
`GOVTOOLSPRO_API_KEY`	yes	—
`GOVTOOLSPRO_API_BASE`	no	`https://mcp.govtoolspro.com/api/v1/workflows`

Local development

bash

npm install
npm run build

# end-to-end stdio smoke test against the live API
GOVTOOLSPRO_API_KEY=gtp_test_... npm run smoke

To point a client at your local build:

jsonc

{
  "command": "node",
  "args": ["/absolute/path/to/govtoolspro-mcp-server/dist/index.js"],
  "env": { "GOVTOOLSPRO_API_KEY": "gtp_test_..." }
}

Notes

Workflow MCP, not a data wrapper. Competing govcon MCPs return raw SAM.gov/FPDS JSON; these tools return synthesized decisions.
CUI safety. The API rejects content with CUI / FOUO / Distribution-Statement markings; those rejections surface to the client as clear errors. Do not submit controlled content.
No warranty. Output is decision support only — not legal, contractual, or award-outcome advice.

Troubleshooting

Symptom	Cause / fix
`Out of credits` / 402	Three tools are metered (`analyze_market` 5, `analyze_award_patterns` 3). Check `balance`, or top up at govtoolspro.com. Free tools never deduct.
Connector keeps asking you to sign in / 401	The remote connector requires OAuth — complete sign-in at `auth.govtoolspro.com`, then toggle the connector on in the conversation ("Search and tools").
`No data for this NAICS` (502)	That NAICS has no federal activity in the window — you are not charged. Try a broader NAICS or fewer filters.
CUI rejection error	The API rejects content marked CUI / FOUO / Distribution-Statement. Remove controlled content and retry.
`get_solicitation` returns nothing	Use the 32-char notice ID from the `sam.gov/opp/<id>/view` URL. Some archived/cancelled notices may be unavailable.
Invalid API key (stdio)	Ensure `GOVTOOLSPRO_API_KEY` is a `gtp_live_…` / `gtp_test_…` key from the extension's Profile → API Keys tab.

License

Install

Configuration

Environment variables

GOVTOOLSPRO_API_KEYrequiredsecret

API key from the GovToolsPro extension → Profile → API Keys tab. Format: gtp_live_... or gtp_test_...

GOVTOOLSPRO_API_BASE

Override the API base URL. Default: https://mcp.govtoolspro.com/api/v1/workflows

claude_desktop_config.json

{
  "mcpServers": {
    "govtoolspro-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "govtoolspro-mcp-server@0.1.3"
      ],
      "env": {
        "GOVTOOLSPRO_API_KEY": "<YOUR_GOVTOOLSPRO_API_KEY>",
        "GOVTOOLSPRO_API_BASE": "<YOUR_GOVTOOLSPRO_API_BASE>"
      }
    }
  }
}