mcp-sam-gov (SAM.gov + USAspending + SLED procurement)

---

Véalo en acción

👤  user        Find active SAM.gov solicitations under NAICS 541512 closing this month
                                                                                          
🤖  Claude     → sam_search_opportunities { ncode: "541512", limit: 5 }                  
✓  47,478 active opportunities indexed                                                  
                                                                                          
   • 5ef3db5d…  VA Bulk Oxygen Tank Rental         closes 2026-05-15  ($1.05M)         
   • a000339c…  Articulating Boom Lifts             closes 2026-05-30  ($310K)          
   • be9c24ef…  CMOP Hazardous Waste Removal        closes 2026-06-12  ($2.7M)          

👤  user        Pull the SOW + contracting officer for the first one
                                                                                          
🤖  Claude     → sam_get_opportunity { noticeId: "5ef3db5d…" }                          
✓  Department of Veterans Affairs · Combined Synopsis/Solicitation                       
   POC:           Contracting Officer  <co.name@example.gov>  +1-XXX-XXX-XXXX             
   Set-aside:     Total Small Business                                                    
   Attachments:   1   ↓ 36C24526Q0460_1.docx (172 KB)                                     
   SOW preview:   "RFQ# 36C24526Q0460 — Bulk Oxygen Tank Rental, Fill, Telemetry…"        

Sin clave de API, registro ni suscripción para 147 de las 152 herramientas. Solo conéctelo y pregunte.

---

Por qué existe esto

Estado actual	Con este MCP
GovWin: $30K-$100K/año por asiento	Gratis, licencia MIT
Registro de clave de API → esperar 24 h → elegir plan de cuotas	npm install → funcionando en 60 s
5+ API de proveedores / scrapers separados	1 superficie unificada, 152 herramientas en 54 fuentes
Los LLM alucinan códigos NAICS / nombres de agencias	Guardas de autocompletado anti-alucinación integradas
El scraping frágil se rompe semanalmente	Prueba de humo diaria en vivo (insignia arriba)
Oficial de contratación → ticket de TI → espera de 3 semanas	Instalación con doble clic en Claude Desktop

Los datos federales que envuelve son de dominio público. No hay una buena razón para que cueste una suscripción de cinco cifras consultarlos.

---

Lo que esto le da a Claude (y a otros agentes de IA)

Dominio	Qué puede preguntar	Fuentes
🔍 Oportunidades y solicitudes	"Encuentra solicitudes de SAM.gov bajo NAICS 541512 que cierren este mes" — lea el SOW, los POC y los adjuntos	SAM.gov, Grants.gov
💰 Gasto, adjudicaciones y competencia	"Muéstrame las adjudicaciones de Booz Allen en VA el último año fiscal; las 10 principales categorías PSC en DoD"	USAspending, FPDS, GAO
🕵️ Verificación de entidades y socios	"Examina a esta empresa: sanciones OFAC, exclusiones SAM, hallazgos de auditoría única, salud bancaria, cumplimiento EPA + liberación de tóxicos"	OFAC, SAM, FAC, FDIC, EPA ECHO, EPA Envirofacts
🛒 Seguridad de productos y retiros	"¿Hay retiros o acciones de cumplimiento de FDA/NHTSA/CPSC contra los productos de este proveedor?"	openFDA, NHTSA, CPSC
⚖️ Litigios y tribunales	"¿Hay protestas de ofertas en la Corte de Reclamaciones Federales u opiniones del Circuito Federal que involucren a este contratista?"	CourtListener (Free Law Project)
🏢 Proveedores sin fines de lucro	"Obtén los estados financieros IRS-990 de esta organización sin fines de lucro antes de subcontratar con ella"	IRS 990 (vía ProPublica)
🏥 Proveedores e instalaciones de salud	"Utilización de Medicare y pagos para este proveedor; calificaciones de calidad hospitalaria; ¿está este proveedor en la lista de revocación?"	CMS (data.cms.gov)
📈 Divulgación financiera (SEC)	"Obtén la tendencia de ingresos y los últimos archivos 10-K de esta empresa pública"	SEC EDGAR
⚖️ Regulación y legislación	"¿Qué reglas de ciberseguridad de VA se publicaron este trimestre? ¿Hay expedientes abiertos en Regulations.gov?"	Federal Register, Regulations.gov, eCFR, FAR/DFARS, Congress.gov, GovInfo
💲 Precios, mano de obra y fiscal	"Banda de tarifas de mano de obra GSA CALC para un analista de sistemas; determinación de salarios SCA para este condado; escalamiento CPI; tope de viáticos para un viaje; PIB regional por industria; historial de cumplimiento de salarios y horas del DOL"	GSA CALC, SAM WDs, BLS, US Census CBP, FRED, BEA, US Treasury, GSA per-diem, US DOL
🏛 Cabildeo e influencia	"¿Quién cabildea a VA sobre ciberseguridad y cuánto gastan?"	US Senate LDA
🏥 Financiamiento de salud e investigación	"Subvenciones NIH/NSF sobre este tema; ensayos clínicos en reclutamiento; pagos de la industria a este médico"	NIH RePORTER, NSF, ClinicalTrials.gov, CMS Open Payments, NPPES
🛡 Cumplimiento cibernético	"¿Está este CVE en la lista KEV de parcheo obligatorio de CISA?"	NVD, CISA KEV
🌐 Comercio, geografía y desastres	"Arancel HTS para este producto; tramo censal para esta dirección; declaraciones FEMA en este estado"	USITC HTS, US Census, FEMA, Socrata, CKAN
🏙 Ofertas de contratación estatal/local (SLED)	"¿Qué hay abierto en el portal de contratación de esta ciudad/condado ahora mismo? Su libro de cheques, contratos adjudicados, pagos a proveedores; registros de ofertas/adjudicaciones del DOT estatal"	OpenGov Procurement (525+ gobiernos), Bonfire, ArcGIS (feature + Hub), Socrata (53 hosts), una vista de invitado de Tableau Server (Montana), un libro de cheques de gastos abiertos Socrata (Dakota del Sur)
🎓 Subvenciones y conjuntos de datos	"Subvenciones de ciberseguridad publicadas en los últimos 30 días; descubra conjuntos de datos federales abiertos"	Grants.gov, data.gov

152 herramientas en 54 fuentes de datos — sin clave primero: solo 4 fuentes (patrones comerciales del Census, FRED, BEA y el endpoint de datos del DOL) necesitan una clave gratuita; las otras 50 no necesitan ninguna. (Una compilación anterior de 52 herramientas midió aproximadamente p50 ~0.25 s / p95 ~0.8 s contra las API federales de producción; la latencia varía según la fuente y la carga ascendente — trátela como rápida, no como una garantía comparada.)

---

¿Cómo lo instalo? Elija la ruta que se ajuste a usted.

🟢 Ruta 1 — Claude Desktop, un clic (sin necesidad de terminal)

Ideal para no desarrolladores. Solo descargue un archivo y haga doble clic.

