GovContractScout MCP

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

Servidor MCP GovContractScout

Servidor Model Context Protocol (MCP) que expõe a API de contratos governamentais estaduais e municipais dos EUA do GovContractScout para agentes de IA. Pesquise contratos ao vivo, obtenha detalhes, consulte códigos NAICS, liste estados e avalie a adequação de contratos — sem HTTP bruto.

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

Ferramentas

Ferramenta	Descrição
search_contracts	Pesquise contratos governamentais ativos por estado, NAICS, palavra-chave (retorna título, agência, data de vencimento, sinais de correspondência)
get_contract	Busque o registro completo de um contrato por ID (inclui o link original da solicitação + documentos)
search_naics	Consulte códigos NAICS por palavra-chave
get_states	Liste os estados que indexamos + contagens de contratos ao vivo
score_contract	Avalie a adequação de um contrato para um perfil de negócio (usa /v1/match)
win_likelihood	Estime a probabilidade de vitória versus o arquétipo histórico de premiação — dados derivados, pagos
archetypes	Liste arquétipos de negócios vencedores — quem vence o quê — dados derivados, pagos

Todas as ferramentas usam a mesma API /v1 do endpoint REST público — mesmos dados, mesma autenticação, mesmos limites de taxa. Dados ao vivo dos portais de compras estaduais, atualizados diariamente.

Requisitos

• Node.js 18+
• Uma chave de API GovContractScout (gcs_live_...) — o nível gratuito funciona (100 chamadas/mês); níveis pagos para produção. Obtenha uma em scout.govbidportals.com/api-keys — instantâneo, sem cartão.

Início rápido

Claude Code

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

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

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

Manual (a partir do código-fonte)

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

Configuração

Variável	Obrigatória	Padrão	Descrição
GCS_API_KEY	✅	—	Sua chave de API do painel
GOVCONTRACTSCOUT_API_BASE	❌	https://scout.govbidportals.com	Substituição da URL base da API (auto-hospedagem)

Exemplo

Pergunte ao seu agente:

"Encontre contratos abertos de serviços de TI na Califórnia com vencimento este mês e avalie o melhor para uma consultoria de 10 pessoas com experiência em T&M."

O agente chama search_contracts (state=CA, naics=serviços de TI) e depois score_contract — nenhum conhecimento de HTTP é necessário do agente.

Notas de design

• Avaliação idempotente — score_contract envia um Idempotency-Key determinístico, então novas tentativas nunca queimam cota em dobro.
• Mesma proteção da API — resultados de lista/pesquisa excluem deliberadamente URLs de origem e campos brutos de source_portal (essa é a proteção de agregação); o detalhe de get_contract inclui o link original da solicitação, exatamente como a API faz. O MCP expõe o que a API expõe.
• Cobertura honesta — contratos carregam um campo data_quality (nível + quais campos estão preenchidos). Alguns estados têm dados mais ricos que outros; a API informa exatamente o que você está obtendo.

API / preços

• Grátis: 100 chamadas/mês, sem cartão
• Starter $99/mês · Growth $199/mês · anual = 17% de desconto
• win_likelihood e archetypes são nível pago (Starter+) — a camada de dados derivados
• Documentação completa da API: scout.govbidportals.com/docs/api

Desenvolvimento

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

O servidor é um wrapper fino sobre a API REST pública (/v1/contracts, /v1/contracts/:id, /v1/naics, /v1/states, /v1/match) — consulte a documentação da API para esquemas.

Licença

MIT