Bill Commons

Name: Bill Commons
Author: GDACS-droid

de GDACS-droidversión 1.0.0i★ –iSe ejecuta en la nube

Nombre en el registroorg.billcommons/bill-commons

Instalar

Resumen

Descripción del creador (original en inglés)

Search 209k+ US state bills, all 50 states + DC: full text, sponsors, votes, status. Free.

Los tres pilares de PopNx MCP

Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.

Opinión de usuariosiAún no hay reseñasLas reseñas se abrirán junto con las cuentas en una etapa posterior
Nuestras revisiones básicasi1 de 1 superadasRevisado con información pública; el código aún no se ha escaneado
UsoiAún sin medir★ –

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

Conexión: Se ejecuta en la nube
Transporte: Streamable HTTP
Categoría: Búsqueda y memoria de IA

Instalación

Elige la app de IA que usas y copia la configuración.

Antes de instalar

Revisiones básicas: 1 de 1 superadas
Se ejecuta en el servidor del creador: lo que le pidas pasa por su servidor.
El registro no indica ninguna clave que completar.

Necesitas

Se ejecuta en la nubeNo hay nada que instalar; se conecta por internet

¿Qué app usas?

ClaudeClaude CodeCursorVS CodeChatGPT

Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.

Funciona en Claude para web, escritorio y móvil:

Abre Settings → Connectors
Presiona Add custom connector
Pega la dirección de abajo y presiona Add
Si te pide iniciar sesión, inicia sesión en el servicio del creador

https://mcp.billcommons.org/mcp

Ejecuta esto en tu terminal

claude mcp add --transport http bill-commons https://mcp.billcommons.org/mcp

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json