1. Descargue mcp-sam-gov.mcpb desde la última versión.
2. Haga doble clic en el archivo. Claude Desktop se abre con un diálogo "Instalar extensión".
3. Haga clic en Instalar.
4. Listo. Inicie una nueva conversación y pregunte "Encuentra oportunidades activas de SAM.gov bajo NAICS 541512".

Eso es todo. Sin PowerShell, sin npm, nada.

Requiere Claude Desktop ≥ 1.0 (que incluye su propio runtime de Node.js).

🟡 Ruta 2 — Claude Code, un comando

Si ya usa Claude Code (la CLI):

/plugin install cliwant/mcp-sam-gov

Esto instala el servidor MCP más una guía de flujo de trabajo SKILL.md que le enseña a Claude cuándo y cómo usar cada una de las 152 herramientas.

🔵 Ruta 3 — Instalación manual para cualquier host MCP (Codex, Cursor, Continue, Gemini)

Para Codex CLI / Cursor / Continue / Gemini CLI / cualquier cosa que hable MCP:

gh repo clone cliwant/mcp-sam-gov
cd mcp-sam-gov
npm install --omit=dev
npm install -g .

Después de la instalación, el binario mcp-sam-gov está en su PATH. Agregue esto a la configuración de su host:

{
  "mcpServers": {
    "sam-gov": {
      "command": "mcp-sam-gov"
    }
  }
}

Ubicaciones de configuración específicas por host: consulte Configuraciones de host a continuación.

¿Sin instalación global? Cada configuración de host a continuación también tiene una variante npx (npx -y @cliwant/mcp-sam-gov) que omite el clon y npm install -g. Solo necesita Node.js.

⚪ Ruta 4 — Ruta directa (cero instalación, solo apunte al archivo)

Omita la instalación por completo:

gh repo clone cliwant/mcp-sam-gov
cd mcp-sam-gov
npm install --omit=dev   # only runtime deps; dist/ is pre-built

Luego apunte la configuración de su host a la ruta absoluta:

{
  "mcpServers": {
    "sam-gov": {
      "command": "node",
      "args": ["C:\\Users\\you\\mcp-sam-gov\\dist\\server.js"]
    }
  }
}

---

Configuraciones de host

Cada host a continuación muestra dos variantes. Use una de ellas:

• Instalación global: "command": "mcp-sam-gov". Esto funciona solo después de que npm install -g (Ruta 3) haya colocado el binario mcp-sam-gov en su PATH.
• Sin instalación global (npx): "command": "npx", "args": ["-y", "@cliwant/mcp-sam-gov"]. Esto solo necesita Node.js. npx descarga el paquete de npm en la primera ejecución y lo almacena en caché.

Nombre del paquete: el paquete npm tiene ámbito: @cliwant/mcp-sam-gov. mcp-sam-gov es solo el nombre del binario que una instalación global coloca en su PATH. No existe un paquete mcp-sam-gov sin ámbito en npm, por lo que npx -y mcp-sam-gov falla con un 404. Use npx -y @cliwant/mcp-sam-gov.

Claude Desktop

%APPDATA%\Claude\claude_desktop_config.json (Windows) o ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

Instalación global:

{
  "mcpServers": {
    "sam-gov": { "command": "mcp-sam-gov" }
  }
}

Sin instalación global (npx):

{
  "mcpServers": {
    "sam-gov": { "command": "npx", "args": ["-y", "@cliwant/mcp-sam-gov"] }
  }
}

En Windows, si el servidor no se inicia con spawn npx ENOENT en %APPDATA%\Claude\logs\mcp*.log, envuelva npx en cmd /c:

{
  "mcpServers": {
    "sam-gov": { "command": "cmd", "args": ["/c", "npx", "-y", "@cliwant/mcp-sam-gov"] }
  }
}

(O omita esto por completo — use el .mcpb de la Ruta 1 y se auto-configura.)

Reinicie Claude Desktop por completo (salir de la bandeja del sistema en Windows / menú Salir en macOS), luego busque el ícono 🔨. Debería ver "sam-gov (152 herramientas)".

Claude Code

.mcp.json por proyecto, instalación global:

{ "mcpServers": { "sam-gov": { "command": "mcp-sam-gov" } } }

Sin instalación global (npx):

{ "mcpServers": { "sam-gov": { "command": "npx", "args": ["-y", "@cliwant/mcp-sam-gov"] } } }

O con la CLI:

# global install
claude mcp add sam-gov mcp-sam-gov

# no global install (npx)
claude mcp add sam-gov -- npx -y @cliwant/mcp-sam-gov

Codex CLI

~/.codex/config.toml:

Instalación global:

[mcp_servers.sam-gov]
command = "mcp-sam-gov"
args = []

Sin instalación global (npx):

[mcp_servers.sam-gov]
command = "npx"
args = ["-y", "@cliwant/mcp-sam-gov"]

Cursor

Configuración → MCP → Agregar nuevo servidor MCP. Instalación global:

{ "mcpServers": { "sam-gov": { "command": "mcp-sam-gov" } } }

Sin instalación global (npx):

{ "mcpServers": { "sam-gov": { "command": "npx", "args": ["-y", "@cliwant/mcp-sam-gov"] } } }

Continue

~/.continue/config.json, instalación global:

{
  "experimental": {
    "modelContextProtocolServer": {
      "transport": { "type": "stdio", "command": "mcp-sam-gov" }
    }
  }
}

Sin instalación global (npx):

{
  "experimental": {
    "modelContextProtocolServer": {
      "transport": { "type": "stdio", "command": "npx", "args": ["-y", "@cliwant/mcp-sam-gov"] }
    }
  }
}

Gemini CLI

~/.gemini/settings.json, instalación global:

{ "mcpServers": { "sam-gov": { "command": "mcp-sam-gov" } } }

Sin instalación global (npx):

{ "mcpServers": { "sam-gov": { "command": "npx", "args": ["-y", "@cliwant/mcp-sam-gov"] } } }

Cualquier otra cosa

Si su host habla MCP sobre stdio, apúntelo a mcp-sam-gov (instalación global) o a npx -y @cliwant/mcp-sam-gov (sin instalación global). Sin código específico del host.

---

¿Qué preguntas puedo hacer?

Una vez instalado, puede preguntar en lenguaje natural. El agente elige la secuencia de herramientas correcta automáticamente.

Descubrimiento

• "NAICS 541512 의 메릴랜드 입찰 중 30일 안에 마감되는 것 찾아줘"
• "Encuentra solicitudes activas de SAM.gov bajo NAICS 541512, solo MD, que cierren en 30 días"
• "¿Cuál es el código NAICS canónico para 'diseño de sistemas informáticos'?"

Análisis de RFP

• "Obtén noticeId 5ef3db5daeb54099a96d487783a38bd0 — dame el SOW, el oficial de contratación y los adjuntos"
• "Muéstrame el cuerpo completo de la RFP para ese aviso"

