# caselegis-mcp

California case law research tools for [Claude Desktop](https://claude.ai/download), [Cursor](https://cursor.sh), and any [MCP](https://modelcontextprotocol.io)-compatible AI assistant.

Powered by [Caselegis](https://caselegis.com) — search 566,000+ California opinions, check citation status (Red/Yellow/Green), and trace citation networks, all from inside your AI assistant.

## Setup

**1. Get an API key** at [caselegis.com/settings](https://caselegis.com/settings) → API Keys.

**2. Add to Claude Desktop** (`~/.claude/claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "caselegis": {
      "command": "uvx",
      "args": ["caselegis-mcp"],
      "env": { "CASELEGIS_API_KEY": "brfl_..." }
    }
  }
}
```

**3. Restart Claude.** The Caselegis tools will appear automatically.

## Tools

| Tool | What it does |
|---|---|
| `get_quota` | Check remaining monthly queries (free, doesn't count) |
| `search_cases` | Full-text search with court, date, and sort filters |
| `get_case` | Retrieve full opinion text and metadata |
| `get_citation_status` | Red/Yellow/Green — is this case still good law? |
| `get_citations` | Cases this opinion cites (outgoing) |
| `get_cited_by` | Cases that cite this opinion (incoming), filterable by treatment |

## Quota

| Plan | Queries/month |
|---|---|
| Free | 50 |
| Pro | 2,000 |

Upgrade at [caselegis.com/settings](https://caselegis.com/settings).

## Configuration

| Variable | Required | Description |
|---|---|---|
| `CASELEGIS_API_KEY` | Yes | Your API key (`brfl_...`) |
| `CASELEGIS_API_URL` | No | Override the API URL (default: production) |

## License

MIT