get_provision_tree

Returns the structure of a title, starting at its top-level Chapters, Parts and Schedules. Use it to find the provision you need, then read it with get_provision_text.

Parameters

Notes

• Start with no node_id to see the top level, then pass a node's id back as node_id to expand it.
• depth is how many levels to descend below the starting point, and with no node_id the starting point is every root node. So depth=1 on a wide Act returns its roots and all their children.
• Pages. limit caps the nodes per page (default 75, server maximum 400) and cursor continues. A byte budget also applies; the response reports limit_requested and limit_applied.
• response_format="concise" (default) gives id, pinpoint, heading and child_count. "detailed" adds type, number, parent_id, sequence and word_count.

Request (get_provision_tree with {"legislation_id":"C2004A03712"})

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("get_provision_tree", {
                "legislation_id": "C2004A03712"
            })
            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":"get_provision_tree","arguments":{"legislation_id":"C2004A03712"}}}'

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 "...".

{
  "schema_version": "3.5",
  "result": [
    {
      "id": "4afcfb70-4a2b-4d88-a56b-b51395da10c8",
      "pinpoint": "Long Title",
      "heading": "Long Title",
      "child_count": 0
    },
    {
      "id": "3cbed345-a365-4bb0-b21b-24f9511fc836",
      "pinpoint": "Part I",
      "heading": "Preliminary",
      "child_count": 8
    },
    {
      "id": "fda9778f-8023-4464-abdc-c0ff62196162",
      "pinpoint": "Part II",
      "heading": "Interpretation",
      "child_count": 3
    },
    "... 72 more"
  ],
  "page": {
    "returned": 75,
    "total": 109,
    "next_cursor": "eyJvIjogNzV9",
    "truncated": false,
    "limit_requested": 75,
    "limit_applied": 75
  },
  "legislation_id": "eae28dff-3ff5-48eb-af3f-38686e6f650e",
  "node_id": null,
  "depth": 1,
  "notes": [
    "Expand any node with node_id=<id>. Nodes with children here include: Part I (8), Part II (3), Part III (3), Part IIIA (8), Part IIIB (4)."
  ],
  "usage": "Structure only - no provision text. Fetch a provision with get_provision_text, or find one by concept with search_provisions."
}

Data currency: Advisor serves the text of titles that the Federal Register of Legislation records as in force. It does not return the text of a repealed, ceased or sunset title, for any date.

• A title or a served provision carries a status block (status, or in_force in a list) with in_force, frl_status and confirmed_with_frl_at: when Advisor last confirmed the status with the Federal Register.
• Served text and search hits carry a compilation block with register_id, compilation_no, check_date and state. state is one of four values:
  • current: the Federal Register's latest list names the compilation the text comes from.
  • not_current: the Federal Register lists a newer compilation. Tell the user, and use the frl_link in the response.
  • pending_compilation: amendments have commenced that are not yet compiled, so the text does not include them.
  • not_confirmed: the Federal Register lists no current compilation, or Advisor holds no record of one. Treat it as unknown.
• TITLE_NOT_IN_FORCE and COMPILATION_NOT_CURRENT are answers, not failures. Show the user the Federal Register link in the response and do not fill the gap from another source.

Errors

Related tools

• get_provision_text