CongressMCP

CongressMCP

Datos legislativos de EE. UU. en vivo para cualquier cliente MCP: Claude Code, ChatGPT, Copilot, Codex, Cursor, OpenCode, Gemini CLI, Grok Build y más.

Proyectos de ley, texto completo de proyectos de ley, votaciones, miembros, comités, audiencias, nominaciones y el Registro del Congreso — consultados en lenguaje natural a través del Protocolo de Contexto de Modelo. Se ejecuta localmente en tu máquina contra las API gratuitas de Congress.gov y GovInfo. Sin cuenta, sin servicio alojado, sin telemetría.

Inicio Rápido

1. Obtén una clave gratuita de la API de Congress.gov

Regístrate en api.congress.gov/sign-up — toma 30 segundos. La misma clave también funciona para GovInfo (texto completo de proyectos de ley).

2. Instala uv

CongressMCP está publicado en PyPI y se lanza con uvx, que se incluye con uv:

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

(brew install uv, winget install astral-sh.uv y pipx install uv también funcionan.) ¿Prefieres pip? pip install congressmcp te da un comando congressmcp que puedes usar en lugar de uvx congressmcp a continuación.

3. Conecta tu cliente

Cada cliente necesita los mismos tres datos: comando uvx, argumentos ["congressmcp"], entorno CONGRESS_API_KEY. Los clientes están listados aproximadamente por cuántos desarrolladores profesionales los usan hoy en día (encuesta del Ecosistema de Desarrolladores de JetBrains, mediados de 2026, luego la encuesta de herramientas de 2026 de Pragmatic Engineer), así que el que buscas probablemente esté cerca de la parte superior:

Cualquier cosa no listada que hable MCP sobre stdio funcionará con los mismos tres valores.

# just for you
claude mcp add congressmcp --env CONGRESS_API_KEY=your-api-key-here -- uvx congressmcp

# shared with your team via .mcp.json in the repo root
claude mcp add --scope project congressmcp --env CONGRESS_API_KEY='${CONGRESS_API_KEY}' -- uvx congressmcp

{
  "mcpServers": {
    "congressmcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["congressmcp"],
      "env": { "CONGRESS_API_KEY": "${CONGRESS_API_KEY}" }
    }
  }
}

{
  "inputs": [
    {
      "type": "promptString",
      "id": "congress-api-key",
      "description": "Congress.gov API key",
      "password": true
    }
  ],
  "servers": {
    "congressmcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["congressmcp"],
      "env": { "CONGRESS_API_KEY": "${input:congress-api-key}" }
    }
  }
}

codex mcp add congressmcp --env CONGRESS_API_KEY=your-api-key-here -- uvx congressmcp

[mcp_servers.congressmcp]
command = "uvx"
args = ["congressmcp"]
env_vars = ["CONGRESS_API_KEY"]   # forward from your shell — nothing secret in the file

{
  "mcpServers": {
    "congressmcp": {
      "command": "uvx",
      "args": ["congressmcp"],
      "env": { "CONGRESS_API_KEY": "${env:CONGRESS_API_KEY}" }
    }
  }
}

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "congressmcp": {
      "type": "local",
      "command": ["uvx", "congressmcp"],
      "environment": { "CONGRESS_API_KEY": "your-api-key-here" },
      "enabled": true
    }
  }
}

gemini mcp add -s user -e CONGRESS_API_KEY=your-api-key-here congressmcp uvx congressmcp

