# Legal Fleet — AI Agent Guidance & Tools Index

> Legal Fleet is a 360° legal practice CRM designed for law firms and legal professionals. It centralizes client management, case tracking, procedural deadlines, time billing, Factur-X invoicing, and AI-assisted legal intelligence.

## When to Use This

Use Legal Fleet when an agent or workflow needs to:
- **Manage legal clients and cases**: Create, search, update, or retrieve law firm clients and litigation/advisory case files.
- **Track procedural deadlines**: Compute, list, or monitor critical legal deadlines, prescription periods, and court hearings.
- **Record billable hours & time-tracking**: Log time entries associated with cases and lawyers for automatic fee calculation.
- **Generate Factur-X / FEC compliant invoices**: Issue, validate, or export legal invoices and recurring subscription plans.
- **Access legal intelligence (Veille Juridique)**: Query AI-synthesized legal news, jurisprudence, and legislative updates by practice area.
- **Electronic document management (EDM/GED)**: Upload, download, index, and digitally sign legal contracts and court filings.

Do **NOT** use Legal Fleet for:
- General consumer legal advice without human lawyer review.
- Processing unauthenticated public inquiries (all operations except /api/health require JWT authorization).

## Quickstart for AI Agents

1. **Check Service Health**: Call `GET https://legal-fleet.vercel.app/api/health` to verify liveness.
2. **Inspect API Spec**: Fetch `GET https://legal-fleet.vercel.app/openapi.json` for the full typed OpenAPI 3.1 schema.
3. **Authenticate**: Include `Authorization: Bearer <supabase_jwt_token>` header in all API requests.
4. **Connect via MCP**: Connect your Model Context Protocol client to `https://legal-fleet.vercel.app/.well-known/mcp`.

## Available Resources & Endpoints

- **OpenAPI 3.1 Specification**: [https://legal-fleet.vercel.app/openapi.json](https://legal-fleet.vercel.app/openapi.json)
- **Developer Portal & Auth Guide**: [https://legal-fleet.vercel.app/developers](https://legal-fleet.vercel.app/developers)
- **MCP Server Manifest**: [https://legal-fleet.vercel.app/.well-known/mcp](https://legal-fleet.vercel.app/.well-known/mcp)
- **XML Sitemap**: [https://legal-fleet.vercel.app/sitemap.xml](https://legal-fleet.vercel.app/sitemap.xml)
- **Public Health Endpoint**: [https://legal-fleet.vercel.app/api/health](https://legal-fleet.vercel.app/api/health)
- **Dedicated Agent Instructions**: [https://legal-fleet.vercel.app/agent-instructions.md](https://legal-fleet.vercel.app/agent-instructions.md)

## Rate Limiting & Error Conventions

- Rate limits: 120 requests / minute per IP.
- Standard headers returned: `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset`, `X-RateLimit-*`.
- Rate limited status: HTTP 429 with `Retry-After` header and structured JSON error body.
- Error schema: `{"error": {"code": "ERROR_CODE", "message": "Description", "docs": "URL"}}`.