io.github.smythmyke/govtoolspro-mcp-server
Workflow tools for federal contractors: go/no-go scoring, incumbent intel, recompete, NECO.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
govtoolspro-mcp-serverclaude mcp add govtoolspro-mcp-server -e 'GOVTOOLSPRO_API_KEY=<your govtoolspro_api_key>' -e 'GOVTOOLSPRO_API_BASE=<GOVTOOLSPRO_API_BASE>' -- npx -y govtoolspro-mcp-server@0.1.3
{
"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": "<GOVTOOLSPRO_API_BASE>"
}
}
}
}
متغيرات البيئة
GOVTOOLSPRO_API_KEYإلزامي سري API key from the GovToolsPro extension → Profile → API Keys tab. Format: gtp_live_... or gtp_test_...GOVTOOLSPRO_API_BASEOverride the API base URL. Default: https://mcp.govtoolspro.com/api/v1/workflows
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
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.comto 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
الأسئلة الشائعة
ما هو io.github.smythmyke/govtoolspro-mcp-server؟
Workflow tools for federal contractors: go/no-go scoring, incumbent intel, recompete, NECO.
كيف أثبّت io.github.smythmyke/govtoolspro-mcp-server؟
يعمل على جهازك. في Claude Code: claude mcp add govtoolspro-mcp-server -e 'GOVTOOLSPRO_API_KEY=<your govtoolspro_api_key>' -e 'GOVTOOLSPRO_API_BASE=<GOVTOOLSPRO_API_BASE>' -- npx -y govtoolspro-mcp-server@0.1.3. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج io.github.smythmyke/govtoolspro-mcp-server إلى مفتاح API؟
نعم. يتطلب GOVTOOLSPRO_API_KEY، وتضبطها في إعداداته.
هل io.github.smythmyke/govtoolspro-mcp-server مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون io.github.smythmyke/govtoolspro-mcp-server؟
ينشره smythmyke. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.