Panorama competitivo

• "Los 5 principales beneficiarios de contratos de VA en NAICS 541519 el último año fiscal"
• "Muéstrame las adjudicaciones individuales de Booz Allen en DISA"
• "¿Quiénes son los subcontratistas en los contratos de Leidos con VA?"
• "¿Qué es CMS en USAspending? (resuelve la abreviatura)"

Tendencias y agregación

• "¿Cómo ha sido la tendencia del gasto de VA en 541512 en los últimos 5 años fiscales?"
• "Los 10 principales estados por gasto en contratación federal en 541512"
• "Principales categorías PSC en DoD por gasto"
• "Programas de subvenciones federales en ciberseguridad por $ total"

Inteligencia de agencias (informe de captura)

• "Dame un informe de captura sobre VA: misión, desglose del presupuesto FY26, principales subagencias"
• "¿Cuál es el volumen de transacciones de VA para FY25?"

Radar de recompite

• "Contratos de VA 541512 que expiran en los próximos 12 meses por más de $1M"
• "Obtén el período de ejecución para la adjudicación CONT_AWD_..."

Regulación y legislación

• "Encuentra secciones de FAR sobre requisitos de reserva SDVOSB"
• "Convierte la lista de cláusulas FAR/DFARS citadas de esta RFP en una matriz de cumplimiento de la Sección L/M"
• "¿Qué nuevas reglas de ciberseguridad de VA se publicaron este trimestre?"
• "¿Hay documentos del Federal Register en el escritorio de inspección pública de DoD hoy?"
• "Busca expedientes de Regulations.gov sobre 'ciberseguridad de contratistas' y obtén los comentarios públicos"
• "Descubre conjuntos de datos federales abiertos sobre 'incendios forestales' en data.gov"
• "¿Existe un documento del Federal Register con número 2026-08333? Obtén la cita."

Verificación de socios y entidades

• "Examina 'Acme Defense LLC' contra la lista de sanciones OFAC y las exclusiones SAM"
• "Busca NPI 1234567890 en NPPES — ¿está activo este proveedor?"
• "¿Tiene este subcontratista hallazgos adversos de Auditoría Única en el Centro de Intercambio de Auditorías Federales?"
• "¿Qué tan saludable está el banco con certificado #3510 — ratios de riesgo y estados financieros trimestrales?"
• "Obtén la tendencia de ingresos y el último 10-K de esta empresa pública desde SEC EDGAR"
• "¿Hay banderas de cumplimiento/ejecución de EPA para esta instalación?"

Cumplimiento y elegibilidad

• "¿Cuál es el estándar de tamaño de pequeña empresa de la SBA para NAICS 541512?"
• "Busca en el eCFR el texto exacto de una regla"
• "¿Cuál es la tasa de arancel de importación de EE. UU. (HTS) para baterías de iones de litio?"

Precios, mano de obra y fiscal

• "Banda de tarifa tope de GSA CALC para un analista de sistemas senior"
• "Encuentra la determinación de salarios SCA para el condado de Baltimore, MD y dame las tasas de beneficios adicionales"
• "¿Cuánto ha subido el CPI-U en los últimos 3 años para una cláusula de escalamiento?"
• "¿Cuál es la deuda pública total actual de EE. UU. (Debt to the Penny)?"

Cibernético

• "¿Está CVE-2021-44228 (Log4Shell) en la lista KEV de parcheo obligatorio de CISA, y cuál es la fecha límite?"

Financiamiento de salud e investigación

• "Proyectos de NIH RePORTER sobre vacunas de ARNm financiados el año pasado"
• "Ensayos clínicos en reclutamiento para diabetes patrocinados por la industria"
• "Pagos de la industria a médicos en CA del conjunto de datos de Investigación de Pagos Abiertos de CMS"

Subvenciones

• "Subvenciones de ciberseguridad publicadas en los últimos 30 días"
• "Obtén la subvención id 361238"

---

Opcional — límites de tasa más altos + archivos

El servidor MCP funciona sin clave por defecto. Para obtener límites de tasa más altos de SAM.gov + el archivo completo (avisos de más de ~12 meses), establece SAM_GOV_API_KEY en el bloque de entorno de tu host:

{
  "mcpServers": {
    "sam-gov": {
      "command": "mcp-sam-gov",
      "env": { "SAM_GOV_API_KEY": "your-key-here" }
    }
  }
}

Obtén una clave gratuita en sam.gov/SAM/pages/public/searchKeyData.jsf. El agente no necesita saberlo — la ruta de la clave es transparente.

DATA_GOV_API_KEY — la familia api.data.gov / api.gsa.gov

Un puñado de fuentes utilizan la pasarela compartida api.data.gov — Congress.gov, GovInfo, Regulations.gov, FAC, GSA per-diem y el catálogo de conjuntos de datos v4 de data.gov. Funcionan sin clave de inmediato a través de la DEMO_KEY pública (una cuota compartida por hora baja). Establece DATA_GOV_API_KEY para aumentar esos límites sustancialmente:

{
  "mcpServers": {
    "sam-gov": {
      "command": "mcp-sam-gov",
      "env": { "DATA_GOV_API_KEY": "your-key-here" }
    }
  }
}

Obtén una gratis (instantánea, sin espera) en api.data.gov/signup. La misma clave se acepta en todas las fuentes de api.data.gov / api.gsa.gov. Al igual que la clave de SAM, solo se envía por el cable (nunca se registra); si no se establece, simplemente significa DEMO_KEY. Las fuentes de BLS también aceptan una BLS_API_KEY gratuita opcional para elevar su cuota diaria.

Claves y límites más altos — el inventario completo

La mayoría de las herramientas no requieren clave. Cuatro fuentes requieren una clave gratuita — Census (census_business_patterns), FRED (fred_search_series, fred_series_observations), BEA (bea_regional_data) y el endpoint de datos de DOL (dol_get_dataset) — esas fuentes no tienen nivel sin clave, por lo que la herramienta falla sin una. (El catálogo dol_list_datasets de DOL no requiere clave). Las demás claves son opcionales: solo aumentan un límite de tasa o desbloquean un solo filtro. Cada clave a continuación es gratuita.

