Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas Iniciar sesión

CourtListener

de Vaquill-AIversión 0.1.0i★ 5iSe ejecuta en la nubeSitio oficial ↗
Nombre en el registroio.github.Vaquill-AI/courtlistener-mcp

Cómo instalar

Qué hace

MCP for CourtListener: US federal and state opinions, dockets, judges, plus eCFR regulations.

Texto original del autor

  • Conexión Se ejecuta en la nube
  • Cuenta o clave Necesita X-CourtListener-Token
  • Categoría Derecho y datos públicos

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad9/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad7/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo8/8El endpoint en la nube respondió en la última revisión
Puntuación de uso25/100

Calidad: Pasó 5/5 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

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

Que tu IA lo instale con una frase

Instala CourtListener. Sigue https://mcp.popnx.com/i/vaquill-ai-courtlistener-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 5/5 revisiones · Lo que preguntas pasa por el servidor del autor (courtlistener-mcp.vaquill.ai) · ✓ Comandos revisados el 20 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude · unos 5 min

Necesitas una clave de CourtListener (créala en el sitio del autor) · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner

  1. Regístrate y crea una clave de CourtListener

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  2. Abre la página Connectors de Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  3. Pulsa “Add” → “Custom” → “Web” y completa estos 2 campos

    Copia cada valor al campo con el mismo nombre en Claude y pulsa Continue

    Name · NombreCourtListener
    Remote MCP server URL · Direcciónhttps://courtlistener-mcp.vaquill.ai/mcp/

    En Request headers, añade este nombre y valor

    Nombre del headerX-CourtListener-Token
    Valor<pega tu clave aquí>

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

    Pulsa Continue en la pantalla de inicio de sesión que detectó Claude · en Authentication elige lo que indique el autor (Sign in now, Sign in when needed o No sign in) y pulsa Add

  4. Actívalo en un chat

    +ConnectorsCourtListener

  5. Pruébalo

    Usa CourtListener y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando CourtListener o muestra una herramienta de CourtListener en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar CourtListener

CourtListener necesita tu propia clave para conectarse, pero la ayuda de OpenAI solo describe el inicio de sesión con OAuth; no hay una opción de clave que hayamos podido verificar

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar CourtListener

  • Necesitas una clave de CourtListener (créala en el sitio del autor) · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner
  • Necesitas una clave de CourtListener (créala en el sitio del autor)
  • Necesitas una clave de CourtListener (créala en el sitio del autor)
  • Necesitas una clave de CourtListener (créala en el sitio del autor)

B · Otros en Derecho y datos públicos que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code · unos 5 min

Necesitas una clave de CourtListener (créala en el sitio del autor)

  1. Regístrate y crea una clave de CourtListener

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  2. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  3. Pega este comando y pulsa Enter

    claude mcp add --transport http --scope user courtlistener https://courtlistener-mcp.vaquill.ai/mcp/ --header 'X-CourtListener-Token: your-value'

    Cambia “your-value” por tu clave antes de pulsar Enter

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  4. Escribe /mcp en Claude Code

    Deberías ver CourtListener en la lista como conectado

  5. Pruébalo

    Usa CourtListener y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando CourtListener o muestra una herramienta de CourtListener en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor · unos 5 min

Necesitas una clave de CourtListener (créala en el sitio del autor)

  1. Regístrate y crea una clave de CourtListener

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  2. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  3. Escribe tu clave

    En la configuración de CourtListener, X-CourtListener-Token está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  4. Abre el chat de IA de Cursor en modo Agent

  5. Pruébalo

    Usa CourtListener y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando CourtListener o muestra una herramienta de CourtListener en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code · unos 5 min

Necesitas una clave de CourtListener (créala en el sitio del autor)

  1. Regístrate y crea una clave de CourtListener

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  2. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  3. Escribe tu clave

    En la configuración de CourtListener, X-CourtListener-Token está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  4. Abre el chat de IA de VS Code en modo Agent

  5. Pruébalo

    Usa CourtListener y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando CourtListener o muestra una herramienta de CourtListener en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

