GovContractScout MCP

npx add-mcp 'https://scout.govbidportals.com/mcp'

Servidor MCP GovContractScout

Servidor del Protocolo de Contexto de Modelos (MCP) que expone la API de contratos gubernamentales estatales y locales de EE. UU. de GovContractScout a agentes de IA. Busca contratos en vivo, obtén detalles, consulta códigos NAICS, lista estados y evalúa la adecuación de contratos — sin HTTP crudo.

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

Herramientas

Herramienta	Descripción
search_contracts	Busca contratos gubernamentales activos por estado, NAICS, palabra clave (devuelve título, agencia, fecha límite, señales de coincidencia)
get_contract	Obtén el registro completo de un contrato por ID (incluye el enlace de solicitud original + documentos)
search_naics	Consulta códigos NAICS por palabra clave
get_states	Lista los estados que indexamos + recuentos de contratos en vivo
score_contract	Evalúa la adecuación de un contrato para un perfil empresarial (usa /v1/match)
win_likelihood	Estima la probabilidad de ganar frente al arquetipo histórico de adjudicación — datos derivados, de pago
archetypes	Lista arquetipos de empresas ganadoras — quién gana qué — datos derivados, de pago

Todas las herramientas usan la misma API /v1 que el endpoint REST público — mismos datos, misma autenticación, mismos límites de velocidad. Datos en vivo de portales de adquisiciones estatales, actualizados diariamente.

Requisitos

• Node.js 18+
• Una clave API de GovContractScout (gcs_live_...) — el nivel gratuito funciona (100 llamadas/mes); niveles de pago para producción. Obtén una en scout.govbidportals.com/api-keys — instantáneo, sin tarjeta.

Inicio rápido

Claude Code

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

Cualquier cliente MCP (mcp.json / mcp.settings)

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

Manual (desde el código fuente)

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

Configuración

Variable	Obligatoria	Predeterminado	Descripción
GCS_API_KEY	✅	—	Tu clave API del panel de control
GOVCONTRACTSCOUT_API_BASE	❌	https://scout.govbidportals.com	Anulación de la URL base de la API (autoalojamiento)

Ejemplo

Pregunta a tu agente:

"Encuentra contratos abiertos de servicios de TI en California con vencimiento este mes, luego evalúa el mejor para una firma de consultoría de 10 personas con experiencia en T&M."

El agente llama a search_contracts (estado=CA, naics=servicios de TI), luego a score_contract — sin necesidad de conocimiento de HTTP por parte del agente.

Notas de diseño

• Evaluación idempotente — score_contract envía un Idempotency-Key determinista, por lo que los reintentos nunca queman cuota dos veces.
• Misma ventaja que la API — los resultados de lista/búsqueda excluyen deliberadamente URLs de origen y campos crudos de source_portal (esa es la ventaja de agregación); el detalle de get_contract incluye el enlace de solicitud original, exactamente como lo hace la API. El MCP expone lo que expone la API.
• Cobertura honesta — los contratos llevan un campo data_quality (nivel + qué campos están poblados). Algunos estados tienen datos más ricos que otros; la API te dice exactamente lo que estás obteniendo.

API / precios

• Gratis: 100 llamadas/mes, sin tarjeta
• Starter $99/mes · Growth $199/mes · anual = 17% de descuento
• win_likelihood y archetypes son de nivel de pago (Starter+) — la capa de datos derivados
• Documentación completa de la API: scout.govbidportals.com/docs/api

Desarrollo

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

El servidor es un envoltorio delgado sobre la API REST pública (/v1/contracts, /v1/contracts/:id, /v1/naics, /v1/states, /v1/match) — consulta la documentación de la API para los esquemas.

Licencia

MIT