Variable de entorno	¿Requerida?	Qué desbloquea	Registro gratuito
CENSUS_API_KEY	Requerida	census_business_patterns (sin nivel sin clave — falla sin ella)	api.census.gov/data/key_signup.html
FRED_API_KEY	Requerida	las 2 herramientas de FRED (sin nivel sin clave — fallan sin ella)	fred.stlouisfed.org/docs/api/api_key.html
BEA_API_KEY	Requerida	bea_regional_data (BEA Regional; sin nivel sin clave — falla sin ella)	apps.bea.gov/API/signup
DOL_API_KEY	Requerida para datos	dol_get_dataset (registros de cumplimiento de DOL a través de X-API-KEY; el catálogo dol_list_datasets no requiere clave)	dol.gov/developer
DATA_GOV_API_KEY	Opcional	límites más altos en todas las fuentes de api.data.gov (Regulations.gov, Congress.gov, GovInfo, FAC, catálogo de data.gov, GSA per-diem) — eleva el límite compartido de DEMO_KEY	api.data.gov/signup
SAM_GOV_API_KEY	Opcional	búsqueda autenticada de SAM.gov v2 + el filtro de nombre de organización	open.gsa.gov/api/get-opportunities-public-api
LDA_API_KEY	Opcional	límite de tasa más alto en lda_search_filings (cabildeo del Senado LDA; sin clave por defecto)	lda.senate.gov/api/register
BLS_API_KEY	Opcional	el nivel BLS v2 (~500 consultas/día vs ~25/día sin clave)	data.bls.gov/registrationEngine
NVD_API_KEY	Opcional	un límite de tasa más alto de NVD (cve_lookup)	nvd.nist.gov/developers/request-an-api-key
OPENFDA_API_KEY	Opcional	límite de tasa más alto de openFDA (openfda_enforcement, openfda_device_clearances; ambos funcionan sin clave)	open.fda.gov/apis/authentication
COURTLISTENER_API_TOKEN	Opcional	límite de tasa más alto de CourtListener (courtlistener_search_opinions; funciona sin clave)	courtlistener.com/help/api/rest
SOCRATA_APP_TOKEN	Opcional	límites de limitación más altos de Socrata	evergreen.data.socrata.com/signup

Dos formas de establecer cualquier clave — elige una:

1. Bloque de entorno del host — el objeto "env": { … } que se muestra en los ejemplos anteriores.
2. Un archivo .env en el directorio de trabajo del servidor — configura tus claves una vez:

   CENSUS_API_KEY=your-key-here
   FRED_API_KEY=your-key-here
   # optional — raise limits / unlock filters
   SAM_GOV_API_KEY=your-key-here
   

   El servidor carga automáticamente .env al inicio. Una variable de entorno real siempre gana sobre .env (precedencia estándar), y .env está en git-ignore para que tus claves nunca se confirmen.

Pregunta al servidor qué claves necesita. La herramienta api_key_status sin clave lista cada clave, si es requerida u opcional, la URL de registro gratuito + qué desbloquea, y si cada una está configurada actualmente (un booleano — el valor de la clave nunca se muestra). Crear la cuenta en la URL de registro es tu único paso manual; el servidor automatiza el descubrimiento (api_key_status) y la configuración (.env). Para confirmar que una clave realmente funciona, llama a la herramienta propia de esa fuente.

---

Mantenerse actualizado

npm no notifica a los usuarios instalados sobre nuevas versiones, así que el servidor lo hace — de forma mínima. Al inicio hace una solicitud anónima al registro público de npm para su propia última versión y, solo si existe una más reciente, imprime una sola línea en stderr (por ejemplo, a newer version is available: 1.7.0 → 1.8.0). No envía datos de uso (es una verificación de versión, no telemetría), nunca toca el stdout del protocolo, no bloquea y permanece en silencio cuando estás actualizado.

• Actualizar: npm i -g @cliwant/mcp-sam-gov@latest — o simplemente reinicia si tu configuración usa npx @cliwant/mcp-sam-gov@latest.
• Excluirse: establece MCP_SAM_GOV_NO_UPDATE_CHECK=1 (o NO_UPDATE_NOTIFIER=1).
• Qué cambió: la página de versiones + CHANGELOG.

¿Encontraste un error? ¿Quieres una función? Repórtalo en un solo paso

Este servidor está construido para mejorar a partir del uso real. Debido a que un agente de IA (no un humano) llama a las herramientas, la ruta de retroalimentación pasa a través del agente:

• En los dos errores de "algo puede estar roto" — schema_drift (una API federal cambió de forma) y upstream_unavailable (una interrupción) — el sobre de error lleva un campo report: un enlace de issue de GitHub prellenado que tu agente puede ofrecerte.
• O simplemente dile a tu agente "reporta un error" / "este resultado parece incorrecto" / "desearía que pudiera hacer X" — llama a la herramienta feedback, que devuelve un enlace de issue prellenado para que lo abras y lo envíes.

Nada se publica automáticamente. El servidor no tiene token ni cuenta — solo construye el enlace; tú lo abres y lo envías. Los enlaces prellenados solo llevan el nombre de la herramienta, el tipo de error y la versión del servidor — nunca tus valores de consulta. El repositorio es público, así que redacta cualquier cosa sensible primero.

También puedes abrir uno directamente: Nuevo issue — plantillas de error / función / salida incorrecta.

Catálogo de herramientas (152 herramientas)

Agrupadas por flujo de trabajo. Primero sin clave — la mayoría de las herramientas no necesitan clave; los patrones comerciales de Census, FRED, BEA y el endpoint de datos de DOL requieren una clave gratuita, y un puñado de otras obtienen límites más altos de una clave gratuita opcional (señalado arriba). Las descripciones están condensadas — el propio inputSchema de cada herramienta lleva el contrato completo y las advertencias de honestidad.

Oportunidades y solicitudes — SAM.gov + Grants.gov (10 herramientas)

• sam_search_opportunities — búsqueda HAL sin clave de oportunidades de contratación activas de SAM.gov
• sam_search_shaping — radar de pre-solicitud (Sources Sought / Presol / Avisos especiales antes de que exista el RFP)
• sam_get_opportunity — detalle completo por noticeId hexadecimal de 32 caracteres (POCs + adjuntos + cuerpo)
• sam_fetch_description — cuerpo completo del RFP como texto plano
• sam_fetch_attachment_text — extrae texto de adjuntos (RFP / SOW / Q&A / tablas salariales) de PDF + DOCX + texto/HTML
• sam_attachment_url — construye la URL pública de descarga para un resourceId de adjunto
• sam_lookup_organization — id de organización federal → fullParentPathName canónico
• sam_lookup_notice_fields — rellena por lotes naics/set-aside/PoP/fecha límite anulados para 1–100 noticeIds del CSV diario opcional de GSA
• grants_search — oportunidades de subvenciones federales de Grants.gov (asistencia financiera, distinta de los contratos de SAM)
• grants_get_opportunity — detalle completo de una sola oportunidad de subvención por id

Gasto, adjudicaciones y competencia — USAspending + FPDS + GAO (31 herramientas)

