get_subgraph

Returns the nodes and edges around a set of seed titles in one call. Edges follow the same rules as get_network_graph, without the pinpoints.

Fact	Value
Tool	`get_subgraph`
Partner scope required	`graph:read`
Subscriber tier required	AI Pro
Accepts `as_at`	no

Parameters

Name	Type	Required	Default
`seed_ids`	array of string	yes
`depth`	integer	no	`1`
`limit`	integer	no	`100`

Notes

seed_ids accepts title ids, compilation ids or the legislation_id another tool returned.
One hop only, no self-references, no internal cross-references.
limit caps the edges, strongest first, at no more than 500. Lower it if the response is too large.
Law in force only. Seeds not in force are dropped; if none remains, the tool returns TITLE_NOT_IN_FORCE.

Request (get_subgraph with {"seed_ids":["C2004A03712"],"limit":3})

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_subgraph", {
                "seed_ids": [
                    "C2004A03712"
                ],
                "limit": 3
            })
            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_subgraph","arguments":{"seed_ids":["C2004A03712"],"limit":3}}}'

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": "2.1",
  "seeds": [
    "eae28dff-3ff5-48eb-af3f-38686e6f650e"
  ],
  "nodes": [
    {
      "id": "12671e7b-277f-4c8e-9e9d-930e06fabc09",
      "title": "Competition and Consumer Act 2010",
      "kind": "act",
      "portfolio": "Attorney-General's Department",
      "portfolio_count": 5,
      "portfolios": [
        "Attorney-General's Department",
        "Department of Climate Change, Energy, the Environment and Water",
        "Department of Industry, Science and Resources",
        "... 2 more"
      ],
      "in_degree": 8601,
      "out_degree": 7413,
      "centrality": 0.45092078200148433
    },
    {
      "id": "1bdfd6d1-82f1-494e-b046-167136e823d3",
      "title": "National Consumer Credit Protection Amendment (Mandatory Credit Reporting and Other Measures) Act 2021",
      "kind": "act",
      "portfolio": "Department of The Treasury",
      "portfolio_count": 1,
      "portfolios": [
        "Department of The Treasury"
      ],
      "in_degree": 45,
      "out_degree": 181,
      "centrality": 0.020014053354842017
    },
    {
      "id": "469bc692-e6d4-4f9f-8f8b-7e9299e391aa",
      "title": "National Consumer Credit Protection Act 2009",
      "kind": "act",
      "portfolio": "Department of The Treasury",
      "portfolio_count": 1,
      "portfolios": [
        "Department of The Treasury"
      ],
      "in_degree": 2091,
      "out_degree": 2033,
      "centrality": 0.06127453032398082
    },
    "... 1 more"
  ],
  "edges": [
    {
      "source": "469bc692-e6d4-4f9f-8f8b-7e9299e391aa",
      "target": "eae28dff-3ff5-48eb-af3f-38686e6f650e",
      "type": "external_citation",
      "weight": 139
    },
    {
      "source": "1bdfd6d1-82f1-494e-b046-167136e823d3",
      "target": "eae28dff-3ff5-48eb-af3f-38686e6f650e",
      "type": "external_citation",
      "weight": 123
    },
    {
      "source": "12671e7b-277f-4c8e-9e9d-930e06fabc09",
      "target": "eae28dff-3ff5-48eb-af3f-38686e6f650e",
      "type": "external_citation",
      "weight": 121
    }
  ],
  "depth_applied": 1,
  "limit": 3,
  "limit_requested": 3,
  "limit_applied": 3
}

Errors

Code	Meaning	What to do
`INVALID_ARGUMENT`	A seed id is malformed, or the response is too large to return	Correct the id, or lower `limit`
`TITLE_NOT_IN_FORCE`	No seed is in force	Show each seed's `frl_link`

Related tools

get_network_graph