us-govdata-mcp

Servidor MCP para datos del gobierno de EE. UU. — busca permisos de construcción, oportunidades de contratos federales (SAM.gov) y el registro nacional de proveedores de atención médica (NPI/NPPES) desde Claude, Cursor o cualquier cliente del Model Context Protocol.

Las tres fuentes de datos son publicaciones oficiales del gobierno (portales de datos abiertos de ciudades, el extracto público de SAM.gov, la API CMS NPPES) — sin scraping HTML, sin inicios de sesión, sin selectores frágiles. El trabajo pesado lo realizan tres actores de producción de Apify que se ejecutan en tu propia cuenta de Apify.

Pruébalo en 30 segundos — sin cuenta, sin cargo

Antes de decidir si esto vale la pena un token de API, ejecútalo sin ninguno:

{
  "mcpServers": {
    "us-govdata": {
      "command": "npx",
      "args": ["-y", "github:CBLU2005/us-govdata-mcp"],
      "env": { "APIFY_DRY_RUN": "1" }
    }
  }
}

Esa es toda la configuración. En modo de prueba en seco, cada herramienta devuelve registros de muestra realistas más la solicitud exacta a la API de Apify que habría enviado — para que puedas ver la forma real de los datos, confirmar que tu agente llama a las herramientas correctamente y leer la divulgación de precios en la descripción de cada herramienta, sin crear una cuenta, pegar un token ni gastar nada.

Pregunta a tu agente algo como "encuentra permisos de construcción de más de $500k emitidos en Austin este mes" y observa la llamada a la herramienta de principio a fin. Cuando quieras datos en vivo, elimina la línea APIFY_DRY_RUN y agrega un APIFY_TOKEN (abajo).

Related MCP server: DOL WHD MCP

Herramientas

* Divulgación honesta de precios: estas herramientas ejecutan actores de Apify de pago por resultado publicados por CBLU. Tu cuenta de Apify se cobra solo por los registros realmente devueltos — no hay suscripciones ni tarifas de inicio. Cada herramienta tiene un valor predeterminado de 25 resultados por llamada, por lo que una llamada típica cuesta una fracción de un centavo (25 permisos ≈ $0.13; 25 avisos de contratos ≈ $0.10; 25 proveedores ≈ $0.05). El plan gratuito de Apify incluye crédito mensual de plataforma, que es suficiente para usar estas herramientas de manera casual sin costo. Páginas de actores con detalles completos de precios:

• US Building Permits Scraper

• SAM.gov Contract Opportunities Scraper

• NPI Registry Scraper

Inicio rápido

1. Obtén un token de Apify (gratis, ~2 minutos)

1. Regístrate en https://console.apify.com/sign-up (el plan gratuito funciona).

2. Copia tu token de API desde https://console.apify.com/settings/integrations.

El servidor se inicia y enumera sus herramientas sin un token — el token solo se necesita cuando se llama realmente a una herramienta.

2. Añade el servidor a tu cliente MCP

Claude Desktop (claude_desktop_config.json → Configuración → Desarrollador → Editar configuración):

{
  "mcpServers": {
    "us-govdata": {
      "command": "npx",
      "args": ["-y", "github:CBLU2005/us-govdata-mcp"],
      "env": {
        "APIFY_TOKEN": "your_apify_token_here"
      }
    }
  }
}

Claude Code:

claude mcp add us-govdata -e APIFY_TOKEN=your_apify_token_here -- npx -y github:CBLU2005/us-govdata-mcp

Cursor / Windsurf / otros clientes MCP (misma forma que Claude Desktop):

{
  "mcpServers": {
    "us-govdata": {
      "command": "npx",
      "args": ["-y", "github:CBLU2005/us-govdata-mcp"],
      "env": { "APIFY_TOKEN": "your_apify_token_here" }
    }
  }
}

Desde un clon local:

git clone https://github.com/CBLU2005/us-govdata-mcp.git
cd us-govdata-mcp
npm install && npm run build
# then point your client at: node /path/to/us-govdata-mcp/dist/index.js

Docker:

docker build -t us-govdata-mcp .
docker run -i --rm -e APIFY_TOKEN=your_apify_token_here us-govdata-mcp        # stdio
docker run --rm -p 3000:3000 -e APIFY_TOKEN=... us-govdata-mcp --http 3000    # Streamable HTTP

3. Pregunta a tu agente de IA cosas como

• "Encuentra permisos de construcción para nuevas construcciones de más de $500k emitidos en Austin este mes, con nombres de contratistas."

• "¿Hay alguna solicitud de ciberseguridad activa reservada para pequeñas empresas con fecha límite de respuesta posterior a hoy? Incluye el correo electrónico del oficial de contratación."

• "Lista dentistas en el área metropolitana de Miami (ZIP 331) con sus números de teléfono de consulta."*

Transportes

• stdio (predeterminado) — lo que usan los clientes MCP de escritorio: us-govdata-mcp

• HTTP transmisible — endpoint sin estado en POST /mcp, verificación de salud en GET /healthz: us-govdata-mcp --http 3000 (o establece MCP_HTTP_PORT=3000)

Variables de entorno

Cómo funciona

Cada herramienta valida sus argumentos (zod), construye la entrada del actor y llama al endpoint run-sync-get-dataset-items de la API de Apify con tu token mediante un encabezado Authorization: Bearer (nunca en la URL). El actor se ejecuta en la plataforma de Apify bajo tu cuenta y los elementos del conjunto de datos resultantes se devuelven directamente como resultado de la herramienta. Este servidor no mantiene estado y no ve ningún dato más allá de pasarlo.

Desarrollo

npm install
npm test          # builds + runs the full smoke suite (introspection, tokenless
                  # error path, dry-run request construction, HTTP transport)

El conjunto de pruebas no necesita cuenta de Apify ni red — usa APIFY_DRY_RUN=1.

Relacionados

• Perfil de Apify Store con todos los actores de CBLU: https://apify.com/cblu

• Model Context Protocol: https://modelcontextprotocol.io

Licencia

MIT © CBLU