Docs menu
Get started
Quickstart Install: Claude Code Install: Codex Install: Kiro Install: other clients API keysConcepts
How a run works The app profile The severity model What a run does not sayTools
check_access claim_trial_key set_profile run_lint get_law resolve_domain_jurisdiction submit_feedback upload_lint_runGuides
A whole run, end to end Console TestPack in CIReference
Endpoint and transport lexlint.yml schema Errors ChangelogHelp
Support and feedbackGet started
API keys
Every tool runs on your own UnGovr Open Data key, which is free. Signing in to your UnGovr account works in its place, and the two law lookups also answer with neither, up to a daily limit.
Get a key
LexLint holds no keys: yours is passed through to the data API on your behalf. check_access answers without a key, so you can test the connection before you have one, and claim_trial_key answers with an empty key header because it mints one. get_law and resolve_domain_jurisdiction answer without one up to a daily limit, which check_access reports as free_lookups. The other four refuse until you have a key or have signed in, and say how.
There are three ways to get one:
-
/lexlint:lexlint-keyin a Claude Code session. It hands you a sign-in link for a free one, takes the key you paste back, and puts it where your next session will read it: on Claude Code that is theenvblock of your user settings file, chmod 600, and never a file that gets committed. -
claim_trial_keyfrom any agent that sends an empty key header, without leaving the session. It mints a 30-day trial key good for 50 requests and 10 jurisdictions over its whole life and returns it in the result, with no account, no sign-in and no email. - The page https://lexlint.io/trial in a browser. A key made with an account at https://www.ungovr.org/open-data/api-keys has no expiry.
Where the key goes
The key travels as the X-API-Key header on every request to
mcp.lexlint.io, which passes it through to the UnGovr Open Data API on your
behalf. It goes in X-API-Key and nowhere else: an
Authorization: Bearer header is read as an OAuth access token, never as a key.
A client that sends neither header has no key to pass through. It reads the law up to
the daily limit, and a tool that needs an account, or a lookup past the limit, answers
with an HTTP 401 that asks the client to sign in through ungovr.org. A client that can
sign in turns that into its own sign-in step (in Claude Code, /mcp), and
the call then runs once you are signed in. Signing in gives the client an access token for your account, sent as
Authorization: Bearer and metered on your account's allowance like a key.
Every 401 and its fix are on the errors page.
The plugin reads the value from UNGOVR_API_KEY at process start rather than
holding a copy of its own, so the key is never written into the server registration, and a
key exported into an already-running session is read by nothing.
What it meters
LexLint stores nothing unless you explicitly ask it to: your key is passed through
to the UnGovr Open Data API on every call, and the upstream free tier (currently 50
requests per day) is the only meter for a key or a sign-in. A caller with neither is
counted on the free law lookups instead, one per call, and nothing is charged to any
account. The one exception is upload_lint_run,
covered in the tool reference: a run reaches the portal only when you upload it
yourself from the CLI, after LexLint has shown you exactly what it contains and you
have said yes, and it is then kept against your UnGovr account rather than against
the stateless worker behind mcp.lexlint.io. Rate-limit and authentication errors come back from upstream
unchanged.