govtoolspro-mcp-server

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, …):

{
  "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

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:

{
  "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

MIT © Michael Smyth