MCP.Market

Govcontractscout MCP server

by govcontractscout·io.github.govcontractscout/govcontractscout-mcp·v1.0.5

MCP server for the GovContractScout US government contracts API: search, NAICS, match scoring.

B80/100grade B
What users say
No reviews yet
Be the first
Safety scan
B80/100

full report

Adoption
Growing

0 stars92 downloads/wk

Reviews

Write one

Nobody has reviewed Govcontractscout yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Govcontractscout tools (7)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • archetypes

    List the winning-business archetypes derived from historical government contract awards (e.g. IT & Software Services, regional construction prime). Each includes NAICS, typical award range, agency types, states, and sample winners. Returns one array, no paging. Use it to see which firm shapes win in a category, then run score_contract against that shape. Derived from historical awards, so it chang

  • get_contract

    Get full details for a single government contract by ID (including agency, set-asides, NAICS codes, dates, and attachments). Returns one object, no paging. Take the id from a search_contracts result; a malformed id is rejected by the schema and an unknown id returns an error, not an empty object. IDs are UUIDs; a row keeps its ID across calls and its fields update when the daily refresh finds chan

  • get_states

    List the US states with live contract coverage in the GovContractScout dataset (metadata only). Returns every covered jurisdiction (50 states, DC and a federal bucket) with its live contract count. Counts refresh daily. Use the state codes it returns in search_contracts. Takes no parameters, so it cannot fail on input; it needs the same GCS_API_KEY and plan limits as the other tools. No paging, re

  • score_contract

    Answers one question: should we bid on this contract? Measures FIT only: how well one contract matches a contractor profile on five weighted factors (NAICS, budget, location, keywords/skills, timeline). Input: contract_id and profile. Output: one object, a 0-100 fit score with per-factor breakdown, no paging. Pass at least naics_codes and service_areas: the more of the profile you fill, the sharpe

  • search_contracts
  • search_naics

    Look up NAICS codes by keyword or code prefix. NAICS codes classify a business's industry, used to match contracts. Pass a keyword like 'janitorial' or 'IT services', or a code like '5415'. Returns up to 100 rows (limit caps at 100), ranked by relevance, no paging. Use it to find the right code first, then pass that code to search_contracts. NAICS is a fixed census catalogue, so results do not cha

  • win_likelihood

    Answers one question: what are our odds of winning this contract? Estimates PROBABILITY, not fit: from the historical award archetype that wins in the contract's category, plus competition, incumbent and recompete signals. Input: contract_id and profile (agency history and past awards sharpen it). Output: one object, a 0-100 win probability, a grade, reasons, and the matched archetype; no paging.

Public scan report

scanner v0.1.10 · 2026-10-30 · same rubric, same numbers if you re-run it

no findings
  • Code scan2 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 5 days ago15/15
  • Maintainer identityregistry namespace matches repository owner6/10
Overall 80/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Govcontractscout compares

Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
80/100
higher than 65% of 3,470 Web search servers
Tools
7
the typical Web search server has 5
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
92
more than 55% of 827 Web search servers with a package

What its tools let an agent do: 7 read

Release history: 3 versions in the registry since 2026-09-21, latest 2026-10-17, typically one every 26 days.

Install Govcontractscout in Claude Code, Cursor or VS Code

Runs npx -y govcontractscout-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add govcontractscout-mcp -- npx -y govcontractscout-mcp
Add to Cursor

What the publisher says

From the Govcontractscout repository's README, as published. We do not edit it. Read it on GitHub

GovContractScout MCP Server

Model Context Protocol (MCP) server exposing the GovContractScout US state & local government contracts API to AI agents. Search live contracts, pull details, look up NAICS codes, list states, and score contract fit — without raw HTTP.

AI agent (Claude, Cursor, etc.)  ⇄  MCP  ⇄  GovContractScout /v1 API  ⇄  50-state procurement data

Tools

All tools hit the same /v1 API as the public REST endpoint — same data, same auth, same rate limits. Live data from state procurement portals, updated daily.

Requirements

  • Node.js 18+
  • A GovContractScout API key (gcslive...) — free tier works (100 calls/month); paid tiers for production. Get one at scout.govbidportals.com/api-keys — instant, no card.

Quickstart

Claude Code

claude mcp add govcontractscout \
  --env GCS_API_KEY=gcs_live_YOUR_KEY \
  -- npx -y govcontractscout-mcp

Any MCP client (mcp.json / mcp.settings)

{
  "mcpServers": {
    "govcontractscout": {
      "command": "npx",
      "args": ["-y", "govcontractscout-mcp"],
      "env": {
        "GCS_API_KEY": "gcs_live_YOUR_KEY"
      }
    }
  }
}

Manual (from source)

npm install && npm run build
GCS_API_KEY=gcs_live_YOUR_KEY node dist/index.js

Configuration

Example

Ask your agent:

"Find open IT services contracts in California due this month, then score the top one for a 10-person consulting firm with T&M experience."

The agent calls searchcontracts (state=CA, naics=IT services), then scorecontract — no HTTP knowledge required from the agent.

Design notes

  • Idempotent scoring — score_contract sends a deterministic Idempotency-Key, so retries never double-burn quota.
  • Same moat as the API — list/search results deliberately exclude source URLs and raw sourceportal fields (that's the aggregation moat); getcontract detail includes the original solicitation link, exactly as the API does. The MCP exposes what the API exposes.
  • Honest coverage — contracts carry a data_quality field (level + which fields are populated). Some states have richer data than others; the API tells you exactly what you're getting.

API / pricing

  • Free: 100 calls/month, no card
  • Starter $99/mo · Growth $199/mo · annual = 17% off
  • winlikelihood and archetypes are paid-tier (Starter+)** — the derived-data layer
  • Full API docs: scout.govbidportals.com/docs/api

Development

npm run dev    # tsx watch
npm run build  # tsc -> dist/
npm start      # run built server

The server is a thin wrapper over the public REST API (/v1/contracts, /v1/contracts/:id, /v1/naics, /v1/states, /v1/match) — see the API docs for schemas.

License

MIT

Nothing above is checked by us. What we check is on the safety report.

Govcontractscout: common questions

Is Govcontractscout MCP server safe?
Mostly: it is graded B (80/100). Read the Govcontractscout safety report
How do I install Govcontractscout?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Govcontractscout need an API key?
Yes. The registry entry asks for GCS_API_KEY.
Is Govcontractscout maintained?
The last commit was 10 days ago (2026-10-25). The latest release is v1.0.5.
What can I use instead of Govcontractscout?
Servers from other publishers that do the same job: Clinicaltrialsgov MCP server.
How does Govcontractscout compare with other Web search MCP servers?
safety score 80/100 (higher than 65% of 3,470 Web search servers); tools 7 (the typical Web search server has 5); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Govcontractscout

Same job from other publishers: the closest match first, then the best rated.

  • Clinicaltrialsgov
    Search ClinicalTrials.gov: find studies, retrieve results, match patients to candidate trials.
    A