• usas_search_awards — agregado de participación de gasto en agencia × NAICS
• usas_search_individual_awards — contratos federales por partida (devuelve generatedInternalId)
• usas_get_award_detail — detalle completo de adjudicación: período de ejecución, opciones, set-aside, competencia
• usas_search_awards_by_recipient — cada contrato que un beneficiario ganó en un segmento de agencia × NAICS
• usas_search_subawards — enumera subcontratos en adjudicaciones principales (cadena de suministro / formación de equipos)
• usas_search_recompetes — radar de recompetición (PoP que termina en una ventana, primero lo más próximo, sin caídas silenciosas)
• usas_search_expiring_contracts — obsoleto alias de usas_search_recompetes (forma heredada)
• usas_analyze_incumbent — pistas de incumbente por adjudicación + presión pública de recompetición (etiquetas, no una puntuación)
• usas_search_teaming_partners — descubrimiento de formación de equipos de pequeñas empresas por certificación × NAICS × agencia, con exclusión verificada
• usas_spending_over_time — serie temporal de gasto en contratos (año fiscal / trimestre / mes)
• usas_search_agency_spending — gasto desglosado por agencia adjudicadora
• usas_search_subagency_spending — desglosa una agencia principal por sub-agencia / oficina
• usas_search_psc_spending — gasto por Código de Servicio de Producto (PSC)
• usas_search_cfda_spending — gasto por código de programa de subvención CFDA
• usas_search_state_spending — gasto por estado / territorio
• usas_search_federal_account_spending — gasto por cuenta federal / Símbolo de Cuenta del Tesoro (TAS)
• usas_search_recipients — lista de beneficiarios con jerarquía padre/hijo
• usas_get_recipient_profile — detalle completo del beneficiario (UEI, nombres alternativos, totales)
• usas_get_agency_profile — perfil de agencia por código toptier (misión, abreviatura, sitio web)
• usas_get_agency_awards_summary — actividad de adjudicaciones para un año fiscal (recuento de transacciones + obligaciones)
• usas_get_agency_budget_function — desglose de función presupuestaria para una agencia × año fiscal
• usas_list_toptier_agencies — todas las agencias toptier + obligaciones del año fiscal actual
• usas_lookup_agency — resuelve 'VA' / 'DHS' → nombre toptier canónico + código de 4 dígitos
• usas_autocomplete_naics — protección anti-alucinación de NAICS
• usas_autocomplete_recipient — protección anti-alucinación de beneficiarios
• usas_naics_hierarchy — navega el árbol de NAICS (2→4→6) + recuento de contratos activos por código
• usas_glossary — 151 términos de gasto federal
• usas_list_disaster_codes — lista los Códigos de Fondo de Emergencia por Desastre (DEFC): COVID-19, IIJA/infraestructura y otras etiquetas de apropiación de emergencia
• usas_disaster_spending — gasto de fondos de desastre/emergencia POR GEOGRAFÍA para DEFCs dados (qué estado/condado/distrito capturó dinero de alivio de COVID/IIJA)
• fpds_search_awards — acciones de adjudicación de contratos federales FPDS-NG (el feed autoritativo de acciones de adjudicación)
• gao_protest_lookup — decisiones recientes de protestas de licitación de GAO del feed público RSS de Productos Legales (solo ventana reciente)

Verificación de entidades y socios — OFAC · SAM · FAC · FDIC · EPA (15 herramientas)

• ofac_screen_entity — verificación de partes denegadas / sanciones de OFAC sin clave
• sam_check_exclusions — verificación de inhabilitación/exclusión de SAM sin clave por nombre y/o UEI/CAGE
• sam_integrity_lookup — verificación de integridad en una sola llamada (veredicto de exclusión + puntero honesto de FAPIIS)
• fac_search_audits — resúmenes de Auditoría Única del Centro Federal de Auditoría
• fac_get_findings — profundiza en los hallazgos de RIESGO de auditoría para una entidad
• fdic_search_institutions — busca en el directorio de instituciones aseguradas por FDIC
• fdic_institution_financials — serie temporal financiera trimestral para una institución (por número de certificado)
• fdic_risk_ratios — ratios de riesgo de contraparte para una institución
• fdic_institution_history — registro de eventos de cambio estructural (fusiones, cambios de carta)
• fdic_branch_deposits — huella de depósitos de sucursales
• fdic_bank_failures — fallos bancarios históricos y transacciones de asistencia
• fdic_industry_summary — agregados anuales de la industria y el sector bancario estatal
• echo_search_facilities — busca instalaciones reguladas por EPA por estado con verificación de cumplimiento/aplicación
• echo_facility_report — Informe Detallado de Instalación de EPA ECHO para una instalación (por FRS RegistryID)
• epa_tri_facilities — instalaciones de EPA Envirofacts TRI (Inventario de Liberación de Tóxicos) por estado/industria (verificación ambiental / ESG)

Seguridad de productos y retiros del mercado — openFDA · NHTSA · CPSC (6 herramientas)

• openfda_enforcement — Retiros del mercado y acciones de cumplimiento de medicamentos, dispositivos y alimentos de la FDA (verificación de proveedores para seguridad de productos)
• openfda_device_clearances — Autorizaciones de dispositivos médicos 510(k) de la FDA (verificación de capacidad del fabricante de dispositivos)
• openfda_drug_approvals — Solicitudes de aprobación de medicamentos Drugs@FDA de openFDA (patrocinador, productos aprobados, historial de presentación/aprobación)
• nhtsa_recalls — Retiros de vehículos de NHTSA por marca / modelo / año
• nhtsa_complaints — Quejas de seguridad de vehículos de NHTSA por marca / modelo / año
• cpsc_recalls — Retiros de productos de consumo de CPSC (verificación de proveedores de productos)

Litigios y tribunales — CourtListener (1 herramienta)

• courtlistener_search_opinions — Opiniones de tribunales federales de EE. UU. (reclamaciones contractuales de COFC / protestas de licitación, Circuito Federal) — datos a través de CourtListener / Free Law Project (divulgado)

Proveedores sin fines de lucro — IRS 990 vía ProPublica (2 herramientas)

• nonprofit_search — Búsqueda de organizaciones sin fines de lucro IRS-990 por nombre / estado / NTEE — vía ProPublica Nonprofit Explorer (divulgado)
• nonprofit_financials — Finanzas de organizaciones sin fines de lucro IRS-990 por EIN — vía ProPublica Nonprofit Explorer (divulgado)

Divulgación financiera — SEC EDGAR (8 herramientas)

• edgar_lookup_cik — Resolver un ticker o nombre de empresa a su CIK de SEC de 10 dígitos
• edgar_company_filings — Presentaciones de SEC de una empresa
• edgar_company_facts — Datos financieros XBRL seleccionados para un declarante
• edgar_company_concept — Un declarante × un concepto XBRL × la serie temporal completa reportada
• edgar_xbrl_frames — Sección transversal XBRL entre declarantes (un concepto en todos los declarantes para un período)
• edgar_full_text_search — Búsqueda de texto completo en presentaciones de EDGAR, 2001–presente
• edgar_filing_index — Índice masivo de presentaciones entre declarantes para un trimestre
• edgar_daily_filing_index — Índice de presentaciones entre declarantes por día

Regulación y legislación — Federal Register · Regulations.gov · eCFR · FAR · Congress · GovInfo (19 herramientas)

