status
Check the status of the CourtListener MCP server. Returns: A dictionary containing server status, system metrics, and service information.
无需输入参数。

io.github.Vaquill-AI由 GitHub 账号 Vaquill-AI 发布v0.1.0更新于 Oct 24, 2026
MCP for CourtListener: US federal and state opinions, dockets, judges, plus eCFR regulations.
远程 MCP 服务器,让助手以只读方式访问 CourtListener 的判例、案卷、法官与口头辩论,以及 eCFR 联邦法规。
Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。
把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。
阅读 https://sourceweft.com/mcp/io.github.Vaquill-AI%2Fcourtlistener-mcp/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。把它添加到你客户端的 mcpServers 配置中。
{
"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.
来源:README.md,提交 9078d09
Check the status of the CourtListener MCP server. Returns: A dictionary containing server status, system metrics, and service information.
无需输入参数。
Search case law opinion clusters with nested Opinion documents in CourtListener.
q必填courtjudgelimitcursorcited_gtcited_ltorder_bycase_namefiled_afterfiled_beforeSearch federal cases (dockets) from PACER in CourtListener.
q必填courtlimitcursororder_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.
q必填courtlimitcursororder_bycase_nameparty_namedocket_numberdate_filed_afterdate_filed_beforeSearch federal filing documents from PACER in the RECAP archive.
q必填courtlimitcursororder_bycase_nameparty_namefiled_afterfiled_beforedocket_numberdocument_numberattachment_numberSearch oral argument audio recordings in CourtListener.
q必填courtjudgelimitcursororder_bycase_nameargued_afterargued_beforeSearch judges and legal professionals in the CourtListener database.
q必填namelimitcursorschoolorder_byappointed_byposition_typeselection_methodpolitical_affiliationGet a specific court opinion by ID from CourtListener.
opinion_id必填Get a specific court docket by ID from CourtListener.
docket_id必填Get oral argument audio information by ID from CourtListener.
audio_id必填Get an opinion cluster by ID from CourtListener.
cluster_id必填Get judge or legal professional information by ID from CourtListener.
person_id必填Get court information by ID from CourtListener.
court_id必填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
citation必填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.
citations必填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.
citation必填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
broadcitation必填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).
text必填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.
citation必填include_courtlistenerList all 50 CFR titles with their latest amended/issue dates and status.
无需输入参数。
List the available content versions (issue dates) for one CFR title.
title必填Get the full hierarchical structure (title -> section) of a CFR title on a date.
date必填title必填Get the ancestry chain (title -> ... -> node) for a CFR node on a date.
date必填parttitle必填sectionFetch 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``.
date必填parttitle必填chaptersectionsubpartappendixsubtitlesubchapterList all agencies that appear in the CFR, with their title/chapter references.
无需输入参数。
List CFR corrections, optionally filtered by title and/or effective date.
datetitleList all corrections for a single CFR title.
title必填Full-text search over federal regulations, returning matching sections with hierarchy.
datepageorderquery必填titleper_pageagency_slugsGet the total number of CFR sections matching a search query.
datequery必填titleagency_slugsGet summary details (counts + metadata) for a CFR search query.
datequery必填titleagency_slugsGet search result counts broken down by CFR title.
datequery必填Get search result counts broken down by date (daily histogram).
datequery必填Get search result counts distributed across the CFR hierarchy.
datequery必填Get search-term suggestions for a partial CFR query.
query必填已满足适用检查项的 75%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
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/