{
  "mcpServers": {
    "bill-commons": {
      "url": "https://mcp.billcommons.org/mcp"
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

{
  "servers": {
    "bill-commons": {
      "type": "http",
      "url": "https://mcp.billcommons.org/mcp"
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

ChatGPT solo se conecta a servidores en internet:

Abre ChatGPT en la web → Settings → Connectors (Apps)
Presiona Create o Add (en algunos planes primero hay que activar Developer mode en Advanced)
Pega la dirección de abajo, ponle un nombre y guarda
Si te pide iniciar sesión, inicia sesión en el servicio del creador

https://mcp.billcommons.org/mcp

Los nombres de los menús pueden variar un poco según el plan y con el tiempo.

Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

Qué puede hacer

Todavía no hemos leído la lista de herramientas de este servidor; revisamos los endpoints por turnos.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 6 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con el dominio billcommons.org (el registro comprueba quién es dueño del dominio)
… Aún sin revisar
Sigue en mantenimiento
Todavía no hemos leído este repo en GitHub
… Aún sin revisar
Tiene licencia
Todavía no hemos leído este repo en GitHub
… Aún sin revisar
El endpoint responde
Aún sin revisar; revisamos los endpoints por turnos
… Aún sin revisar
Inicio de sesión con OAuth
Aún sin revisar; revisamos los endpoints por turnos
… Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Aún sin revisar; leemos la lista de herramientas cuando revisamos el endpoint

Comparado con otros en Búsqueda y memoria de IAi

Más estrellas que el 0% de los otros 7246 servidores de esta categoría
Publicado en el registro más recientemente que el 26% de los otros 7246 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 7246 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Bill Commons?

Superó 1 de 1 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en la nube del creador. Te conectas por internet sin instalar nada, pero lo que envías pasa por los servidores del creador.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez –, y la última versión (1.0.0) llegó al registro hace 3 meses.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también funcionan las apps que aceptan servidores MCP remotos, como ChatGPT en modo desarrollador.

¿Qué puedo usar en su lugar?

En la misma categoría: Context7, Codebase Memory, Exa

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Context7

de upstash

Up-to-date docs for AI agents

Computadora o nube★ 64.224MITActualizado hoy

Instalar

Codebase Memory

de DeusData

Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.

Se ejecuta en tu computadora★ 48.148MITActualizado hace 20 días

Instalar

Exa

de exa-labs

Connect AI agents to Exa for web search, content fetching, and multi-step research.

Se ejecuta en la nube★ 5213MITActualizado el mes pasado

Instalar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

Bill Commons

Bill Commons is a public, open-source legislative search platform covering the current session/biennium for all 50 U.S. states plus DC. It provides a web search UI, a REST API, an MCP (Model Context Protocol) server, and a public status/coverage page. Public infrastructure first: no paywall on ordinary search or reasonable API use — anonymous callers get a generous daily cap (2,000 requests/day per IP, 5,000/day per /24 subnet); a free API key raises that further, and only high-volume/bulk use is paid. See /docs/bulk for API keys and full-corpus snapshots.

See docs/architecture/ARCHITECTURE.md for the locked architecture and data model.

Production

Web: https://billcommons.org (search UI + public status/coverage page at https://status.billcommons.org)
API: https://api.billcommons.org/api/v1 — interactive OpenAPI docs at https://api.billcommons.org/docs
MCP (Streamable HTTP): https://mcp.billcommons.org/mcp

Hosted on Railway (project billcommons: api, mcp, worker services + managed Postgres) and Vercel (project billcommons-web). See docs/operations/deployment-runbook.md for the full deploy/rollback procedure.

Use with Claude (or any MCP client)

The hosted MCP server gives AI assistants direct access to all 209k+ bills — no API key, no setup beyond one command:

claude mcp add bill-commons --transport http https://mcp.billcommons.org/mcp

Claude Desktop: Settings → Connectors → Add custom connector with URL https://mcp.billcommons.org/mcp. Cursor and other clients: add the same URL as a Streamable HTTP server in mcp.json.

Ten tools including search_legislation, get_bill_record, compare_bill_versions, and trace_legislative_history. Full walkthrough (including REST recipes for agents without MCP): https://billcommons.org/docs/agents

Architecture at a glance

                    ┌─────────────┐

users ─────────▶ │ apps/web │ Next.js, billcommons.org │ (Vercel) │ status.billcommons.org (rewrite → /coverage) └──────┬──────┘ │ HTTPS (NEXT_PUBLIC_API_BASE) ▼ ┌─────────────┐ ┌──────────────┐ │ apps/api │◀──────▶│ apps/mcp │ Streamable HTTP │ FastAPI │ │ 10 MCP tools│ mcp.billcommons.org │ /api/v1 │ └──────────────┘ │ api.billcommons.org └──────┬──────┘ │ reads (SQLAlchemy) ▼ ┌─────────────────────────────┐ │ Postgres 16 (Railway) │ │ jurisdictions, sessions, │ │ bills, actions, sponsorships,│ │ votes, ingest_jobs, coverage │ └──────────────▲──────────────┘ │ writes (idempotent upserts) ┌──────────────┴──────────────┐ │ workers/ingest (worker svc) │ │ autoboot: seed → bootstrap →│ │ schedule-refresh → job loop │ │ sources: Open States bulk CSV│ │ (T2 bootstrap) + v3 API (T2 │ │ incremental, OPENSTATES_API_ │ │ KEY) + full-text fetcher │ └──────────────┬──────────────┘ ▼ RawStore (filesystem, RAWSTORE_ROOT volume in prod) — sha256-addressed raw payload archive

packages/schema (SQLAlchemy models + Alembic) is the single source of truth every other package/app imports from — no service owns its own copy of the data model.

Monorepo layout

apps/web        Next.js 15 (App Router, TS) — search UI + status page

apps/api FastAPI — REST API (/api/v1) apps/mcp MCP server (Streamable HTTP, mounted at /mcp) workers/ingest Ingestion workers, job queue, per-source adapters packages/schema SQLAlchemy models + Alembic migrations (single source of truth) packages/shared Shared Python utils: bill-number normalization, rawstore, http client packages/source-registry Per-jurisdiction source registry (data + loader) packages/search Search SQL builders / query parsing infra/docker Dockerfiles + docker-compose.yml (local stack) infra/deployment Railway/Vercel configs, DNS runbook docs/ Architecture, API, sources, operations, state-coverage docs data/registry Machine-readable registry (sessions, sources)

Local development setup

Prerequisites

Python 3.12
PostgreSQL 16 (with pg_trgm, unaccent, pgcrypto extensions available)
Node.js 20+ (for apps/web)

Python environment

python3 -m venv .venv

.venv/bin/pip install -r requirements.txt

This installs packages/schema and packages/shared as editable installs (single source of truth for the data model + shared utils), plus the worker package: .venv/bin/pip install -e workers/ingest. Install the API package too if you're working on it: .venv/bin/pip install -e apps/api.

Database

Set DATABASE_URL in your environment (or in ~/.config/billcommons/.env, which is read as a fallback and is never committed):

DATABASE_URL=postgresql://user:password@host:port/dbname

Requires Postgres 16 with the pg_trgm and unaccent extensions available (created by migration 0001). Run migrations:

cd packages/schema

../../.venv/bin/alembic upgrade head

Seeding data locally

# Seed all 51 jurisdictions/sessions/coverage rows from the registry:

.venv/bin/python -m billcommons_ingest seed-registry

Download a state's Open States bulk-CSV zip and ingest it (see

docs/operations/ingestion-runbook.md for the full command reference):

python3 workers/ingest/download_bulk.py --only NC .venv/bin/python -m billcommons_ingest bootstrap --state NC --zip data/bulkzips/NC_2025.zip .venv/bin/python -m billcommons_ingest recompute-coverage

Running the apps locally

# API (FastAPI, http://localhost:8000, docs at /docs)

.venv/bin/uvicorn main:app --app-dir apps/api --reload --port 8000

MCP server (Streamable HTTP, http://localhost:8400/mcp by default)

.venv/bin/python apps/mcp/server.py

Ingestion worker (long-running queue loop; runs schedule-refresh

periodically inside the same process)

.venv/bin/python -m billcommons_ingest worker

Web app (Next.js — separate from the Python stack)

cd apps/web npm install NEXT_PUBLIC_API_BASE=http://localhost:8000 npm run dev

Tests

.venv/bin/pytest packages/shared/tests

.venv/bin/pytest workers/ingest/tests .venv/bin/pytest apps/api/tests

Running the stack locally with Docker

cd infra/docker

docker compose up --build

This brings up Postgres, the API, the ingestion worker, and the MCP server. The web app (apps/web) is run separately via npm run dev during local development (see infra/docker/docker-compose.yml for the placeholder service definition).

Documentation

docs/architecture/ARCHITECTURE.md — locked architecture + data model
docs/SPEC.md — requirements digest / acceptance gate
docs/operations/deployment-runbook.md — Railway/Vercel deploy, rollback, smoke checklist
docs/operations/ingestion-runbook.md — CLI reference, job queue, refresh cadence
docs/operations/source-failure-runbook.md — stale zips, 401/429, robots blocks
docs/operations/backup-restore.md — pg_dump/restore, raw-data re-fetch
docs/operations/add-a-jurisdiction.md — onboarding a new territory/state
docs/state-coverage/methodology.md — coverage state machine, GREEN criteria
docs/api/examples.md — curl/Python/JavaScript examples against the live API
docs/sources/openstates-csv.md — Open States bulk CSV column mapping

License

Apache-2.0. See LICENSE and NOTICE for data attribution (Open States / Plural Policy, public-domain legislative data).

Contributing

See CONTRIBUTING.md. This project follows the Contributor Covenant.

Security

See SECURITY.md for responsible disclosure.

Bill Commons

Resumen

Los tres pilares de PopNx MCP

Qué puedes hacer con él

Instalación

Antes de instalar

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Comparado con otros en Búsqueda y memoria de IAi

Preguntas frecuentes

Alternativas

Context7

Codebase Memory

Exa

README del creador

Bill Commons

Production

Use with Claude (or any MCP client)

Architecture at a glance

Monorepo layout

Local development setup

Prerequisites

Python environment

Database

Seeding data locally

Download a state's Open States bulk-CSV zip and ingest it (see

docs/operations/ingestion-runbook.md for the full command reference):

Running the apps locally

MCP server (Streamable HTTP, http://localhost:8400/mcp by default)

Ingestion worker (long-running queue loop; runs schedule-refresh

periodically inside the same process)

Web app (Next.js — separate from the Python stack)

Tests

Running the stack locally with Docker

Documentation

License

Contributing

Security