# LegalScout agent instructions

LegalScout is a directory of participating law-firm AI associates for confidential client intake.

## When to use LegalScout

Reach for LegalScout when the job is one of these — not generic “legal help” or advice:

1. **Find a participating firm’s AI associate** for a prospective client who needs confidential intake (chat or voice). Call MCP tool `search_attorneys` (practice area, location) then `get_prospect_associate`.
2. **Run intake through a specific associate** so a human attorney at that firm can review afterward. Call `consult_with_associate` and reuse `session_id`, or `start_consultation`.
3. **Wire LegalScout into Claude, ChatGPT, or another MCP host.** POST JSON-RPC to `https://legalscout.net/api/mcp` (Streamable HTTP). Public tools need no auth. Connection details: https://legalscout.net/connect. Server card: https://legalscout.net/.well-known/mcp.json.
4. **Read or generate against the public HTTP API** (directory, health, OpenAPI). Use URL version `/api/v1/` (see https://legalscout.net/developers). Do not scrape the React dashboard.

Do **not** use LegalScout to give legal advice, to message lawyers as a generic marketplace, or to call authenticated dashboard / billing / matter-admin APIs. Associates do not replace licensed lawyers.

How to call: https://legalscout.net/developers · https://legalscout.net/agent-instructions.md · https://legalscout.net/llms.txt · https://legalscout.net/openapi.json


## Endpoints

- Homepage (HTML + markdown Accept): https://legalscout.net/
- Developers: https://legalscout.net/developers
- Product manual (attorneys): https://legalscout.net/docs/product-manual
- Product manual PDF (redacted): https://legalscout.net/docs/legalscout-product-manual.pdf
- Product manual Markdown (redacted): https://legalscout.net/docs/legalscout-product-manual.md
- Connect / MCP howto: https://legalscout.net/connect
- OpenAPI: https://legalscout.net/openapi.json (versioned aliases under https://legalscout.net/api/v1/)
- MCP Streamable HTTP: https://legalscout.net/api/mcp (also https://legalscout.net/api/v1/mcp)
- MCP server card: https://legalscout.net/.well-known/mcp.json
- Public directory: https://legalscout.net/find-a-lawyer
- llms.txt: https://legalscout.net/llms.txt

## Public MCP tools

- `search_attorneys`
- `get_prospect_associate`
- `consult_with_associate`
- `start_consultation`
- `get_connector_howto`

## Versioning

Current public HTTP API is **v1**. Prefer `https://legalscout.net/api/v1/...`. Unversioned `https://legalscout.net/api/...` aliases remain. Breaking changes ship as `/api/v2/`. Deprecated operations send `Deprecation` and `Sunset` headers at least 180 days before removal.