{
  "mcpServers": {
    "congressmcp": {
      "command": "uvx",
      "args": ["congressmcp"],
      "env": { "CONGRESS_API_KEY": "$CONGRESS_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "congressmcp": {
      "command": "uvx",
      "args": ["congressmcp"],
      "env": { "CONGRESS_API_KEY": "your-api-key-here" }
    }
  }
}

{
  "mcpServers": {
    "congressmcp": {
      "command": "uvx",
      "args": ["congressmcp"],
      "env": { "CONGRESS_API_KEY": "${env:CONGRESS_API_KEY}" }
    }
  }
}

{
  "context_servers": {
    "congressmcp": {
      "command": "uvx",
      "args": ["congressmcp"],
      "env": { "CONGRESS_API_KEY": "your-api-key-here" }
    }
  }
}

{
  "mcpServers": {
    "congressmcp": {
      "command": "uvx",
      "args": ["congressmcp"],
      "env": { "CONGRESS_API_KEY": "your-api-key-here" },
      "disabled": false,
      "autoApprove": []
    }
  }
}

extensions:
  congressmcp:
    name: congressmcp
    type: stdio
    cmd: uvx
    args: [congressmcp]
    envs: { "CONGRESS_API_KEY": "your-api-key-here" }
    enabled: true
    timeout: 300

grok mcp add congressmcp -- uvx congressmcp      # add --scope project for .grok/config.toml

[mcp_servers.congressmcp]
command = "uvx"
args = ["congressmcp"]
env = { CONGRESS_API_KEY = "${CONGRESS_API_KEY}" }

mcp_servers:
  congressmcp:
    command: "uvx"
    args: ["congressmcp"]
    env:
      CONGRESS_API_KEY: "${CONGRESS_API_KEY}"   # or a literal key
    enabled: true

openclaw mcp add congressmcp --command uvx --arg congressmcp --env CONGRESS_API_KEY=your-api-key-here

{
  mcp: {
    servers: {
      congressmcp: {
        command: "uvx",
        args: ["congressmcp"],
        env: { CONGRESS_API_KEY: "your-api-key-here" },
      },
    },
  },
}

mcpServers:
  - name: congressmcp
    type: stdio
    command: uvx
    args:
      - congressmcp
    env:
      CONGRESS_API_KEY: ${{ secrets.CONGRESS_API_KEY }}

4. Comienza a hacer preguntas

"Encuentra proyectos de ley recientes sobre cambio climático en el 119.º Congreso" "¿Dónde en el NDAA del FY2026 está la financiación del rompehielos de la Guardia Costera?" "¿Cómo votaron los senadores de California en el último proyecto de ley de defensa?" "¿Quiénes son los miembros del Comité Judicial del Senado?" "¿Cuál es la última acción sobre H.R. 1234?"

Modo remoto / HTTP

Para clientes que se conectan por URL (conectores de ChatGPT, Claude.ai, Open WebUI, o varios usuarios compartiendo una instalación), ejecuta el servidor sobre Streamable HTTP:

CONGRESS_API_KEY=your-key congressmcp --transport streamable-http --host 0.0.0.0 --port 8000
# MCP endpoint: http://<host>:8000/mcp

CongressMCP no tiene autenticación integrada. El servidor está diseñado para ejecutarse en tu propia máquina. Si lo expones más allá de localhost, colócalo detrás de algo que autentique — un proxy inverso con una política de acceso, un túnel HTTPS con una lista de permitidos, o una VPN — y recuerda que cualquiera que pueda alcanzarlo está gastando tu cuota de Congress.gov. ChatGPT y Claude.ai además requieren HTTPS en un nombre de host resoluble públicamente.

Herramientas

7 conjuntos de herramientas, más de 90 operaciones que cubren la API de Congress.gov, además de recuperación de texto completo de proyectos de ley desde GovInfo:

search_committees y search_summaries toman un argumento keywords opcional — omítelo para explorar/listar (los comités también se pueden filtrar por chamber/committee_type).

Búsqueda de texto completo de proyectos de ley

Qué cambió: en lugar de actuar como proxy de las respuestas de la API, CongressMCP obtiene el XML DTD completo del proyecto de ley desde GovInfo, lo analiza localmente, construye un índice SQLite FTS5 a nivel de segmento por versión del proyecto de ley, y devuelve secciones de proyectos de ley específicas y direccionables en lugar de XML crudo de varios megabytes o páginas completas renderizadas. Los índices se persisten en disco y se reutilizan entre llamadas y reinicios.

No se necesita una nueva clave de API. GovInfo y Congress.gov están ambos detrás de api.data.gov, por lo que CongressMCP reutiliza tu CONGRESS_API_KEY existente para ambos; establece GOVINFO_API_KEY solo si quieres una clave separada de GovInfo. (La gente asume que se requiere una segunda clave. No es así.)

Dónde viven los datos. Un archivo SQLite por versión de proyecto de ley (<package_id>.v<N>.db, p. ej. BILLS-119s1071enr.v1.db) bajo packages/ en la raíz de caché, más un pequeño índice manifest.db. La raíz de caché es CONGRESSMCP_CACHE_DIR si está establecida, de lo contrario el valor predeterminado de la plataforma:

Cuánto disco. Limitado a 500 MB por defecto (CONGRESSMCP_CACHE_MAX_BYTES, bytes), aplicado mediante evicción de menos recientemente usado después de cada escritura de índice. Un proyecto de ley inscrito a escala NDAA (S.1071/119, 1,448 unidades indexadas) construye un índice de 11 MB; la mayoría de los proyectos de ley son mucho más pequeños. Inspecciona o vacía la caché desde la línea de comandos — deliberadamente no es una herramienta MCP:

congressmcp cache info          # path, cap, total bytes, one line per package
congressmcp cache clear --yes   # remove every package file and the manifest

Eliminar el directorio de caché manualmente también es seguro en cualquier momento; los archivos son una caché, no un almacén.

Latencia de primera llamada — medida, no estimada. En frío (nada en caché) en S.1071/119: 4.1–6.8 s de extremo a extremo entre ejecuciones, de los cuales la resolución de versión de congress.gov + el resumen del paquete de GovInfo tomaron 3.0–3.4 s, la descarga XML 1.1–2.3 s, el análisis 0.75 s, y la construcción FTS5 0.31 s — las partes de red son las lentas y variables, y son la parte que la caché elimina. En caliente (índice y resolución de versión en caché): 30–60 ms, sin red. Cada respuesta lleva un bloque timing (resolve_ms, download_ms, parse_ms, index_ms, search_ms, total_ms; una etapa es null cuando no se ejecutó) y un bloque cache (index_hit, version_hit), para que puedas ver qué caso obtuviste. Implicación de tiempo de espera del cliente: establece el tiempo de espera por llamada de tu cliente MCP a al menos 30 s; una llamada en frío a escala NDAA bajo una red lenta puede exceder un valor predeterminado de 10 s y el trabajo parcial no se pierde — la siguiente llamada estará en caliente.

Comportamiento sin conexión. Una versión que hayas obtenido explícitamente (version="enr") es completamente consultable sin conexión mientras permanezca en la caché; las versiones explícitamente en caché se vuelven a verificar contra el lastModified de GovInfo solo cada CONGRESSMCP_REVALIDATE_DAYS (30) y se reconstruyen si el paquete fue reemitido. Con version omitido, la respuesta de "última versión" se almacena en caché durante CONGRESSMCP_VERSION_TTL (86400 s = 1 día; version_resolution: "cached"); pasado el TTL se vuelve a resolver, y si la red no está disponible, la última respuesta se sirve con el mejor esfuerzo y etiquetada version_resolution: "cached_offline" con la marca de tiempo de resolución y una nota de que puede existir una versión más nueva. Si no hay nada en caché y la red está caída, obtienes version_resolution_unavailable, que enumera las versiones de ese proyecto de ley que están en caché para que puedas fijar una.

Salida de red. Exactamente dos hosts: api.congress.gov (metadatos de proyecto de ley y versión de texto) y api.govinfo.gov (contenido del proyecto de ley). Ambos limitados de forma independiente por api.data.gov (20,000/h y 36,000/h), por lo que la indexación no puede agotar las otras herramientas.

Establecer CONGRESSMCP_CACHE_ENABLED=false desactiva todo esto: cada llamada vuelve a descargar, reanaliza y reindexa el documento completo en memoria — latencia a escala NDAA, cada vez. Existe para diagnóstico, no para uso normal.

La respuesta de búsqueda distingue coincidencias en segmentos operative, quoted y header. Si quoted aparece en match_contexts, la coincidencia puede incluir lenguaje que el proyecto de ley está eliminando, incluso cuando operative también aparece; recupera la sección antes de sacar conclusiones sobre lenguaje de tachar e insertar.

Cada coincidencia también lleva matched_queries — el subconjunto de tus consultas que la produjo. Léelo antes de razonar sobre el comportamiento de recuperación: en una llamada de múltiples consultas, atribuye cada coincidencia a su consulta de origen, por lo que un resultado inesperado se explica por el campo, no adivinando los internals del tokenizador.

amends resuelve solo citas del Código de los EE. UU. (la forma larga Section {sec} of title {title}, United States Code y la forma abreviada {title} U.S.C. {sec} cuando sigue un verbo de enmienda). No resuelve leyes nombradas, incluido el Código de Rentas Internas citado por número de sección desnudo — por lo que la mayoría de las unidades de impuestos del Título VII reportan is_amendatory: true con amends: []. Usa is_amendatory y match_contexts para identificar texto de enmienda; amends es una conveniencia, no una garantía de completitud.

Ejecución desde el código fuente

git clone https://github.com/amurshak/congressMCP
cd congressMCP
pip install -e .

# stdio (default — for MCP clients)
CONGRESS_API_KEY=your-key congressmcp

# HTTP (for self-hosting / remote access)
CONGRESS_API_KEY=your-key congressmcp --transport streamable-http --port 8000

Apunta un cliente a un checkout del código fuente usando "command": "congressmcp" (con el venv activado o su bin/ en PATH) o "command": "/path/to/venv/bin/congressmcp" en lugar de uvx.

Configuración

CLI de caché (la caché se administra desde la línea de comandos, nunca a través de una herramienta MCP):

congressmcp cache info          # exit 0
congressmcp cache clear --yes   # exit 0; without --yes in a non-interactive shell it refuses with exit 1

Solución de problemas

• "command not found: uvx" en un cliente GUI (Claude Desktop, Zed, LM Studio, JetBrains): usa la ruta absoluta de which uvx (macOS/Linux) o where uvx (Windows) como command.
• Windows: si un cliente no puede iniciar uvx directamente, usa "command": "cmd", "args": ["/c", "uvx", "congressmcp"].
• El primer inicio es lento: uvx descarga y almacena en caché el paquete en la primera ejecución; los inicios posteriores son rápidos. Fija una versión con uvx congressmcp@2.2.0 si quieres reproducibilidad.
• 401 / 403 de la API: la clave falta o es incorrecta. Confirma que funciona con curl "https://api.congress.gov/v3/bill?api_key=YOUR_KEY&limit=1".
• Herramientas faltantes en el cliente: la mayoría de los clientes necesitan un reinicio o una recarga explícita de MCP después de editar la configuración.

Contribuir

Consulta CONTRIBUTING.md para el proceso completo: fork, rama, estilo de código, convenciones de commits y cómo enviar una solicitud de pull.

Licencia

Licencia de Uso Sostenible

Construido para la transparencia gubernamental y datos cívicos accesibles.