health

Returns the server's status, its schema versions and the counts of titles in force by kind. Call it first, to prove a connection works; a partner key also learns when it expires.

This tool takes no parameters.

Notes

• counts_by_kind counts titles the Federal Register records as in force. The titles Advisor serves can be slightly fewer, for example a title past a sunset date the Federal Register has not yet confirmed.
• payload_schema_versions gives the version of each tool's payload. Versions differ by tool; server_schema_version is the version every error speaks.
• deployment names the service and revision that answered.
• For a partner key, partner_key gives the client, the key's last four characters, expires_at and days_to_expiry, and a warning from 14 days before expiry.

Request (health with {})

Python SDK

import asyncio, os
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async def main():
    headers = {"Authorization": f"Bearer {os.environ['LAWATLAS_API_KEY']}"}
    async with streamablehttp_client("https://advisor.lawatlas.ai/api/mcp-http/mcp", headers=headers) as (read, write, _):
        async with ClientSession(read, write) as session:
            await session.initialize()
            result = await session.call_tool("health", {})
            print(result.content[0].text)

asyncio.run(main())

curl

curl -s https://advisor.lawatlas.ai/api/mcp-http/mcp \
  -H "Authorization: Bearer $LAWATLAS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"health","arguments":{}}}'

Response, as Advisor returned it on 10 October 2026. The tool's result is the JSON text of result.content[0].text; lists and long text are trimmed where marked "...".

{
  "status": "ok",
  "schema_version": "2.1",
  "server_schema_version": "3.5",
  "payload_schema_versions": {
    "search_legislation": "2.4",
    "list_recent": "2.4",
    "health": "2.1",
    "list_issuing_authorities": "1.0",
    "get_network_graph": "2.2",
    "get_subgraph": "2.1",
    "get_hansard_speech": "3.0",
    "list_hansard_filters": "1.1",
    "get_provision_tree": "3.5",
    "get_portfolio_functions_and_legislation": "3.5",
    "search_hansard": "3.5",
    "hansard_stats": "3.5",
    "search_provisions": "3.5",
    "find_definition": "3.5",
    "get_version_changes": "3.5",
    "get_provision_text": "3.5",
    "get_legislation": "3.5",
    "resolve_reference": null,
    "search_gazette": null,
    "get_amendment_history": "3.5",
    "get_portfolio_rankings": null,
    "get_disallowance_risks": null,
    "sunset_radar": null,
    "uncommenced_amendments": null,
    "get_uncommenced_text": null,
    "renew_subscription": null
  },
  "deployment": {
    "service": null,
    "revision": null
  },
  "corpus": {
    "as_at": "2026-10-10",
    "counts_by_kind": {
      "notifiable_instrument": 3475,
      "prerogative_instrument": 155,
      "continued_law": 213,
      "legislative_instrument": 24136,
      "constitution": 1,
      "act": 4773
    },
    "counts_by_kind_all_statuses": {
      "notifiable_instrument": 3552,
      "prerogative_instrument": 163,
      "continued_law": 213,
      "legislative_instrument": 25404,
      "constitution": 1,
      "act": 4798
    },
    "counts_by_issuing_authority": {
      "CASA": 9000,
      "CUSTOMS": 6584,
      "unassigned": 5417,
      "PARLIAMENT": 4773,
      "MINISTER": 2760,
      "ATO": 1897,
      "GG": 1100,
      "APRA": 386,
      "ASIC": 303,
      "TREASURER": 266,
      "AASB": 85,
      "AUASB": 77,
      "ACCC": 48,
      "TPB": 31,
      "RBA": 22,
      "AUSTRAC": 4
    }
  },
  "partner_key": {
    "client_id": "lac_sbx_01M4J4FGFBK9C6QD0DEG6CBR62",
    "key_ending": "2_Bo",
    "expires_at": "2027-01-08T05:27:24.928483Z",
    "days_to_expiry": 89
  }
}

Errors

Related tools

• renew_subscription