Dirección para apps que se conectan por la web

Direcciónhttps://courtlistener-mcp.vaquill.ai/mcp/

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa CourtListener💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Por la web

Claude Code

claude mcp add --transport http --scope user courtlistener https://courtlistener-mcp.vaquill.ai/mcp/ --header 'X-CourtListener-Token: your-value'

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "courtlistener": {
      "url": "https://courtlistener-mcp.vaquill.ai/mcp/",
      "headers": {
        "X-CourtListener-Token": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "courtlistener": {
      "type": "http",
      "url": "https://courtlistener-mcp.vaquill.ai/mcp/",
      "headers": {
        "X-CourtListener-Token": "your-value"
      }
    }
  }
}

Valores que debes completar

  • X-CourtListener-Token secreto obligatorio HTTP header
    Tu token gratuito de la API de CourtListener, de https://www.courtlistener.com/help/api/rest/. El servidor nunca almacena tu clave.
    Ver original en inglésYour free CourtListener API token from https://www.courtlistener.com/help/api/rest/. The server never stores your key.

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

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

De un vistazo

Descargas por semanai
No está en npm/PyPI
Conexión
Se ejecuta en la nube
Transporte
streamable-http
Última versióni
0.1.0
Publicado en el registroi
15 may 2026
Último cambio de códigoi
7 sept 2026
Última revisión
19 nov 2026
Creador
Vaquill-AI
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se conectan por internet en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Nombres y descripciones de las herramientas tal como los informó el servidor el 19 nov 2026. Los escribió el creador, no nosotros; los mostramos como texto sin formato.

  • status

    Check the status of the CourtListener MCP server. Returns: A dictionary containing server status, system metrics, and service information.

  • search_opinions

    Search case law opinion clusters with nested Opinion documents in CourtListener.

  • search_dockets

    Search federal cases (dockets) from PACER in CourtListener.

  • search_dockets_with_documents

    Search federal cases (dockets) with up to three nested documents. If there are more than three matching documents, the more_docs field will be true.

  • search_recap_documents

    Search federal filing documents from PACER in the RECAP archive.

  • search_audio

    Search oral argument audio recordings in CourtListener.

  • search_people

    Search judges and legal professionals in the CourtListener database.

  • get_opinion

    Get a specific court opinion by ID from CourtListener.

  • get_docket

    Get a specific court docket by ID from CourtListener.

  • get_audio

    Get oral argument audio information by ID from CourtListener.

  • get_cluster

    Get an opinion cluster by ID from CourtListener.

  • get_person

    Get judge or legal professional information by ID from CourtListener.

  • get_court

    Get court information by ID from CourtListener.

  • citation_lookup_citation

    Look up a legal citation to find the opinion it references in CourtListener. This tool accepts various citation formats including: - U.S. Reporter citations (e.g., "410 U.S. 113") - Federal Reporter citations (e.g., "123 F.3d 456") - WestLaw citations (e.g., "2023 WL 12345") - St

  • citation_batch_lookup_citations

    Look up multiple legal citations in a single request. This is more efficient than making individual requests for each citation. Accepts up to 100 citations at once.

  • citation_verify_citation_format

    Verify if a citation string is in a valid format using citeurl's advanced parsing. This tool performs validation using citeurl's comprehensive citation templates to check if a citation appears to be in a recognized legal citation format. This is much more accurate than simple reg

  • citation_parse_citation_with_citeurl

    Parse a legal citation using citeurl's advanced citation recognition. This tool uses the citeurl library to parse legal citations and extract structured information including tokens, normalized format, and URL generation. Returns detailed information about the citation including:

  • citation_extract_citations_from_text

    Extract all legal citations from a block of text using citeurl. This tool finds and parses all legal citations within a given text, including both long-form and short-form citations (like 'id.' references).

  • citation_enhanced_citation_lookup

    Enhanced citation lookup combining citeurl parsing with CourtListener data. This tool first uses citeurl to parse and validate the citation format, then optionally queries the CourtListener API for additional case information.

  • ecfr_list_titles

    List all 50 CFR titles with their latest amended/issue dates and status.

  • ecfr_get_title_versions

    List the available content versions (issue dates) for one CFR title.

  • ecfr_get_title_structure

    Get the full hierarchical structure (title -> section) of a CFR title on a date.

  • ecfr_get_ancestry

    Get the ancestry chain (title -> ... -> node) for a CFR node on a date.

  • ecfr_get_source_xml

    Fetch the source regulation TEXT (XML) for a CFR node on a snapshot date. Pass a part or section to scope the request. Fetching an entire large title at once can time out on the eCFR side, so narrowing is strongly recommended. Returns the raw XML under ``content_xml``.

  • ecfr_list_agencies

    List all agencies that appear in the CFR, with their title/chapter references.

  • ecfr_list_all_corrections

    List CFR corrections, optionally filtered by title and/or effective date.

  • ecfr_list_corrections_by_title

    List all corrections for a single CFR title.

  • ecfr_search_regulations

    Full-text search over federal regulations, returning matching sections with hierarchy.

  • ecfr_get_search_count

    Get the total number of CFR sections matching a search query.

  • ecfr_get_search_summary

    Get summary details (counts + metadata) for a CFR search query.

  • ecfr_get_title_search_counts

    Get search result counts broken down by CFR title.

  • ecfr_get_daily_search_counts

    Get search result counts broken down by date (daily histogram).

  • ecfr_get_hierarchy_search_counts

    Get search result counts distributed across the CFR hierarchy.

  • ecfr_get_search_suggestions

    Get search-term suggestions for a partial CFR query.

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 20 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub Vaquill-AI, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 2 meses

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • ✓ Superada

    El endpoint responde

    Respondió en 238 ms (HTTP 200)

  • – No aplica

    Inicio de sesión con OAuth

    No hace falta iniciar sesión

  • ✓ Superada

    Sin instrucciones ocultas en las descripciones de herramientas

    Leímos 34 descripciones de herramientas y no encontramos instrucciones ocultas para la IA