• fed_register_search_documents — Buscar documentos del Federal Register por consulta / agencia / tipo / fecha
• fed_register_get_document — Detalle completo de un documento por número (citación, URL del cuerpo, referencias CFR)
• fed_register_public_inspection — El escritorio de inspección pública del Federal Register (pre-publicación)
• fed_register_list_agencies — Referencia de slugs de agencias del Federal Register
• regulations_search_dockets — Buscar expedientes de elaboración de normas en Regulations.gov
• regulations_search_documents — Buscar documentos de elaboración de normas en Regulations.gov (reglas, reglas propuestas, avisos)
• regulations_search_comments — Buscar comentarios públicos sobre elaboración de normas
• regulations_get_docket — Obtener un expediente de Regulations.gov por id
• ecfr_search — Búsqueda de texto completo en todo el CFR (titleNumber=48 para FAR); devuelve fragmentos clasificados + ecfrUrl
• ecfr_get_section — El texto COMPLETO de una sección del CFR por citación (cualquier título; para FAR/DFARS prefiera far_clause_lookup)
• ecfr_list_titles — Los 50 títulos del CFR + fechas de última enmienda
• far_clause_lookup — Texto autoritativo de cláusulas FAR/DFARS + su prescripción (número exacto de cláusula)
• far_search — Búsqueda limitada a FAR/DFARS (excluye GSAM, colapsa a la versión vigente actual)
• far_compliance_matrix — Lista de cláusulas citadas → matriz de cumplimiento de Sección L/M lista para propuesta (puertas de elegibilidad marcadas)
• congress_search_bills — Buscar proyectos de ley / legislación en Congress.gov
• congress_get_bill — Un proyecto de ley por congreso / tipo / número
• govinfo_search_packages — Buscar paquetes de GovInfo (autoritativo de GPO) en una colección
• govinfo_get_package — Resumen de un paquete de GovInfo + enlaces de descarga (txt/xml/pdf/mods)
• govinfo_list_collections — El catálogo de colecciones de GovInfo

Precios, mano de obra y fiscal — GSA CALC · SAM WDs · BLS · Census CBP · FRED · BEA · US Treasury · GSA per-diem (15 herramientas)

• gsa_benchmark_labor_rates — Banda de mercado de tasa máxima adjudicada de GSA CALC para una categoría laboral (una distribución, no un solo precio)
• sam_search_wage_determinations — Encontrar determinaciones de salarios SCA / Davis-Bacon para una localidad
• sam_get_wage_rates — Tabla de tasas de salario prevaleciente + beneficios / H&W analizada de un WD, más el piso de salario mínimo de la orden ejecutiva
• bls_timeseries — Series temporales de BLS (escalamiento CPI-U / ECI, PPI, empleo) — la capa de precios/escalamiento
• bls_oews_wages — Salarios y empleo ocupacionales de referencia (BLS OEWS) por área × ocupación
• bls_qcew — Tamaño de mercado / salarios / cociente de ubicación por condado × NAICS (densidad de competencia)
• treasury_debt_to_penny — Deuda pública total diaria pendiente de EE. UU. (Treasury Fiscal Data)
• treasury_avg_interest_rates — Tasa de interés promedio que el Tesoro paga por tipo de valor
• treasury_monthly_statement — Declaración Mensual del Tesoro: ingresos, desembolsos, déficit/superávit por mes
• treasury_query_dataset — Consulta de escape sobre 7 conjuntos de datos confirmados de Treasury Fiscal Data
• bea_regional_data — PIB / ingreso personal por industria × geografía (BEA Regional; requiere BEA_API_KEY gratuita)
• census_business_patterns — Establecimientos / empleo / nómina anual por NAICS × geografía (Census CBP; requiere CENSUS_API_KEY gratuita)
• fred_search_series — Buscar el catálogo de series macroeconómicas de FRED (GDP/CPI/tasas/desempleo; requiere FRED_API_KEY gratuita)
• fred_series_observations — Observaciones de series temporales para una serie de FRED (valores faltantes → null; requiere FRED_API_KEY gratuita)
• gsa_perdiem_rates — Per-diem de viajes federales: límites mensuales de alojamiento + comidas M&IE por ciudad+estado o código postal (sin clave vía DEMO_KEY)

Financiamiento de salud e investigación — NIH · NSF · ClinicalTrials · CMS · NPPES (9 herramientas)

• nih_reporter_search_projects — Proyectos de subvenciones de investigación adjudicados de NIH RePORTER
• nsf_search_awards — Premios de subvenciones de investigación adjudicados de NSF
• nsf_get_award — Un premio de NSF por su id numérico de premio
• clinicaltrials_search_studies — Estudios clínicos registrados federalmente con enriquecimiento de patrocinador/financiador
• clinicaltrials_get_study — Un estudio clínico por id de NCT (incl. resumen breve)
• clinicaltrials_facet_counts — Distribución exacta de conteo de estudios por valor sobre todo el registro
• cms_search_datasets — Descubrir conjuntos de datos de CMS Open Payments (Ley Sunshine)
• cms_query_dataset — Consultar una distribución de datastore de CMS Open Payments (pagos de industria→médicos)
• nppes_lookup_provider — Búsqueda de proveedores en el Registro NPI de NPPES de CMS/HHS

Proveedores e instalaciones de salud — CMS (5 herramientas)

• cms_medicare_provider_services — Utilización y pagos de proveedores de Medicare (dimensionamiento del mercado de salud)
• cms_hospital_compare — Calificaciones de calidad de CMS Hospital Compare
• cms_facility_directory — Directorios de instalaciones de CMS: hogares de ancianos / salud en el hogar / hospicio / diálisis
• cms_dmepos_suppliers — Directorio de proveedores de DMEPOS (equipo médico duradero) de CMS + gasto de Medicare
• cms_revoked_providers — Lista de revocaciones / exclusiones de Medicare de CMS (verificación de cumplimiento de proveedores)

Cumplimiento cibernético — NVD + CISA KEV + NIST 800-53 (3 herramientas)

• cve_lookup — Consultar registros CVE de NIST NVD
• cisa_kev_lookup — Filtrar el catálogo de Vulnerabilidades Explotadas Conocidas de CISA (fechas de remediación vinculantes de BOD 22-01)
• nist_800_53_controls — Consulta de controles de seguridad y privacidad de NIST SP 800-53 Rev 5 (texto de requisito de FedRAMP/CMMC/RMF por controlId/familia/palabra clave)

Comercio, aranceles y logística — USITC · CBP (2 herramientas)

• hts_lookup — Clasificación de aranceles de importación de EE. UU. + tasas de derechos del Arancel Armonizado de USITC
• cbp_border_wait_times — Tiempos de espera en vivo de vehículos comerciales en fronteras terrestres de CBP (puertos canadienses + mexicanos; carga/logística)

Geo, desastres y datos abiertos estatales/locales — Census · FEMA · NWS · Socrata · CKAN (10 herramientas)

