courtlistener-mcp-server — Claude Code MCP server setup
Connects your coding assistant to CourtListener to search US judicial opinions, federal dockets, judge records, and oral argument transcripts.
Apache-2.0 1,420 installs ★ 4 updated 2026-10-18
claude mcp add --transport http courtlistener-mcp-server https://courtlistener-mcp-server--cyanheads.run.toolsWhat courtlistener-mcp-server 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.
What it helps with
- 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 for the agent
- 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.
How to install courtlistener-mcp-server
Platform CLI: remote server
claude mcp add --transport http courtlistener-mcp-server https://courtlistener-mcp-server--cyanheads.run.toolsPlatform CLI: remote server
codex mcp add courtlistener-mcp-server --url https://courtlistener-mcp-server--cyanheads.run.toolsConfig file
{
"mcpServers": {
"courtlistener-mcp-server": {
"url": "https://courtlistener-mcp-server--cyanheads.run.tools"
}
}
}Config file
{
"servers": {
"courtlistener-mcp-server": {
"type": "http",
"url": "https://courtlistener-mcp-server--cyanheads.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http courtlistener-mcp-server https://courtlistener-mcp-server--cyanheads.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about courtlistener-mcp-server
How to install courtlistener-mcp-server in Claude Code?
Run this terminal command: claude mcp add --transport http courtlistener-mcp-server https://courtlistener-mcp-server--cyanheads.run.tools.
What does courtlistener-mcp-server do?
It gives your agent 14 tools to search CourtListener, examine US opinions, inspect federal dockets, track judicial disclosures, and read argument transcripts.
Is a local Docker or Node environment required?
No, it connects over HTTP to https://courtlistener-mcp-server--cyanheads.run.tools, so you can use the service without running local servers.