ecfr-mcp

Servidor MCP para la API de eCFR (Código Electrónico de Regulaciones Federales). Lee el texto de FAR, DFARS y todos los suplementos FAR de las agencias sin necesidad de autenticación.

El uso independiente de MCP es una ruta avanzada y autogestionada; los agentes empaquetados son la ruta de entrada con mantenimiento.

Probado y reforzado mediante seis rondas de pruebas de integración contra la API en vivo de eCFR. 295 pruebas de regresión (182 sin conexión, 113 condicionadas a la API en vivo) que cubren 2 errores catastróficos P0, 26 errores P1 de datos incorrectos silenciosos, 32 carencias de validación P2 y las correcciones de la auditoría de la ronda 6 (lista blanca de capítulos del Título 48, extracción de tablas, acceso a apéndices). Consulta testing.md para obtener el registro completo de pruebas.

Qué hace

Expone la API de eCFR como 13 herramientas MCP que cubren texto normativo, estructura, búsqueda, historial de versiones y flujos de trabajo habituales de contratación:

Endpoints principales

• get_latest_date - Obtén la fecha disponible más reciente de un título del CFR (llámalo antes que otras herramientas)

• get_cfr_content - Obtén el texto normativo procesado de una sección, subparte o parte

• get_cfr_structure - Tabla de contenidos jerárquica

• get_version_history - Historial de enmiendas de una sección o parte

• get_ancestry - Ruta jerárquica de migas de pan

• search_cfr - Búsqueda de texto completo con filtros jerárquicos

• list_agencies - Todas las agencias con sus referencias al CFR

• get_corrections - Correcciones editoriales para un título

Comodidades de flujo de trabajo

• lookup_far_clause - Consulta del texto de una cláusula FAR/DFARS en una sola llamada (resuelve la fecha automáticamente)

• compare_versions - Comparación de texto en paralelo en dos fechas

• list_sections_in_part - Todas las secciones de una parte FAR/DFARS

• find_far_definition - Busca la definición de un término en FAR 2.101

• find_recent_changes - Secciones modificadas desde una fecha determinada

Related MCP server: regulationsgov-mcp

No se requiere autenticación

La API de eCFR es totalmente pública. No se necesita clave de API, ni registro, ni cabeceras de autenticación. Solo instala y usa.

Instalación

Vía uvx (recomendado)

uvx ecfr-mcp

Vía pip

pip install ecfr-mcp

Desde el código fuente

git clone https://github.com/1102tools-dev/federal-contracting-mcps.git
cd federal-contracting-mcps/servers/ecfr-mcp
pip install -e .

Configuración

MCP es un estándar abierto, y los clientes compatibles pueden ejecutar este servidor. La Guía de configuración de agentes de 1102tools mantenida cubre los agentes empaquetados en Codex y Claude Code, no la configuración independiente del servidor. Usa el bloque siguiente como definición del servidor y adapta su ubicación a tu cliente.

{
  "mcpServers": {
    "ecfr": {
      "command": "uvx",
      "args": ["--refresh-package", "ecfr-mcp", "--from", "ecfr-mcp", "ecfr-mcp"]
    }
  }
}

El indicador --refresh-package le indica a uv que compruebe en PyPI si hay una versión más reciente cada vez que tu cliente lance el servidor, de modo que las correcciones llegan automáticamente; sin él, uv sigue sirviendo la versión que al macenó en primer lugar. Añade una breve tempo de red al arranque, así que sube el tiempo de espera de arranque de MCP de tu plataforma si impone un tiempo corto.

Reinicia el cliente. El servidor ecfr apare cen con 13 herramientas.

Prompts de ejemplo

• "Obtén el texto actual de FAR 15.305 (Evaluación de Propuestas) y resume lo que exige."

• "Enúmero todas las secciones de FAR Parte 6 (Programas de Pequeñas Cesas)."

• "Busca en FAR 2.101 la definición de 'comercial product'."

• "¿Qué secciones de FAR se modificaron en los últimos 6 meses?"

• "Compara FAR 52.212-f5564 entre 2024-01-01 y 2025-01-01 y muestrame qué cambió."

• "Obten el texto actual de DF AR 252.171-701 (Derechos en software informático no comercial)."

• "Busca en el Título 48 'organizacional conflict of interest' and muéstrame las secciones relevantes."

• "¿Qué agencia es dueña del capítulo 8 del Título 48? Obten la estructura ora estructura de su suplamento FAR."

Notas de disenño

1. El XML se procesa en el servidor. The endpoint de contenido de eCFR devuelve XML crudo. Este servidor lo convierte en texta no limpio (encabezados, párrafox a los modelo, ahorrando mas de contenid).

2. Resolución automática de fechas. eCFR va con 1-2 días hábiles de retraso respecto al Federal Register. Usar la fecha de hoy en los puntos finales de versión provoca errores 404. Todas las herramientas de contenido se resuelven automáticamente a la última fecha disponible a menos que especifiques una.

3. La búsqueda por defecto usa el texto actual. Sin date=current, la búsqueda del eCFR devuelve TODAS las versiOnes históicas incluidas las superadas. El valor por defect current_only=actual evita resultados duplicados.

4. Limitación del endpoint de la estructura. El endpoint de estructura de laeCFR no admite el filtrado a nivel de sección (devuelve 400). list_sections_in_part lo soluciona obtiendo la estructura de la parte y recorriendo el árbol.

5. Optimización de la FAR 2.101. La sección de definiciones es de unos ~109KB de XML que devuelve. find_far_definition parsea la sección completa en el servidor y devuelve solo los párrafos coincidentes con contexto.

Referencia rápida del Título 48 del CFR

Fuente de datos

Todos los datos proceden de ecfr.gov, el Código de Reglamentos Federales en línea actualizado continuamente y mantenido por la Oficina del Registrove. Actua diariamente, mientras que 1-2 días de trabajo. No es una edición legal oficial; para citas oficiales, consulta el CFR annual de la GPO.

Parte de

federal-contracting-mcps: monorepo de 9 servidores MCP para datos de contratación pública federal. Compañero de federal-contracting-skills.

Ritmo de solicitudes

Toda solicitud a la API externa usa por defecto un intervalo provisional de 3 segundos entre procesos para evitar ráfagas. eCFR no publica un límite numérico, así que esto es una salvaguarda de 1102tools más que un requisito del proveedor. Se invalida con FEDERAL_API_MIN_INTERVAL_SECONDS, usa 0 para desactivarlo deliberadamente, y FEDERAL_API_PACING_DIR ubica el estado de ritmo en otra localización.

Licencia

MIT