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

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.
Remote MCP server giving assistants read-only access to CourtListener case law, dockets, judges and oral arguments, plus eCFR federal regulations.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
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.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>"
}
}
}
}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
/healthroute, 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.
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.
The Vaquill team runs a public instance for the community:
You bring your own free CourtListener token from courtlistener.com/help/api/rest/, the server forwards it. We never see or store your key.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or
%APPDATA%\Claude\claude_desktop_config.json (Windows):
.cursor/mcp.json:
.vscode/mcp.json:
Settings → Connectors → Add custom connector → paste the URL and add
X-CourtListener-Token as a header. Workspace owners only.
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.
34 tools across 4 groups (each group is namespaced). All are read-only.
Search tools accept a cursor param and return a next_cursor for pagination.
See app/README.md for full parameter details.
Two modes, in priority order:
X-CourtListener-Token: <key> (preferred), orAuthorization: Token <key> (CourtListener's native scheme — only works
if the MCP server itself isn't already gated by Authorization).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.
Add to Claude Desktop:
* Required only if running in single-tenant mode without BYOK.
str | None), so clients that send explicit JSON null no longer get a
ValidationError (previously broke search_dockets / search_recap_documents).hit param; search tools now honor
limit and expose a next_cursor token plus an input cursor.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).CourtListener data is provided by the Free Law Project under their respective terms. eCFR data is from ecfr.gov.
Questions, ideas, or want to contribute? Join the Vaquill community on Discord.
Source: README.md at commit 9078d09
Check the status of the CourtListener MCP server. Returns: A dictionary containing server status, system metrics, and service information.
Takes no parameters.
Search case law opinion clusters with nested Opinion documents in CourtListener.
qrequiredcourtjudgelimitcursorcited_gtcited_ltorder_bycase_namefiled_afterfiled_beforeSearch federal cases (dockets) from PACER in CourtListener.
qrequiredcourtlimitcursororder_bycase_nameparty_namedocket_numberdate_filed_afterdate_filed_beforeSearch federal cases (dockets) with up to three nested documents. If there are more than three matching documents, the more_docs field will be true.
qrequiredcourtlimitcursororder_bycase_nameparty_namedocket_numberdate_filed_afterdate_filed_beforeSearch federal filing documents from PACER in the RECAP archive.
qrequiredcourtlimitcursororder_bycase_nameparty_namefiled_afterfiled_beforedocket_numberdocument_numberattachment_numberSearch oral argument audio recordings in CourtListener.
qrequiredcourtjudgelimitcursororder_bycase_nameargued_afterargued_beforeSearch judges and legal professionals in the CourtListener database.
qrequirednamelimitcursorschoolorder_byappointed_byposition_typeselection_methodpolitical_affiliationGet a specific court opinion by ID from CourtListener.
opinion_idrequiredGet a specific court docket by ID from CourtListener.
docket_idrequiredGet oral argument audio information by ID from CourtListener.
audio_idrequiredGet an opinion cluster by ID from CourtListener.
cluster_idrequiredGet judge or legal professional information by ID from CourtListener.
person_idrequiredGet court information by ID from CourtListener.
court_idrequiredLook 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
citationrequiredLook 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.
citationsrequiredVerify 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.
citationrequiredParse 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
broadcitationrequiredExtract 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).
textrequiredEnhanced 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.
citationrequiredinclude_courtlistenerList all 50 CFR titles with their latest amended/issue dates and status.
Takes no parameters.
List the available content versions (issue dates) for one CFR title.
titlerequiredGet the full hierarchical structure (title -> section) of a CFR title on a date.
daterequiredtitlerequiredGet the ancestry chain (title -> ... -> node) for a CFR node on a date.
daterequiredparttitlerequiredsectionFetch 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``.
daterequiredparttitlerequiredchaptersectionsubpartappendixsubtitlesubchapterList all agencies that appear in the CFR, with their title/chapter references.
Takes no parameters.
List CFR corrections, optionally filtered by title and/or effective date.
datetitleList all corrections for a single CFR title.
titlerequiredFull-text search over federal regulations, returning matching sections with hierarchy.
datepageorderqueryrequiredtitleper_pageagency_slugsGet the total number of CFR sections matching a search query.
datequeryrequiredtitleagency_slugsGet summary details (counts + metadata) for a CFR search query.
datequeryrequiredtitleagency_slugsGet search result counts broken down by CFR title.
datequeryrequiredGet search result counts broken down by date (daily histogram).
datequeryrequiredGet search result counts distributed across the CFR hierarchy.
datequeryrequiredGet search-term suggestions for a partial CFR query.
queryrequired75% 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.
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
https://courtlistener-mcp.vaquill.ai/mcp/{ "mcpServers": { "courtlistener": { "url": "https://courtlistener-mcp.vaquill.ai/mcp/", "headers": { "X-CourtListener-Token": "YOUR_COURTLISTENER_TOKEN" } } }}{ "mcpServers": { "courtlistener": { "url": "https://courtlistener-mcp.vaquill.ai/mcp/", "headers": { "X-CourtListener-Token": "YOUR_COURTLISTENER_TOKEN" } } }}{ "servers": { "courtlistener": { "type": "http", "url": "https://courtlistener-mcp.vaquill.ai/mcp/", "headers": { "X-CourtListener-Token": "YOUR_COURTLISTENER_TOKEN" } } }}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/uv syncuv run python -m app --transport httpuv run python -m app --transport stdio{ "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" } } }}curl https://courtlistener-mcp.vaquill.ai/health# {"status":"healthy","service":"courtlistener-mcp","version":"..."}uv sync --devuv run pytestuv run ruff format . && uv run ruff check .uv run mypy app/