Get a credential

Advisor accepts two credentials. A subscriber signs in through their MCP client with their Advisor account. A partner platform, which calls Advisor with no person present, holds an API key. Use the one that matches who is making the calls.

FactSubscriber sign-inPartner API key
Who it is forA person using an AI clientA platform's backend, with no person present
How it is sentOAuth 2.1 access token, handled by the clientAuthorization: Bearer <API key> on every request
How you get itSign in when your client asksIssue it on the Advisor partner page
What it needsAn active Advisor AI Pro subscriptionAn organisation owned by an AI Pro subscriber
LifetimeManaged by your client90 days; rotate before it expires

Before you begin

Subscriber sign-in

  1. Add Advisor to your client (Connect a client).
  2. When the client asks, sign in with your Advisor account in the browser it opens.
  3. Call health to check the connection.

Your client registers itself with Advisor's sign-in service (OAuth dynamic client registration). Do not paste a Client ID into a client that registers itself: a Client ID registered for one client fails in another.

Partner API key

  1. In Advisor, open the Partner page and create your organisation. Accept the partner terms, and the Hansard conditions of use if you will call the Hansard tools.
  2. Add a client for each workload or environment.
  3. Issue a key. It is shown once: copy it into your secret store.
  4. Set it as LAWATLAS_API_KEY where your platform runs, and connect (Connect a client, partner tabs).

See Partner API keys for rotation, revocation and the IP allowlist.

Warning: Calls made with a key are billed to the AI Pro subscription of the organisation that owns it, at the published per-call price. Each call that returns content is billed once; a call that finds nothing, or is refused, is not.

Troubleshooting

ProblemCauseSolution
HTTP 401 with a keyThe key is unknown, revoked, suspended or expired, or was issued in another environmentCheck its status on the partner page; issue a new key
FORBIDDEN: keys are pausedThe owning organisation's AI Pro subscription is not activeRenew the subscription
TERMS_REQUIRED on a Hansard toolThe organisation has not accepted the current Hansard conditionsAccept them on the partner page

Next steps