プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説 ログイン

CourtListener

作者:Vaquill-AIバージョン 0.1.0i★ 5iクラウドで動く公式サイト ↗
レジストリ名io.github.Vaquill-AI/courtlistener-mcp

インストール方法

できること

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

作者による原文

  • 接続方法 クラウドで動く
  • アカウントまたはキー X-CourtListener-Token が必要
  • カテゴリ 法律・行政データ

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気9/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ7/1230 日以内のリリースかコード更新で満点
応答中8/8前回の確認でクラウドのエンドポイントが応答
利用スコア25/100

品質: 基本チェック 5/5 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

CourtListener をインストールして。https://mcp.popnx.com/i/vaquill-ai-courtlistener-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 5/5 合格 · 質問内容は提供元のサーバー(courtlistener-mcp.vaquill.ai)を通ります · ✓ コマンド確認済み 2026年11月20日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげます · 約 5 分

CourtListener のキーが必要です(提供元のサイトで作成) · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加

  1. CourtListener に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  2. Claude の Connectors ページを開く

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  3. 「Add」→「Custom」→「Web」を押し、この 2 つを入力

    ここからコピーして Claude の同じ名前の欄に貼り付け、Continue を押します

    Name · 名前CourtListener
    Remote MCP server URL · アドレスhttps://courtlistener-mcp.vaquill.ai/mcp/

    Request headers に、この名前と値を追加

    ヘッダー名X-CourtListener-Token
    値<ここにキーを貼り付け>

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

    Claude が検出したサインイン設定の画面で Continue を押す · Authentication は作者の説明どおり(Sign in now・Sign in when needed・No sign in)を選び Add を押します

  4. チャットで有効にする

    +ConnectorsCourtListener

  5. 試してみる

    CourtListener を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が CourtListener を使っていると言うか、回答に CourtListener のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ CourtListener につなげません

CourtListener は接続時に自分のキーが必要ですが、OpenAI のヘルプページは OAuth ログインしか説明しておらず、確認できたキー入力方法がありません

代わりにできること

A · CourtListener につなげるアプリを使う

  • CourtListener のキーが必要です(提供元のサイトで作成) · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加
  • CourtListener のキーが必要です(提供元のサイトで作成)
  • CourtListener のキーが必要です(提供元のサイトで作成)
  • CourtListener のキーが必要です(提供元のサイトで作成)

B · 法律・行政データ の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげます · 約 5 分

CourtListener のキーが必要です(提供元のサイトで作成)

  1. CourtListener に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  2. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  3. このコマンドを貼り付けて Enter

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

    Enter の前に「your-value」を自分のキーに書き換えてください

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  4. Claude Code で /mcp と入力

    CourtListener が一覧にあり、接続済みと表示されれば OK です

  5. 試してみる

    CourtListener を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が CourtListener を使っていると言うか、回答に CourtListener のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげます · 約 5 分

CourtListener のキーが必要です(提供元のサイトで作成)

  1. CourtListener に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  2. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  3. キーを入力

    CourtListener の設定で X-CourtListener-Token が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  4. Cursor の AI チャットを Agent モードで開く

  5. 試してみる

    CourtListener を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が CourtListener を使っていると言うか、回答に CourtListener のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげます · 約 5 分

CourtListener のキーが必要です(提供元のサイトで作成)

  1. CourtListener に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  2. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  3. キーを入力

    CourtListener の設定で X-CourtListener-Token が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  4. VS Code の AI チャットを Agent モードで開く

  5. 試してみる

    CourtListener を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が CourtListener を使っていると言うか、回答に CourtListener のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

Web 経由でつなぐアプリ用のアドレス

アドレスhttps://courtlistener-mcp.vaquill.ai/mcp/

JSON 設定は下の「開発者向け」にあります

つまずいたら?CourtListener を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

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"
      }
    }
  }
}

自分で入力する値

  • X-CourtListener-Token 秘密 必須 HTTP header
    https://www.courtlistener.com/help/api/rest/ で無料取得できる CourtListener API トークン。サーバーがキーを保存することはありません。
    英語の原文を見るYour free CourtListener API token from https://www.courtlistener.com/help/api/rest/. The server never stores your key.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
npm/PyPIにない
接続方法
クラウドで動く
トランスポート
streamable-http
最新バージョンi
0.1.0
レジストリ公開日i
2026年5月15日
コードの最終更新i
2026年9月7日
最終確認
2026年11月19日
作者
Vaquill-AI
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

インターネット経由でつなげるアプリ

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

すべてのアプリと長所・短所 →

できること

ツールの名前と説明は、サーバーが2026年11月19日に返したそのままの内容です。書いたのは作者で、私たちではありません。プレーンテキストとして表示しています。

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

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月20日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント Vaquill-AI で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:2 か月前

  • ✓ 合格

    ライセンスがある

    MITを使用

  • ✓ 合格

    エンドポイントが応答する

    238ミリ秒で応答(HTTP 200)

  • – 対象外

    OAuthでサインイン

    サインイン不要

  • ✓ 合格

    ツールの説明に隠れた指示がない

    34件のツールの説明を読み、AIへの隠れた指示は見つかりませんでした

クラウドのアドレスは直近 5 回中 5 回応答 · 最新 238 ms · 確認日 2026年11月19日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

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

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

法律・行政データのほかのサーバーとの比較i

  • このカテゴリのほかの1961件のうち96%よりスターが多い
  • このカテゴリのほかの1961件のうち7%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの1961件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

CourtListenerは安全ですか?

当てはまる基本チェック5項目のうち5項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:X-CourtListener-Token

パソコンで動きますか、それともクラウドですか?

作者のクラウドで動きます。インストール不要でインターネット経由でつながりますが、送った内容は作者のサーバーを通ります。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は2 か月前、最新バージョン(0.1.0)がレジストリに届いたのは6 か月前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。

代わりに使えるものは?

同じカテゴリには:Global law, Open Legal Data (Germany), LibreJustice, InfraNode, Fedlex Connector

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Global law

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

作者:lexifina広く使われている★ 210510 日前更新

クラウドで動く✓ lexifina.com

LibreJustice

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

作者:librejustice初期★ 382 か月前更新

クラウドで動く✓ 提供元 · librejustice.fr

InfraNode

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

作者:street1983nk初期★ 185 か月前更新

クラウドで動く✓ 提供元 · infranode.dev
似たものと比べる
これ
CourtListener
Global lawOpen Legal Data (Germany)LibreJusticeInfraNodeFedlex Connector
動く場所クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要はいいいえいいえいいえいいえいいえ
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック5/54/44/44/44/44/4
ライセンスMITNOASSERTIONMITApache-2.0Apache-2.0MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

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.