Tools

claim_trial_key

A 30-day trial key, from inside the session, with no account.

What it does

The no-account route to a key, from inside 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. Optional argument: client_version, which is how the answer can tell you a newer plugin exists.

It is the other tool that answers without a key, beside check_access, and the only one of the pair that writes anything. Your agent runs it after you pick the no-account route over signing in, never on its own, since check_access reports both routes and you choose. It is not idempotent, so every successful call mints another key and spends one of the five an address may take each day, and it refuses outright when the session already holds a key or a sign-in, because a trial is for a developer who has neither.

A key returned into a session is recorded in that session's transcript, which the result says out loud. An account key is the one without an expiry or a lifetime total, so the trial is a taste of the full run rather than a replacement for one. Persist what comes back as UNGOVR_API_KEY and start a new session: the value is read at process start, so exporting it into a running session does nothing.

Parameters