La dirección en la nube respondió 5 de las últimas 5 comprobaciones · última 238 ms · revisado 19 nov 2026

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/vaquill-ai-courtlistener-mcp.svg)](https://mcp.popnx.com/en/servers/vaquill-ai-courtlistener-mcp)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Derecho y datos públicosi

  • Más estrellas que el 96% de los otros 1961 servidores de esta categoría
  • Publicado en el registro más recientemente que el 7% de los otros 1961 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 1961 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 CourtListener?

Superó 5 de 5 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?

Debes completar: X-CourtListener-Token

¿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 hace 2 meses, y la última versión (0.1.0) llegó al registro hace 6 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 sirve en apps que aceptan MCP remoto, como ChatGPT en la web (MCP completo en Business y superiores; Pro solo lectura).

¿Qué puedo usar en su lugar?

En la misma categoría: Global law, Open Legal Data (Germany), LibreJustice, InfraNode, Fedlex Connector

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

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

Global law

The law of nearly every country on earth, any date: read it, see what changed it, check citations.

de lexifinaMuy usado★ 2,1 milActualizado hace 10 días

Se ejecuta en la nube✓ lexifina.com

LibreJustice

Search French-language and European case law and French legal texts (codes, statutes, treaties).

de librejusticeInicial★ 38Actualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · librejustice.fr

InfraNode

Keyless open data for 84 German cities: 12 lean read-only MCP tools covering 67 data types.

de street1983nkInicial★ 18Actualizado hace 5 meses

Se ejecuta en la nube✓ del servicio · infranode.dev

Fedlex Connector

Search Swiss federal legislation: laws, articles, amendments via the Fedlex SPARQL endpoint.

de JayTheSkierInicial★ 8Actualizado hace 7 meses

Se ejecuta en la nube✓ del servicio · fedlex-connector.ch
Comparado con otros parecidos
Este
CourtListener
Global lawOpen Legal Data (Germany)LibreJusticeInfraNodeFedlex Connector
Dónde se ejecutaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveSíNoNoNoNoNo
Se añade con + en ClaudeNoNoNoNoNoNo
Revisiones básicas5/54/44/44/44/44/4
LicenciaMITNOASSERTIONMITApache-2.0Apache-2.0MIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

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.

CourtListener MCP Server

A Model Context Protocol server that gives AI assistants access to the CourtListener legal database (US federal + state court opinions, dockets, RECAP filings, PACER data, oral arguments, judges) and the Electronic Code of Federal Regulations via the official CourtListener API v4.

Use it with Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, ChatGPT Desktop, or any MCP-compatible client.

Forked from Travis-Prall/court-listener-mcp. This fork adds a hosted endpoint, bring-your-own-key (BYOK) auth, a /health route, Dockerfile hardening, a full eCFR (federal regulations) tool suite, cursor pagination, per-client rate limiting, and read-only tool annotations. See the changelog for details.

When to use this vs. the official server

Free Law Project (who run CourtListener) host an official MCP at https://mcp.courtlistener.com/ (OAuth, free with any CourtListener account) - see their announcement. Prefer it if you want OAuth and the broadest CourtListener coverage. Use this server if you want: eCFR federal-regulations tools (the official server has none), simple BYOK header auth (no OAuth dance), or a self-hosted/embeddable Python server. The two are complementary.

Use the hosted endpoint (no install)

The Vaquill team runs a public instance for the community:

https://courtlistener-mcp.vaquill.ai/mcp/

You bring your own free CourtListener token from courtlistener.com/help/api/rest/, the server forwards it. We never see or store your key.

Claude Desktop / Claude Code

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

{

"mcpServers": { "courtlistener": { "url": "https://courtlistener-mcp.vaquill.ai/mcp/", "headers": { "X-CourtListener-Token": "YOUR_COURTLISTENER_TOKEN" } } } }

Cursor

.cursor/mcp.json:

{

"mcpServers": { "courtlistener": { "url": "https://courtlistener-mcp.vaquill.ai/mcp/", "headers": { "X-CourtListener-Token": "YOUR_COURTLISTENER_TOKEN" } } } }

VS Code (GitHub Copilot Chat)

.vscode/mcp.json:

{

"servers": { "courtlistener": { "type": "http", "url": "https://courtlistener-mcp.vaquill.ai/mcp/", "headers": { "X-CourtListener-Token": "YOUR_COURTLISTENER_TOKEN" } } } }

Claude Web (custom connector)

Settings → Connectors → Add custom connector → paste the URL and add X-CourtListener-Token as a header. Workspace owners only.

Windsurf, Continue, etc.

Any client that supports MCP streamable HTTP with custom headers works. For stdio-only clients, run the server locally (see below) or proxy with mcp-remote.

Tools

34 tools across 4 groups (each group is namespaced). All are read-only.

GroupTools
Search (CourtListener)search_opinions, search_dockets, search_dockets_with_documents, search_recap_documents, search_audio, search_people
Get (CourtListener)get_opinion, get_docket, get_audio, get_court, get_person, get_cluster
Citationcitation_lookup_citation, citation_batch_lookup_citations, citation_verify_citation_format, citation_parse_citation_with_citeurl, citation_extract_citations_from_text, citation_enhanced_citation_lookup
eCFR (federal regulations)ecfr_list_titles, ecfr_get_title_versions, ecfr_get_title_structure, ecfr_get_ancestry, ecfr_get_source_xml, ecfr_list_agencies, ecfr_list_all_corrections, ecfr_list_corrections_by_title, ecfr_search_regulations, ecfr_get_search_count, ecfr_get_search_summary, ecfr_get_title_search_counts, ecfr_get_daily_search_counts, ecfr_get_hierarchy_search_counts, ecfr_get_search_suggestions
Systemstatus

Search tools accept a cursor param and return a next_cursor for pagination. See app/README.md for full parameter details.

Authentication

Two modes, in priority order:

  1. Per-request header (BYOK) — preferred for hosted / shared deployments. Send the user's CourtListener key on every MCP request:
  • X-CourtListener-Token: (preferred), or
  • Authorization: Token (CourtListener's native scheme — only works if the MCP server itself isn't already gated by Authorization).
  1. Server env fallback — set COURT_LISTENER_API_KEY on the server. Used when no per-request header is supplied. Leave unset on public instances to force BYOK and avoid burning the operator's quota.

If neither is provided, tools return a ValueError with a clear message.

Self-host

Docker
git clone https://github.com/Vaquill-AI/courtlistener-mcp.git

cd courtlistener-mcp cp .env.example .env # optionally set COURT_LISTENER_API_KEY for single-tenant docker compose up -d

server at http://localhost:8000/mcp/

Python (uv)
uv sync

uv run python -m app --transport http

Stdio (local CLI integration)
uv run python -m app --transport stdio

Add to Claude Desktop:

{

"mcpServers": { "courtlistener-local": { "command": "uv", "args": ["run", "--directory", "/abs/path/to/courtlistener-mcp", "python", "-m", "app", "--transport", "stdio"], "env": { "COURT_LISTENER_API_KEY": "your_token" } } } }

Configuration

VarRequiredDefaultNotes
COURT_LISTENER_API_KEYOptional*—Fallback when no per-request header. Leave unset on public servers.
COURTLISTENER_BASE_URLNohttps://www.courtlistener.com/api/rest/v4/
COURTLISTENER_TIMEOUTNo30seconds
MCP_TRANSPORTNostdiostdio \http \sse
MCP_PORTNo8000http/sse only
HOSTNo0.0.0.0http/sse only
ECFR_BASE_URLNohttps://www.ecfr.goveCFR API base (no key required)
RATE_LIMIT_ENABLEDNotruePer-client MCP rate limiting
RATE_LIMIT_RPSNo15Max requests/sec per client
RATE_LIMIT_BURSTNo40Burst capacity per client

\* Required only if running in single-tenant mode without BYOK.

Health check

curl https://courtlistener-mcp.vaquill.ai/health

{"status":"healthy","service":"courtlistener-mcp","version":"..."}

Development

uv sync --dev

uv run pytest uv run ruff format . && uv run ruff check . uv run mypy app/

Changelog

0.2.0
  • Added a full eCFR (federal regulations) tool suite (15 tools): titles, structure, versions, ancestry, source XML, agencies, corrections, and full-text regulation search + analytics. This is the differentiator over CourtListener-only servers.
  • Fixed a validation crash: optional search filters are now nullable (str | None), so clients that send explicit JSON null no longer get a ValidationError (previously broke search_dockets / search_recap_documents).
  • Real pagination: removed the no-op hit param; search tools now honor limit and expose a next_cursor token plus an input cursor.
  • Read-only tool annotations on all tools (better client UX, no write prompts).
  • Per-client rate limiting middleware (configurable, on by default).
  • Migrated import_server → mount (FastMCP 3), fixed the API-key env-var alias, refreshed project metadata, and got the test suite green (unit tests mocked; live-API tests gated behind RUN_INTEGRATION=1).

Credits & License

CourtListener data is provided by the Free Law Project under their respective terms. eCFR data is from ecfr.gov.

Community

Questions, ideas, or want to contribute? Join the Vaquill community on Discord.