Global law
The law of nearly every country on earth, any date: read it, see what changed it, check citations.
MCP for CourtListener: US federal and state opinions, dockets, judges, plus eCFR regulations.
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 9/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 7/12 | Full marks for a release or code change within 30 days |
| Still answering | 8/8 | The cloud endpoint answered at the last check |
| Usage score | 25/100 |
Quality: Passed 5/5 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)
Pick the AI app you use, then copy the settings.
Let your AI install it with one sentence
Please install CourtListener. Follow https://mcp.popnx.com/i/vaquill-ai-courtlistener-mcp.md, show me the commands and wait for my OK before running them.Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads
Passed 5/5 checks · What you ask goes through the maker’s server (courtlistener-mcp.vaquill.ai) · ✓ Commands checked Nov 20, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude · about 5 min
You need a CourtListener key (create it on the maker’s site) · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
CustomizeConnectors
Copy each value into the field with the same name in Claude, then click Continue
CourtListenerhttps://courtlistener-mcp.vaquill.ai/mcp/Under Request headers, add this name and value
X-CourtListener-Token<paste your key here>Paste the key only into the app’s field, never into a chat or to anyone
Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add
+ConnectorsCourtListener
Use CourtListener and tell me what you can do for me, then show me one thing✓ If Claude says it is using CourtListener or shows a CourtListener tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect CourtListener yet
CourtListener needs your own key to connect, but OpenAI’s help page only describes OAuth sign-in; there is no key option we could verify
A · Use an app that can connect CourtListener
B · Others in Law & government data that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
Works with Claude Code · about 5 min
You need a CourtListener key (create it on the maker’s site)
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add --transport http --scope user courtlistener https://courtlistener-mcp.vaquill.ai/mcp/ --header 'X-CourtListener-Token: your-value'Replace “your-value” with your key before pressing Enter
Paste the key only into the app’s field, never into a chat or to anyone
You should see CourtListener listed as connected
Use CourtListener and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using CourtListener or shows a CourtListener tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor · about 5 min
You need a CourtListener key (create it on the maker’s site)
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
In the CourtListener settings, X-CourtListener-Token is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use CourtListener and tell me what you can do for me, then show me one thing✓ If Cursor says it is using CourtListener or shows a CourtListener tool in the answer, you are connected
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code · about 5 min
You need a CourtListener key (create it on the maker’s site)
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
In the CourtListener settings, X-CourtListener-Token is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use CourtListener and tell me what you can do for me, then show me one thing✓ If VS Code says it is using CourtListener or shows a CourtListener tool in the answer, you are connected
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
Address for apps that connect over the web
https://courtlistener-mcp.vaquill.ai/mcp/JSON settings are under “For developers” below
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"
}
}
}
}Descriptions are as written by the maker.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Connect over the internet in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
Tool names and descriptions exactly as the server reported them on Nov 19, 2026. The maker wrote them, not us; we show them as plain text.
statusCheck the status of the CourtListener MCP server. Returns: A dictionary containing server status, system metrics, and service information.
search_opinionsSearch case law opinion clusters with nested Opinion documents in CourtListener.
search_docketsSearch federal cases (dockets) from PACER in CourtListener.
search_dockets_with_documentsSearch 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_documentsSearch federal filing documents from PACER in the RECAP archive.
search_audioSearch oral argument audio recordings in CourtListener.
search_peopleSearch judges and legal professionals in the CourtListener database.
get_opinionGet a specific court opinion by ID from CourtListener.
get_docketGet a specific court docket by ID from CourtListener.
get_audioGet oral argument audio information by ID from CourtListener.
get_clusterGet an opinion cluster by ID from CourtListener.
get_personGet judge or legal professional information by ID from CourtListener.
get_courtGet court information by ID from CourtListener.
citation_lookup_citationLook 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_citationsLook 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_formatVerify 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_citeurlParse 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_textExtract 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_lookupEnhanced 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_titlesList all 50 CFR titles with their latest amended/issue dates and status.
ecfr_get_title_versionsList the available content versions (issue dates) for one CFR title.
ecfr_get_title_structureGet the full hierarchical structure (title -> section) of a CFR title on a date.
ecfr_get_ancestryGet the ancestry chain (title -> ... -> node) for a CFR node on a date.
ecfr_get_source_xmlFetch 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_agenciesList all agencies that appear in the CFR, with their title/chapter references.
ecfr_list_all_correctionsList CFR corrections, optionally filtered by title and/or effective date.
ecfr_list_corrections_by_titleList all corrections for a single CFR title.
ecfr_search_regulationsFull-text search over federal regulations, returning matching sections with hierarchy.
ecfr_get_search_countGet the total number of CFR sections matching a search query.
ecfr_get_search_summaryGet summary details (counts + metadata) for a CFR search query.
ecfr_get_title_search_countsGet search result counts broken down by CFR title.
ecfr_get_daily_search_countsGet search result counts broken down by date (daily histogram).
ecfr_get_hierarchy_search_countsGet search result counts distributed across the CFR hierarchy.
ecfr_get_search_suggestionsGet search-term suggestions for a partial CFR query.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 20, 2026
The registry name was verified with the GitHub account Vaquill-AI, which owns the repo
Code last changed 2 months ago
Uses MIT
Responded in 238 ms (HTTP 200)
No sign-in needed
Read 34 tool descriptions and found no hidden instructions to the AI
The cloud address answered 5 of the last 5 checks · latest 238 ms · checked Nov 19, 2026
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/vaquill-ai-courtlistener-mcp)Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 5 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
You need to fill in: X-CourtListener-Token
It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.
The GitHub repo last changed 2 months ago, and the latest version (0.1.0) reached the registry 6 months ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).
In the same category: Global law, Open Legal Data (Germany), LibreJustice, InfraNode, Fedlex Connector
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
The law of nearly every country on earth, any date: read it, see what changed it, check citations.
German court decisions (Rechtsprechung) and laws (Gesetze) with citation graph and citation checks.
Search French-language and European case law and French legal texts (codes, statutes, treaties).
Keyless open data for 84 German cities: 12 lean read-only MCP tools covering 67 data types.
Search Swiss federal legislation: laws, articles, amendments via the Fedlex SPARQL endpoint.
| This one CourtListener | Global law | Open Legal Data (Germany) | LibreJustice | InfraNode | Fedlex Connector | |
|---|---|---|---|---|---|---|
| Runs where | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install |
| Needs a key | Yes | No | No | No | No | No |
| Add with + in Claude | No | No | No | No | No | No |
| Basic checks | 5/5 | 4/4 | 4/4 | 4/4 | 4/4 | 4/4 |
| License | MIT | NOASSERTION | MIT | Apache-2.0 | Apache-2.0 | MIT |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
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:
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.
~/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/mcp.json:
{
"mcpServers": { "courtlistener": { "url": "https://courtlistener-mcp.vaquill.ai/mcp/", "headers": { "X-CourtListener-Token": "YOUR_COURTLISTENER_TOKEN" } } } }
.vscode/mcp.json:
{
"servers": { "courtlistener": { "type": "http", "url": "https://courtlistener-mcp.vaquill.ai/mcp/", "headers": { "X-CourtListener-Token": "YOUR_COURTLISTENER_TOKEN" } } } }
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.
| Group | Tools |
|---|---|
| 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 |
| Citation | citation_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 |
| System | status |
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: (preferred), orAuthorization: Token (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.
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
uv sync
uv run python -m app --transport http
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" } } } }
| Var | Required | Default | Notes | ||
|---|---|---|---|---|---|
COURT_LISTENER_API_KEY | Optional* | — | Fallback when no per-request header. Leave unset on public servers. | ||
COURTLISTENER_BASE_URL | No | https://www.courtlistener.com/api/rest/v4/ | |||
COURTLISTENER_TIMEOUT | No | 30 | seconds | ||
MCP_TRANSPORT | No | stdio | stdio \ | http \ | sse |
MCP_PORT | No | 8000 | http/sse only | ||
HOST | No | 0.0.0.0 | http/sse only | ||
ECFR_BASE_URL | No | https://www.ecfr.gov | eCFR API base (no key required) | ||
RATE_LIMIT_ENABLED | No | true | Per-client MCP rate limiting | ||
RATE_LIMIT_RPS | No | 15 | Max requests/sec per client | ||
RATE_LIMIT_BURST | No | 40 | Burst capacity per client |
\* Required only if running in single-tenant mode without BYOK.
curl https://courtlistener-mcp.vaquill.ai/health
uv sync --dev
uv run pytest uv run ruff format . && uv run ruff check . uv run mypy app/
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.