# courtlistener-mcp-server

Connects your coding assistant to CourtListener to search US judicial opinions, federal dockets, judge records, and oral argument transcripts.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1420 installs · ★ 4 repo stars
- Author: cyanheads
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cyanheads/courtlistener-mcp-server
- Updated: 2026-10-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/courtlistener-mcp-server

## What it does

This server connects AI assistants to CourtListener's corpus of more than 9 million court opinions and RECAP mirrors of PACER filings. It provides 14 tools covering full-text searches with status filters, citation resolution, and variant text extraction across majority, concurring, and dissenting views.

Beyond published case law, assistants can inspect docket entries, review attorneys of record, and examine judge profiles alongside their educational backgrounds. The tools also fetch speech-to-text transcripts of appellate oral arguments and parse judicial financial disclosures, converting raw code markers into dollar ranges.

Interaction runs directly over HTTP via a public hosted endpoint, so configuring local runtimes like Bun or Docker is not necessary. Result pages cap at 20 rows for searches, requiring pagination via `next_cursor` tokens rather than arbitrary page size increases.

## Requirements
- Remote server: `https://courtlistener-mcp-server--cyanheads.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http courtlistener-mcp-server https://courtlistener-mcp-server--cyanheads.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add courtlistener-mcp-server --url https://courtlistener-mcp-server--cyanheads.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "courtlistener-mcp-server": {
            "url": "https://courtlistener-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "courtlistener-mcp-server": {
            "type": "http",
            "url": "https://courtlistener-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http courtlistener-mcp-server https://courtlistener-mcp-server--cyanheads.run.tools
```

## When to use it
- query US case law with filters for courts, dates, and publication status
- trace citation networks across related judicial opinions
- retrieve federal dockets, party records, and document entries from RECAP
- access oral argument audio links and spoken-text transcripts

## Example prompts
- Search CourtListener opinions for antitrust claims involving tech platforms and sort by cite count.
- Resolve citation 410 U.S. 113 to its opinion cluster and fetch the majority text.
- Get docket parties and appearing attorneys for case name Smith v. Jones.

## Similar
- [document-hunter](https://affpapa.org/en/nevibecode/skills/document-hunter.md) — skill · 256 installs
- [crossref-mcp-server](https://affpapa.org/en/nevibecode/mcp/crossref-mcp-server.md) — MCP server · 2610 installs
- [Google Scholar](https://affpapa.org/en/nevibecode/mcp/google-scholar.md) — MCP server · 954 installs
- [literature-search-openalex](https://affpapa.org/en/nevibecode/skills/literature-search-openalex.md) — skill · 3400 installs
- [openalex](https://affpapa.org/en/nevibecode/skills/openalex.md) — skill · 484 installs
- [cnki-parse-results](https://affpapa.org/en/nevibecode/skills/cnki-parse-results.md) — skill · 420 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