• census_geocode_address — Resolver una dirección de EE. UU. de una línea → dirección coincidente + geografías del Census (tract, CD, place)
• census_geographies_by_coordinates — Resolver un punto de longitud/latitud → geografías del Census
• fema_disaster_declarations — Declaraciones de desastres / emergencias de FEMA por estado, tipo, incidente, año
• fema_search_public_assistance — Proyectos financiados de Asistencia Pública de FEMA
• fema_search_hazard_mitigation — Proyectos de Asistencia de Mitigación de Peligros de FEMA (subvenciones de mitigación HMGP/FMA/PDM/BRIC a subreceptores estatales/locales/tribales; resiliencia ante desastres, distinto de la recuperación de Asistencia Pública)
• nws_active_alerts — Alertas meteorológicas de NWS actualmente activas (vigilancias/avisos/advertencias; preparación ante desastres/clima, se combina con las herramientas de FEMA)
• socrata_discover_datasets — Encontrar ids 4x4 de conjuntos de datos de Socrata por palabra clave
• socrata_query — Consultar filas de un portal de datos abiertos Socrata/SODA en lista permitida (53 hosts federales y de condado/ciudad/estado seleccionados — checkbook, contratos, pagos a proveedores, solicitudes en vivo en el nivel SLED)
• ckan_discover_datasets — Encontrar ids de recursos de datastore de CKAN por palabra clave
• ckan_query — Consultar filas de un recurso de datastore de CKAN en lista permitida (gasto/checkbook estatal/ciudad)

Licitaciones de adquisiciones estatales/locales (SLED) — OpenGov · Bonfire · ArcGIS · Tableau · Open Checkbook (8 herramientas)

• opengov_list_governments — Directorio de 525+ gobiernos estatales/locales de EE. UU. en OpenGov Procurement (filtrar por estado/consulta)
• opengov_search_solicitations — Solicitudes públicas en vivo de un gobierno (título, estado [abierto = aceptando], fecha límite, enlace del portal) — endpoints anónimos sin clave
• bonfire_list_organizations — Directorio semilla seleccionado y verificado en vivo de 186 organizaciones de EE. UU. en Bonfire (Euna)
• bonfire_search_opportunities — Oportunidades actualmente abiertas de una organización vía RSS sin clave (referenceNumber, nombre, closeDate, enlace); el RSS es el conjunto abierto completo (total exacto)
• arcgis_hub_discover_datasets — Descubrir conjuntos de datos de ArcGIS Hub por palabra clave (la capa GIS/infraestructura/permisos/adquisiciones de SLED que Socrata y CKAN no cubren; una ayuda de descubrimiento con editor identificado para verificación)
• arcgis_feature_query — Consultar filas de una lista permitida seleccionada de 27 capas de entidades REST de ArcGIS de gobiernos de EE. UU.: solicitudes en vivo de DC OCP PASS; checkbooks/contratos de gobiernos locales; registros de licitación/adjudicación de DOT estatales (TX / AK / IA / OK); 4 capas de premios de financiamiento flexible federal de DOT de Dakota del Norte (premios de financiamiento de NDDOT a agencias públicas locales como condados, municipios y ciudades, no contratos de proveedores ni ofertas ganadoras; un proxy porque el checkbook y el portal de adquisiciones a nivel estatal de ND no son accesibles sin clave)
• tableau_view_csv — Obtener la exportación CSV completa de una vista Tableau Server Guest seleccionada de gobiernos de EE. UU. (sin clave) y paginar sobre ella; una vista hoy: Contratos Adjudicados de Montana DOA (~4,554 registros de adjudicación; la actualización la establece el editor y puede estar desactualizada)
• open_checkbook_search — Búsqueda a nivel de fila de pagos a proveedores sobre un portal de checkbook Socrata Open Expenditures seleccionado (sin clave; filtros de coincidencia exacta por año/proveedor/departamento/categoría de gasto); un portal hoy: South Dakota Open Checkbook (~740,980 pagos, solo los ~3 años fiscales más recientes; la actualización la establece el editor y puede estar desactualizada, así que ordene por payment_date desc para ver la fecha más reciente)

Descubrimiento de conjuntos de datos y registros — data.gov · get.gov (2 herramientas)

• datagov_search_datasets — Buscar el catálogo v4 de data.gov para conjuntos de datos abiertos federales en todas las agencias publicadoras
• search_gov_domains — Registro autoritativo de dominios .gov de CISA get.gov (resolver qué organización posee un dominio .gov; enumerar agencias federales + mapear entidades SLED)

Pequeñas empresas — SBA (1 herramienta)

- `sba_size_standard` — Estándar de tamaño de pequeña empresa de la SBA para un NAICS de 6 dígitos (puerta de elegibilidad para reservas de mercado)

Cumplimiento laboral — Departamento de Trabajo de EE. UU. (2 herramientas)

• dol_list_datasets — Explorar conjuntos de datos de cumplimiento/aplicación del DOL (WHD, OFCCP, …) — catálogo sin clave
• dol_get_dataset — Obtener registros de cumplimiento del DOL (WHD salario-horas / OFCCP; requiere una DOL_API_KEY gratuita)

Cabildeo e influencia — Registro de cabildeo del Senado de EE. UU. (1 herramienta)

• lda_search_filings — Declaraciones de cabildeo del Senado: quién presiona a qué agencia, sobre qué tema, por cuánto (sin clave)

Utilidades del servidor — descubrimiento de claves · comentarios (2 herramientas)

• api_key_status — Lista qué claves de API puede usar el servidor, obligatorias vs. opcionales, URL de registro y si cada una está configurada actualmente (el valor nunca se muestra)
• feedback — Devuelve un enlace de problema de GitHub prellenado para un informe de error o solicitud de función; usted lo abre y lo envía usted mismo (la herramienta nunca publica nada)

---

Fiabilidad y instantáneas sin conexión

Este servidor se basa en una regla: fallo honesto antes que fabricación confiada. Todo lo siguiente trata sobre la disponibilidad de datos públicos — nada de esto elude los controles de acceso.

Primero sin clave, y una fuente caída lanza un error. 50 de las 54 fuentes (147 de las 152 herramientas) funcionan sin clave de API; los patrones comerciales del Censo, FRED, BEA y el punto final de datos del DOL necesitan una gratuita. Cuando una fuente está limitada por tasa, bloqueada o caída, la herramienta devuelve un error tipado (rate_limited / upstream_unavailable / schema_drift / …) — nunca inventa filas y nunca informa un servicio CAÍDO como "0 resultados" o "no encontrado". Un resultado vacío genuino y una interrupción siempre son distinguibles.

