[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [CourtListener opinion search](https://spiral.ai/integrations/opencode/courtlistener-opinion-search)

# How to Use CourtListener opinion search in opencode

Find published U.S. court opinions with case names and excerpts from the decisions. Use it to build a reading list for a legal issue or locate an opinion by case name or citation.

|  |  |
| --- | --- |
| Model | CourtListener opinion search |
| Available through | Alexandria |
| Category | Public Records |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with CourtListener opinion search in opencode

- Use CourtListener opinion search to find Google LLC v. Oracle America, Inc. Add the returned case names and excerpts to a research note in this project.
- Use CourtListener opinion search to find Ninth Circuit opinions discussing software copyright filed during 2025. Build a table from the returned case names and excerpts.
- Use CourtListener opinion search to find opinions mentioning the Digital Millennium Copyright Act filed during October 2026. Add the returned results to this project's research notes.
- Use CourtListener opinion search to find published Supreme Court opinions with Microsoft in the case name. Create a reading list from the returned results.
- Use CourtListener opinion search to find Second Circuit opinions discussing fair use filed during 2025. Compare the returned case names with our existing research notes and flag repeated names.

## How to set up CourtListener opinion search in opencode

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run CourtListener opinion search**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "courtlistener-com/opinions/search_opinions",
    "input": {
      "query": "<query>"
    }
  }'
```

Then paste one of the prompts above: opencode finds CourtListener opinion search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/opencode

## CourtListener opinion search tools and prices

- [CourtListener · Search opinions](https://spiral.ai/tools/alexandria/courtlistener-com/opinions/search_opinions) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| court |  | — | CourtListener court ids (not jurisdiction or state names) to restrict the search to, e.g. scotus, ca9, nysd, cal, calctapp, ny, nyappdiv, tex, texapp, fla. An unknown id such as texas, tx or ca matches nothing and returns zero results. List every court you need: ny does not include nyappdiv. Use the courts function to find ids (jurisdiction S / SA are state supreme and appellate courts). |
| judge |  | — | judge |
| query |  | — | Full-text query. Supports CourtListener operators: quoted phrases, AND/OR/NOT, fielded clauses such as citation:("410 U.S. 113") or cites:(cluster_id). Quote a statute to find opinions citing it, e.g. "42 U.S.C. § 1983". |
| cursor |  | — | Not served keyless: the feeds have no further pages, so any cursor fails with a non-retryable upstream_blocked error. |
| citation |  | — | Reporter citation, e.g. 410 U.S. 113. |
| cited_gt | 0 to … | — | Only clusters cited more than this many times. |

## What can you do with CourtListener opinion search in opencode?

Build a case research table from CourtListener's published opinion results. A coding agent can organize case names and excerpts in your project and flag repeated names for review.

### Build a research reading list

Find published opinions discussing software copyright, then turn the returned case names and excerpts into a shortlist for closer reading.

### Locate a known decision

Search for Google LLC v. Oracle America, Inc. by case name or citation to find the corresponding opinion result.

### Prepare a court-specific topic digest

Collect matching Ninth Circuit opinions about arbitration within a defined filing period and organize their case names and excerpts for review.

### Compare research across jurisdictions

Run separate searches for California and New York appellate opinions about noncompete agreements. Build separate reading lists from the returned decisions.

### Find decisions discussing a statute

Search opinion text for the Digital Millennium Copyright Act and collect excerpts that help a researcher choose which decisions to read.

### Maintain a public policy research queue

Check for matching published opinions about EPA rulemaking and add newly encountered case names to a review queue.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All opencode guides](https://spiral.ai/integrations/opencode)

## CourtListener opinion search in other agents

- [Amp](https://spiral.ai/integrations/amp/courtlistener-opinion-search)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/courtlistener-opinion-search)
- [Claude](https://spiral.ai/integrations/claude-desktop/courtlistener-opinion-search)
- [Claude Code](https://spiral.ai/integrations/claude-code/courtlistener-opinion-search)
- [Cline](https://spiral.ai/integrations/cline/courtlistener-opinion-search)
- [Codex](https://spiral.ai/integrations/codex/courtlistener-opinion-search)
- [Cursor](https://spiral.ai/integrations/cursor/courtlistener-opinion-search)
- [Devin](https://spiral.ai/integrations/devin/courtlistener-opinion-search)
- [dots](https://spiral.ai/integrations/dots/courtlistener-opinion-search)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/courtlistener-opinion-search)
- [Gemini](https://spiral.ai/integrations/gemini/courtlistener-opinion-search)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/courtlistener-opinion-search)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/courtlistener-opinion-search)
- [goose](https://spiral.ai/integrations/goose/courtlistener-opinion-search)
- [Grok](https://spiral.ai/integrations/grok/courtlistener-opinion-search)
- [Grok Build](https://spiral.ai/integrations/grok-build/courtlistener-opinion-search)
- [Hermes](https://spiral.ai/integrations/hermes/courtlistener-opinion-search)
- [Instinct](https://spiral.ai/integrations/instinct/courtlistener-opinion-search)
- [Manus](https://spiral.ai/integrations/manus/courtlistener-opinion-search)
- [Muse](https://spiral.ai/integrations/muse/courtlistener-opinion-search)
- [Muse Code](https://spiral.ai/integrations/muse-code/courtlistener-opinion-search)
- [n8n](https://spiral.ai/integrations/n8n/courtlistener-opinion-search)
- [Notion](https://spiral.ai/integrations/notion/courtlistener-opinion-search)
- [OpenClaw](https://spiral.ai/integrations/openclaw/courtlistener-opinion-search)
- [Perplexity](https://spiral.ai/integrations/perplexity/courtlistener-opinion-search)
- [Raycast](https://spiral.ai/integrations/raycast/courtlistener-opinion-search)
- [VS Code](https://spiral.ai/integrations/vscode/courtlistener-opinion-search)
- [Windsurf](https://spiral.ai/integrations/windsurf/courtlistener-opinion-search)
- [Zapier](https://spiral.ai/integrations/zapier/courtlistener-opinion-search)

## More opencode guides

- [CourtListener docket search](https://spiral.ai/integrations/opencode/courtlistener-docket-search)
- [Cámara de Diputados federal law catalog](https://spiral.ai/integrations/opencode/c-mara-de-diputados-federal-law-catalog)
- [CourtListener docket entries](https://spiral.ai/integrations/opencode/courtlistener-docket-entries)
- [Cámara de Diputados law articles](https://spiral.ai/integrations/opencode/c-mara-de-diputados-law-articles)
- [CourtListener court directory](https://spiral.ai/integrations/opencode/courtlistener-court-directory)
- [Cámara de Diputados law reform history](https://spiral.ai/integrations/opencode/c-mara-de-diputados-law-reform-history)

## Questions about CourtListener opinion search in opencode

**Can opencode use CourtListener opinion search?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run CourtListener opinion search like any built-in tool.

**How much does CourtListener opinion search cost in opencode?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your opencode plan is separate.

**Do I need an Alexandria account to use CourtListener opinion search in opencode?**

No. Spiral runs CourtListener opinion search on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up CourtListener opinion search in opencode?**

About two minutes: add the server, then sign in, then check it.

**Does opencode wait while CourtListener opinion search runs?**

CourtListener opinion search runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

**Does CourtListener cover every U.S. court decision?**

CourtListener estimates coverage of more than 99.9% of published precedential U.S. case law. That estimate covers a defined category of decisions, not every filing, and case law search returns published decisions by default.

**How far back does CourtListener's opinion collection go?**

The collection includes opinions from Harvard University's law library spanning more than 365 years. Its historical material combines several institutional sources.

**How fresh are CourtListener opinions?**

CourtListener collects case law as courts release it. Its description ties updates to court publication rather than a fixed daily release.

**How many decisions does a search feed return?**

CourtListener's search feed returns the first 20 matching decisions. For broad topics such as copyright or antitrust, use narrower court and date ranges to make that limited result set useful.

**Why can the same decision appear more than once?**

CourtListener may collect multiple versions when a court revises a decision. Similar case names can therefore identify different versions of the same ruling.

