CourtListener

io.github.Vaquill-AIPublished by GitHub account Vaquill-AIv0.1.0Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingKnowledge & Memory

Overview

AI-generated overview

Remote MCP server giving assistants read-only access to CourtListener case law, dockets, judges and oral arguments, plus eCFR federal regulations.

What you can do
Search and retrieve CourtListener case law: opinions, opinion clusters, dockets, RECAP/PACER documents, oral argument audio, judges and courts, with cursor pagination on searches and lookups by ID for each record type. Look up, batch-look-up, validate, parse and extract legal citations from text, optionally enriched with CourtListener case data. Browse and search the eCFR: list titles, agencies and corrections, inspect title structure and ancestry, fetch source XML, and run full-text regulation searches with counts, summaries and suggestions. Check server status and metrics.
When to use it
Useful for legal research workflows: finding US federal and state opinions, checking dockets and filings, verifying or extracting citations, and reading federal regulations. Worth adding when an assistant needs CourtListener data without OAuth, or when eCFR regulation tools are needed alongside case law.
Requirements
A remote streamable HTTP endpoint; no local install. A free CourtListener API token sent in the X-CourtListener-Token header on every request. Network access to the hosted endpoint, CourtListener and the eCFR API. Self-hosting is possible with Python/uv or Docker and an optional COURT_LISTENER_API_KEY.
Before you install
The CourtListener token is a credential sent with each request; the README says the server forwards it and does not store it, but it still leaves your machine. All tools are described as read-only, so no data is written or changed. Queries and tokens go to third-party services (CourtListener, eCFR).

Installation

In SourceWeft

  1. Open CourtListener in the dashboard and add it to a workspace.
  2. Connect X-CourtListener-Token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Vaquill-AI%2Fcourtlistener-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "courtlistener": {
      "type": "http",
      "url": "https://courtlistener-mcp.vaquill.ai/mcp/",
      "headers": {
        "X-CourtListener-Token": "<YOUR_API_KEY>"
      }
    }
  }
}

README

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.

[Discord]

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):

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

Cursor

.cursor/mcp.json:

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:

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: <key> (preferred), or
    • Authorization: Token <key> (CourtListener's native scheme — only works if the MCP server itself isn't already gated by Authorization).
  2. 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

bash
git clone https://github.com/Vaquill-AI/courtlistener-mcp.gitcd courtlistener-mcpcp .env.example .env  # optionally set COURT_LISTENER_API_KEY for single-tenantdocker compose up -d# server at http://localhost:8000/mcp/

Python (uv)

bash
uv syncuv run python -m app --transport http

Stdio (local CLI integration)

bash
uv run python -m app --transport stdio

Add to Claude Desktop:

json
{  "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

bash
curl https://courtlistener-mcp.vaquill.ai/health# {"status":"healthy","service":"courtlistener-mcp","version":"..."}

Development

bash
uv sync --devuv run pytestuv 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.

Source: README.md at commit 9078d09

Tools

34

status

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

Takes no parameters.

search_opinions

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

Parametersqrequiredcourtjudgelimitcursorcited_gtcited_ltorder_bycase_namefiled_afterfiled_before

search_dockets

Search federal cases (dockets) from PACER in CourtListener.

Parametersqrequiredcourtlimitcursororder_bycase_nameparty_namedocket_numberdate_filed_afterdate_filed_before

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.

Parametersqrequiredcourtlimitcursororder_bycase_nameparty_namedocket_numberdate_filed_afterdate_filed_before

search_recap_documents

Search federal filing documents from PACER in the RECAP archive.

Parametersqrequiredcourtlimitcursororder_bycase_nameparty_namefiled_afterfiled_beforedocket_numberdocument_numberattachment_number

search_audio

Search oral argument audio recordings in CourtListener.

Parametersqrequiredcourtjudgelimitcursororder_bycase_nameargued_afterargued_before

search_people

Search judges and legal professionals in the CourtListener database.

Parametersqrequirednamelimitcursorschoolorder_byappointed_byposition_typeselection_methodpolitical_affiliation

get_opinion

Get a specific court opinion by ID from CourtListener.

Parametersopinion_idrequired

get_docket

Get a specific court docket by ID from CourtListener.

Parametersdocket_idrequired

get_audio

Get oral argument audio information by ID from CourtListener.

Parametersaudio_idrequired

get_cluster

Get an opinion cluster by ID from CourtListener.

Parameterscluster_idrequired

get_person

Get judge or legal professional information by ID from CourtListener.

Parametersperson_idrequired

get_court

Get court information by ID from CourtListener.

Parameterscourt_idrequired

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") - State reporter citations

Parameterscitationrequired

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.

Parameterscitationsrequired

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 regex matching. Returns information about the citation format and any detected issues.

Parameterscitationrequired

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: - Recognized citation format and source - Extracted tokens (volume, reporter, page, etc.) - Generated URL if available - Normalized citation text

Parametersbroadcitationrequired

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).

Parameterstextrequired

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.

Parameterscitationrequiredinclude_courtlistener

ecfr_list_titles

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

Takes no parameters.

ecfr_get_title_versions

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

Parameterstitlerequired

ecfr_get_title_structure

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

Parametersdaterequiredtitlerequired

ecfr_get_ancestry

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

Parametersdaterequiredparttitlerequiredsection

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``.

Parametersdaterequiredparttitlerequiredchaptersectionsubpartappendixsubtitlesubchapter

ecfr_list_agencies

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

Takes no parameters.

ecfr_list_all_corrections

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

Parametersdatetitle

ecfr_list_corrections_by_title

List all corrections for a single CFR title.

Parameterstitlerequired

ecfr_search_regulations

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

Parametersdatepageorderqueryrequiredtitleper_pageagency_slugs

ecfr_get_search_count

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

Parametersdatequeryrequiredtitleagency_slugs

ecfr_get_search_summary

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

Parametersdatequeryrequiredtitleagency_slugs

ecfr_get_title_search_counts

Get search result counts broken down by CFR title.

Parametersdatequeryrequired

ecfr_get_daily_search_counts

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

Parametersdatequeryrequired

ecfr_get_hierarchy_search_counts

Get search result counts distributed across the CFR hierarchy.

Parametersdatequeryrequired

ecfr_get_search_suggestions

Get search-term suggestions for a partial CFR query.

Parametersqueryrequired

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts