CourtGPT Legal Trust Report
A transparent register of what each legal surface actually shows today — accuracy, coverage, freshness, and tooling maturity.
How to read this report
- Status mirrors the pill rendered on the legal page itself (`Live` / `Demo data` / `Limited data`).
- Coverage bands describe the data the page renders, not the regulator or jurisdiction it references.
- Promotion env vars are server-side only; absence of the var means the honesty copy shown to the user is the limited / demo state, not a hidden live mode.
- No `PUBLIC_`-prefixed env var is read by any legal surface — keys stay server-side inside Convex actions.
Surface-by-surface register
Congress
Limited dataNo live key configured. The page renders an honest empty state with curated recent-activity links pointing at Congress.gov URLs. The pill is `Limited data` until a server-side `CONGRESS_GOV_KEY` is provisioned.
- Capability
congress-bills- Accuracy
- None
- Coverage
- None
- Freshness
- Static
- Tooling
- Unconfigured
- Promotion env var
CONGRESS_GOV_KEY- Upstream owner
- Library of Congress · Congress.gov
- Last refreshed
- —
Source of truth
src/pages/api/legal/congress/* → convex/legalDatasets.ts → api.congress.gov- Known gaps
- Public bill search is disabled; no API key is provisioned on the server.
- No author / sponsor data, no vote records, no committee activity yet.
- Recent activity rail is curated; it does not reflect current-day activity.
Laws
Demo dataThe production search path is backed by the CourtGPT laws service and is gated on `LAWS_API_URL`; when it is unavailable, the surface shows no statute rows rather than synthetic results. Curated reference material remains separately labeled and is not presented as live search.
- Capability
state-laws- Accuracy
- Paraphrased
- Coverage
- Sample
- Freshness
- Curated
- Tooling
- Demo
- Promotion env var
LAWS_API_URL- Upstream owner
- CourtGPT · Curated state-laws corpus (DigitalOcean `laws_dashboard`)
- Last refreshed
- 2026-07-27
Source of truth
LAWS_API_URL → laws-api → convex/legalDatasets.ts- Known gaps
- Live search is env-gated; unconfigured deployments do not expose a search dataset.
- Search is keyword-only; no section-level pinpoint, no semantic ranking.
- 55 jurisdictions are covered; the corpus is not exhaustive of every state code.
- No legislative history or amendment chain yet.
Directory
Limited dataRenders curated directory entries (federal courts, judges, agencies, practitioner resources) with honest limited-data copy. The page is structurally complete but no live backend ships; the first-party directory backend is a planned capability and the Convex action does not yet exist.
- Capability
directory- Accuracy
- Curated
- Coverage
- Sample
- Freshness
- Static
- Tooling
- Unconfigured
- Promotion env var
DIRECTORY_API_URL- Upstream owner
- CourtGPT · Curated directory + U.S. Courts public reference
- Last refreshed
- 2026-07-27
Source of truth
src/data/directoryCourts.ts · directoryJudges.ts · directoryAgencies.ts · directoryPractitioners.ts- Known gaps
- No live directory backend; all data is curated static samples.
- No address / phone / clerk-of-court records beyond the curated sources.
- No practitioner admission rosters; no bar lookup yet.
- Coverage is structural: federal courts + categories, not every state-level court.
Visual Law Browser
Limited dataA curated grid of public-domain legal research sources grouped by authority (courts, agencies, archives). It is a public reference surface, not a connector — it does not call `listConnectors` and is not part of the product MCP capability.
- Capability
visual-browser- Accuracy
- Curated
- Coverage
- Sample
- Freshness
- Static
- Tooling
- Unconfigured
- Promotion env var
BROWSER_API_URL- Upstream owner
- CourtGPT · Curated public sources (Courts · Agencies · Research archives)
- Last refreshed
- 2026-07-27
Source of truth
src/data/legalSources.ts · browserTabs.ts · courtListenerMirrors.ts → public sources (open access)- Known gaps
- All entries are curated; no live explore / pagination is wired.
- No per-source live health probe; mirror URLs are review-only.
- No search across registered sources; the in-page search is a curated matcher.
- No save / bookmark; the visual browser is read-only.
Caveats per surface
- No MCPCongress data is not exposed as a product MCP connector — `mcp` capability stays blocked.
- Server-side only`CONGRESS_GOV_KEY` is read inside Convex actions; no client bundle ships it.
- No verbatim textSnippets are short factual paraphrases under the fair-use threshold; source URLs point at the official state portal.
- Not MCPLaws corpus is a first-party Convex action; it does not flip the product MCP capability to `available`.
- Registry only`directory` is a registered capability id; the backing action is not yet implemented.
- No portal scrapingLive directory data will land only via a vetted first-party backend.
- Not MCPThe browser is intentionally separate from the product MCP capability (which stays blocked).
- Read-onlyNo write surface, no connector registration, no tool execution.