Instantáneas sin conexión (activadas por defecto). Algunos datos de referencia cambian lentamente — la lista de agencias de nivel superior, el árbol NAICS de nivel superior, el glosario de USAspending, los estándares de tamaño de la SBA, el último "Deuda al centavo" del Tesoro. Por defecto, cuando una fuente federal en vivo está brevemente inalcanzable desde su salida, el servidor recurre a una instantánea pública, actualizada semanalmente de esos datos de referencia de cambio lento, alojada en raw.githubusercontent.com/cliwant/mcp-sam-gov/snapshots. Solo se obtiene en un fallo duro en vivo (una interrupción / bloqueo por reputación de IP), nunca durante la operación normal — datos públicos, sin telemetría. Una instantánea servida nunca se presenta como en vivo — la respuesta lleva _meta.dataPath: "snapshot" más una marca de tiempo asOf, y complete está forzado a desactivado, por lo que un agente de IA (y usted) siempre ve la desactualización. Un límite de tasa (429) siempre se respeta, nunca se desvía hacia el espejo.

• Desactivarlo (solo en vivo puro): establezca SAMGOV_SNAPSHOT_BASE_URL=off. Entonces nunca se agrega una ruta de instantánea y el comportamiento es byte por byte idéntico a un cliente solo en vivo.

• Apuntar a su propio espejo: establezca SAMGOV_SNAPSHOT_BASE_URL a su URL base para alojar las instantáneas usted mismo en lugar de usar el público predeterminado.

  { "mcpServers": { "sam-gov": { "command": "mcp-sam-gov",
      "env": { "SAMGOV_SNAPSHOT_BASE_URL": "off" } } } }
  

• Construir las instantáneas: ejecute node scripts/build-snapshots.mjs desde cualquier salida limpia y no bloqueada (una computadora portátil / hogar / ejecutor de CI limpio). Autodiagnostica la accesibilidad por fuente, imprime una tabla de accesibilidad y escribe un manifest.json. En cobertura parcial, actualiza solo las fuentes a las que puede llegar y deja el último archivo bueno en su lugar para el resto (desactualizado pero honesto, nunca vaciado). Sale con código distinto de cero solo cuando cero fuentes eran accesibles (una salida completamente bloqueada — la señal para volver a ejecutar desde una más limpia).

• El límite honesto. Esto cubre solo la disponibilidad de datos públicos. El constructor de instantáneas ingiere solo datos públicos, redistribuibles (dominio público / CC0), y el lector se niega a servir cualquier sobre no marcado con accessLevel: "public". Respeta los límites de tasa (un 429 nunca se desvía), usa sin proxies, sin rotación de IP, sin evasión de autenticación/paywall/CAPTCHA, y rechaza redirecciones fuera del host. Si una fuente está bloqueada, el remedio honesto es construir desde una salida más limpia — no evadir el bloqueo.

---

Solución de problemas

Síntoma	Solución
El menú 🔨 de Claude Desktop no muestra sam-gov	Cierre completamente Claude Desktop (bandeja del sistema en Windows / menú Salir en macOS) y vuelva a abrirlo. Verifique %APPDATA%\Claude\logs\mcp*.log
command not found: mcp-sam-gov	Confirme que npm install -g . tuvo éxito; verifique que el bin global de npm esté en PATH (npm config get prefix)
spawn npx ENOENT (Windows, configuración de npx)	El host inició npx sin un shell, por lo que Windows no puede encontrar npx.cmd. Use "command": "cmd", "args": ["/c", "npx", "-y", "@cliwant/mcp-sam-gov"].
MODULE_NOT_FOUND ...dist/server.js después de npm install -g github:...	Error de npm con enlaces simbólicos de dependencias git en Windows. Use la receta de clonación + npm install -g . (Ruta 3) en su lugar.
EPERM: operation not permitted, rmdir durante la instalación	Una instalación fallida anterior dejó archivos colgantes. Ejecute rmdir /s /q "%APPDATA%\npm\node_modules\@cliwant" (o @govicon si instaló una versión temprana) y luego reintente.
npm install falla con "repositorio privado" / 404	El repositorio ahora es público — no debería suceder. Si ocurre, intente git clone https://github.com/cliwant/mcp-sam-gov.git directamente.
Las herramientas devuelven resultados vacíos	SAM.gov limita la tasa a llamadores agresivos. Espere 1 minuto. O establezca SAM_GOV_API_KEY para la ruta autenticada de mayor tasa.
"Error de herramienta: USAspending POST devolvió 400"	Generalmente significa que un campo tiene un tipo incorrecto (por ejemplo, año fiscal como cadena). Verifique el esquema de entrada de la herramienta en el navegador de herramientas de su host.

---

Uso como biblioteca de TypeScript / JavaScript (sin MCP)

Más allá del servidor MCP, este paquete también exporta los clientes de datos federales subyacentes como módulos importables. Útil si está construyendo su propio SaaS, agente de IA o CLI y desea acceso programático sin iniciar un servidor MCP.

npm install @cliwant/mcp-sam-gov

// SAM.gov client
import { SamGovClient } from "@cliwant/mcp-sam-gov/sam-gov";

const sam = new SamGovClient(); // keyless
const result = await sam.searchOpportunities({ ncode: "541512", limit: 5 });
const opp = await sam.getOpportunity("5ef3db5daeb54099a96d487783a38bd0");

// USAspending wrappers
import * as usas from "@cliwant/mcp-sam-gov/usaspending";

const recompete = await usas.searchExpiringContracts({
  agency: "Department of Veterans Affairs",
  naics: "541512",
  monthsUntilExpiry: 12,
});
const recipient = await usas.getRecipientProfile("ed02855e-60d7-2540-...-P");

// Federal Register / eCFR / Grants.gov
import * as fedreg from "@cliwant/mcp-sam-gov/federal-register";
import * as ecfr from "@cliwant/mcp-sam-gov/ecfr";
import * as grants from "@cliwant/mcp-sam-gov/grants";

const farResults = await ecfr.search({ query: "SDVOSB", titleNumber: 48 });

Este es el hogar canónico de las bibliotecas de datos federales de Cliwant — no hay un paquete de biblioteca separado. Dos repositorios anteriores (govicon-sam-gov y govicon-mcp-sam-gov) han sido archivados y consolidados aquí. Todo el código de cliente vive en src/sam-gov/, src/usaspending.ts, src/federal-register.ts, src/ecfr.ts, src/grants.ts.

Política de privacidad

Este servidor se ejecuta localmente y no recopila nada — sin telemetría, sin análisis, sin cuentas. Sus indicaciones y resultados se procesan en memoria en su máquina y nunca se envían a Cliwant. Cada herramienta llama a la API oficial del gobierno correspondiente directamente a través de HTTPS; las claves de API opcionales permanecen en su entorno local y se envían solo a esa fuente. Consulte la Política de privacidad completa (contacto: seungdo.keum@cliwant.com).

Licencia

MIT — consulte LICENCIA.

Aviso legal

Este es un proyecto independiente de código abierto. No está afiliado, respaldado ni patrocinado por la Administración de Servicios Generales, SAM.gov, USAspending.gov, la Oficina del Registro Federal, los Archivos Nacionales, Grants.gov, ni ninguna agencia gubernamental federal, estatal o local. Utiliza solo públicamente disponibles puntos finales de datos abiertos del gobierno; los datos federales de adquisiciones, gastos y regulaciones son de dominio público.