CourtListener
$0.01/call
Search US court opinions, dockets, and legal data
Connect CourtListener tools
Cursor
Claude Code
Claude Desktop
Windsurf
VS Code
Cline
Roo Code
ChatGPT
Gemini CLI
Amazon Q
Goose
Augment
n8n
API / cURL
AI SDK
TypeScript SDK
{
"mcpServers": {
"courtlistener": {
"url": "https://courtlistener.mcp.xpay.sh/mcp?key=YOUR_API_KEY"
}
}
}Or connect all tools
Access all tools (including CourtListener) through a single MCP connection.
{
"mcpServers": {
"xpay": {
"url": "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
}
}
}Agent Discovery
Machine-readable catalogs for LLM agents and automation.
curl https://xpay.tools/llms.txt
curl https://xpay.tools/agents.txt
curl https://xpay.tools/skill.md
Pricing
Pay per tool call. No subscriptions.
14 CourtListener tools availableAbout CourtListener
CourtListener on xpay — Legal research and case law search without the signup friction
CourtListener is the largest free legal research database in the US, covering opinions, dockets, and PACER filings across federal and state courts. Developers and legal AI agents use it to find precedents, analyze case outcomes, track judge behavior, and validate citations—all critical for building legal research tools, compliance systems, and case strategy platforms. On xpay, you get CourtListener's full API surface as MCP-callable tools, billed per invocation with no subscription or per-provider account setup.
What's available
search_cases_by_problem— Extract legal keywords from a problem description and find relevant cases. Ideal for precedent discovery when you have a fact pattern but need the case law.get_case_details— Retrieve full opinion text, legal reasoning, and metadata for a specific case. Use this to deep-dive into precedent analysis and extract holdings.find_similar_precedents— Locate cases with analogous legal reasoning or outcomes to a reference case. Essential for comparative legal research.analyze_case_outcomes— Study outcome patterns across similar cases to forecast success likelihood. Useful for litigation strategy and risk assessment.get_judge_analysis— Examine a judge's historical rulings on similar issues. Helps predict judicial behavior and inform strategic decisions.validate_citations— Verify legal citations and discover related cases. Ensures citations are current and expands your case law network.get_procedural_requirements— Find filing rules, procedural deadlines, and jurisdiction-specific requirements for any case type.track_legal_trends— Identify emerging patterns in recent cases on a given topic. Useful for spotting shifts in judicial interpretation.search_pacer_dockets— Query federal court dockets from PACER via CourtListener's RECAP Archive. Find active and terminated cases with party, attorney, and filing details.get_docket_entries— Retrieve detailed docket entries, filings, and orders for a specific case (premium access required).search_parties_attorneys— Search for parties and attorneys across PACER cases. Track representation patterns and attorney success rates.analyze_case_timeline— Analyze case progression from docket entries, tracking delays and activity patterns (premium access required).
When CourtListener is the right tool
- You're building a legal research assistant or case law search feature and need authoritative US court data.
- You need to find precedents quickly based on a fact pattern or legal issue.
- You're analyzing judge behavior or court trends to inform litigation strategy.
- You're validating legal citations or building a citation graph.
- You need PACER docket data without managing a PACER subscription yourself.
- You're tracking procedural requirements across multiple jurisdictions.
- You want to predict case outcomes based on historical patterns.
When to choose something else
- You need international case law or non-US legal research—CourtListener focuses on US courts.
- You require real-time stock market data, financial news, or non-legal content—use Tavily or similar web search APIs instead.
- You need statutory text or legislative history—consider specialized legal databases like LexisNexis or Westlaw (not available on xpay).
- Your use case requires live PACER access with premium features beyond CourtListener's RECAP Archive—you may need direct PACER credentials.
- You're doing bulk legal document processing at massive scale—check CourtListener's rate limits and consider a direct enterprise agreement.
Pricing snapshot
All CourtListener tools on xpay are priced at $0.01 per call. This covers searches, detail lookups, analysis, and docket queries. No subscription, no monthly minimum—you pay only for what you invoke.
| Tool | Price per Call |
|---|---|
search_cases_by_problem | $0.01 |
get_case_details | $0.01 |
find_similar_precedents | $0.01 |
analyze_case_outcomes | $0.01 |
get_judge_analysis | $0.01 |
validate_citations | $0.01 |
get_procedural_requirements | $0.01 |
track_legal_trends | $0.01 |
search_pacer_dockets | $0.01 |
get_docket_entries | $0.01 |
search_parties_attorneys | $0.01 |
analyze_case_timeline | $0.01 |
Quickstart
Install the CourtListener MCP in Claude Code:
claude mcp add --transport http courtlistener "https://courtlistener.mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY"
Replace YOUR_XPAY_KEY with your xpay API key (get one free at https://xpay.tools after email or Google signup).
Once connected, Claude Code will expose CourtListener's tools by their native names. You can ask Claude to "search for cases about patent infringement" and it will call search_cases_by_problem with the appropriate keywords. Each invocation is billed at $0.01.
Alternatively, use the unified xpay endpoint to access all providers (CourtListener, Tavily, Apollo, etc.) through one MCP connection:
claude mcp add --transport http xpay "https://mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY"
With the unified endpoint, you'll use xpay_run("courtlistener/search_cases_by_problem", {...}) to invoke tools.
For Cursor, Windsurf, Cline, or VS Code with Copilot, add a server entry to your mcp.json:
{
"mcpServers": {
"courtlistener": {
"url": "https://courtlistener.mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY"
}
}
}
Why route CourtListener through xpay?
- No CourtListener account needed. xpay holds the upstream credentials; you authenticate once with your xpay API key and gain instant access to CourtListener's full API.
- Pay per call, not per month. At $0.01 per invocation, you're billed only for what you use. Ideal for prototyping, low-volume research, or integrating legal search into an agent without committing to a subscription.
- MCP-native integration. CourtListener tools appear as first-class MCP resources in Claude Code, Cursor, and other MCP-compatible IDEs. No custom HTTP client code needed.
- Unified billing across providers. If you also use Tavily, Apollo, or other xpay providers, all calls bill to one xpay account with a single invoice.
- Instant activation. Sign up, get your API key, and start calling CourtListener tools within minutes. No waiting for provider approval or managing separate credentials.
Frequently Asked Questions
CourtListener is the largest free legal research database in the US, containing millions of court opinions, dockets, and PACER filings. Developers use it to search case law, analyze precedents, track judge behavior, and validate citations. On xpay, CourtListener's API is exposed as MCP-callable tools so you can integrate legal research into AI agents and applications without building custom HTTP clients.
All CourtListener tools are $0.01 per call on xpay. There is no subscription, no monthly minimum, and no per-provider account fee. You pay only for the tools you invoke. For example, running `search_cases_by_problem` once costs $0.01; running it 100 times costs $1.00.
No. xpay holds the CourtListener credentials on your behalf. You sign up once at https://xpay.tools with your email or Google account, get an xpay API key, and immediately gain access to CourtListener's full API. You never create a separate CourtListener account or manage provider-specific credentials.
Use CourtListener to search for legal precedents by fact pattern, retrieve full case opinions and reasoning, analyze judge behavior and case outcomes, validate legal citations, find PACER docket entries, track procedural requirements, and identify trends in case law. It's ideal for building legal research assistants, case strategy tools, compliance systems, and litigation support applications.
Run `claude mcp add --transport http courtlistener "https://courtlistener.mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY"` in your terminal, replacing `YOUR_XPAY_KEY` with your xpay API key. Once connected, Claude Code will expose CourtListener's tools (like `search_cases_by_problem` and `get_case_details`) and you can ask Claude to use them directly.
Yes. Add a server entry to your `mcp.json` file with the URL `https://courtlistener.mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY`. Cursor, Windsurf, Cline, and VS Code with Copilot all support MCP servers via `mcp.json`. See the Quickstart section for the exact JSON structure.
For US case law, LexisNexis and Westlaw are premium alternatives but are not available on xpay and require separate subscriptions. For web search and general legal information, Tavily is available on xpay. If you need international case law or non-legal research, consider other xpay providers or specialized legal databases outside the xpay ecosystem.
Yes. Instead of installing the per-provider endpoint, use the unified xpay endpoint: `claude mcp add --transport http xpay "https://mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY"`. This exposes CourtListener, Tavily, Apollo, and all other xpay providers through a single MCP connection. You'll use `xpay_run("courtlistener/<tool_name>", {...})` to invoke tools.

