Clearon Legislation Monitor MCP

Servidor MCP para el descubrimiento de legislación de EE. UU. con revisión previa y la monitorización de listas de seguimiento.

Separa las pistas de descubrimiento de las entradas verificadas de la lista de seguimiento, registra observaciones y excepciones de solo adición, y mantiene la revisión de fuentes oficiales en el proceso antes de que una medida se convierta en autoritativa.

Qué hace

• Registra candidatos de descubrimiento sin promoverlos silenciosamente a la lista de seguimiento

• Requiere revisión humana explícita antes de su aceptación en la lista de seguimiento

• Realiza seguimiento de observaciones de fuentes oficiales, revisiones pendientes y excepciones de recuperación

• Reproduce un registro de eventos de solo adición en una instantánea reconstruible

• Opcionalmente usa Open States y NYC Legistar como asistentes de descubrimiento, nunca como prueba definitiva

Related MCP server: universal-research-mcp

Qué no hace

• No publica contenido ni modifica WordPress

• No trata una coincidencia de palabras clave como verificación legal

• No otorga a los resultados de descubrimiento de terceros la condición de fuente de registro

• No convierte los fallos de recuperación en cambios de estado legal

Requisitos

• Node.js 20 o superior

• Un cliente MCP local que pueda lanzar un servidor stdio

Instalación

cd tools/clearon-legislation-monitor-mcp
npm install
npm test
npm run smoke

Configuración del cliente MCP

Ejemplo de configuración stdio:

{
  "mcpServers": {
    "clearon-legislation-monitor": {
      "command": "node",
      "args": ["/absolute/path/to/clearon-legislation-monitor-mcp/server.mjs"],
      "env": {
        "CLEARON_LEGISLATION_WORKSPACE": "/absolute/path/to/workspace"
      }
    }
  }
}

Si sus entradas normalizadas del rastreador no están en las ubicaciones predeterminadas del espacio de trabajo, establezca también:

• CLEARON_LEGISLATION_REGISTRY_PATH

• CLEARON_LEGISLATION_WATCHLIST_PATH

Almacenamiento

De forma predeterminada, el estado del monitor se almacena fuera del repositorio en un directorio de datos de usuario:

• macOS: ~/Library/Application Support/clearon-legislation-monitor-mcp/legislation-monitor

• Linux: ${XDG_DATA_HOME:-~/.local/share}/clearon-legislation-monitor-mcp/legislation-monitor

• Windows: %APPDATA%\\clearon-legislation-monitor-mcp\\legislation-monitor

Anule esa ubicación con CLEARON_LEGISLATION_MONITOR_ROOT.

Se espera que las entradas canónicas del rastreador sigan proviniendo del espacio de trabajo elegido:

• trackers/state-legislation/jurisdictions.json

• trackers/state-legislation/watchlist.csv

a menos que las anule explícitamente con variables de entorno.

Credenciales

Las claves de proveedor opcionales se pueden suministrar directamente en el entorno:

• OPENSTATES_API_KEY

• NYC_LEGISTAR_TOKEN

El servidor también admite un archivo de secretos local opcional. De forma predeterminada, busca en:

• macOS: ~/Library/Application Support/openclaw/local-secrets.json

• Linux: ${XDG_CONFIG_HOME:-~/.config}/openclaw/local-secrets.json

• Windows: %APPDATA%\\openclaw\\local-secrets.json

Anule esa ruta con OPENCLAW_LOCAL_SECRETS.

Instale o rote las credenciales almacenadas a través de stdin protegido para que los valores no queden en el historial del shell:

node bin/install-credentials.mjs < /path/to/private-credentials.json
npm run credentials

Claves JSON admitidas:

{
  "openstatesApiKey": "provider-issued value",
  "nycLegistarToken": "provider-issued value"
}

Flujo de trabajo recomendado

1. Llame a list_jurisdictions para elegir la ruta oficial.

2. Use scan_official_source, search_openstates_bills o search_nyc_legistar_matters para recopilar pistas.

3. Registre medidas plausibles de fuentes oficiales con record_discovery_candidate.

4. Revise cada candidato y llame a review_candidate con accept o reject.

5. Registre observaciones oficiales con record_measure_observation.

6. Use get_due_reviews y get_exceptions para el seguimiento programado.

Herramientas

• get_server_health

• list_jurisdictions

• scan_official_source

• search_openstates_bills

• search_nyc_legistar_matters

• record_discovery_candidate

• list_discovery_candidates

• review_candidate

• import_normalized_watchlist

• list_watchlist

• record_measure_observation

• dedupe_watchlist_measures

• record_exception

• resolve_exception

• get_due_reviews

• get_exceptions

• verify_event_log

Desarrollo

npm test
npm run smoke
npm run syntax