get_network_graph
Returns the nodes and edges around one title: which titles cite it, which it cites, or both. Each edge carries a weight and the pinpoints on each side.
| Fact | Value |
|---|---|
| Tool | get_network_graph |
| Partner scope required | graph:read |
| Subscriber tier required | AI Pro |
Accepts as_at | no |
Parameters
| Name | Type | Required | Default |
|---|---|---|---|
legislation_id | string | yes | |
direction | string | no | "both" |
depth | integer | no | 1 |
edge_types | array of string | no | null |
limit | integer | no | 100 |
Notes
directionisin(what cites this title),out(what it cites) orboth;inboundandoutboundare accepted, in any case.- One hop only.
depth_appliedreports what was used. edge_typesis any ofexternal_citation(between titles) andinternal_cross_ref(within the title). The default is every type exceptinternal_cross_ref.weightis the number of citations behind an edge.pinpoint.fromandpinpoint.tolist the provisions on each side, withfrom_distinctandto_distinctcounting them.limitcaps the edges, strongest first, at no more than 500.limit_requestedandlimit_appliedsay what was used.- Law in force only. Both ends of every edge are in force, so "what cites this" leaves out citations from law that has ended. A title never cites itself here; the seed's
self_referencescounts those. centralityon each node is a measure of how connected the title is across the whole corpus.
Request (get_network_graph with {"legislation_id":"C2004A03712","direction":"in","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_network_graph", {
"legislation_id": "C2004A03712",
"direction": "in",
"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_network_graph","arguments":{"legislation_id":"C2004A03712","direction":"in","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.2",
"seed": "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,
"pinpoint": {
"from": [
"s 133CP",
"s 133CP(1)",
"s 133CU",
"... 7 more"
],
"to": [
"s 20Q",
"Part V",
"s 4"
],
"from_distinct": 94,
"to_distinct": 3
}
},
{
"source": "1bdfd6d1-82f1-494e-b046-167136e823d3",
"target": "eae28dff-3ff5-48eb-af3f-38686e6f650e",
"type": "external_citation",
"weight": 123,
"pinpoint": {
"from": [
"s 133CP",
"s 133CP(1)",
"s 133CU",
"... 7 more"
],
"to": [
"s 20Q",
"Part 3"
],
"from_distinct": 85,
"to_distinct": 2
}
},
{
"source": "12671e7b-277f-4c8e-9e9d-930e06fabc09",
"target": "eae28dff-3ff5-48eb-af3f-38686e6f650e",
"type": "external_citation",
"weight": 121,
"pinpoint": {
"from": [
"s 56ET",
"s 4",
"s 4(1)",
"... 7 more"
],
"to": [
"Part IIIC",
"Part V",
"Part VIB",
"... 3 more"
],
"from_distinct": 76,
"to_distinct": 6
}
}
],
"truncated": true,
"depth_applied": 1,
"limit": 3,
"limit_requested": 3,
"limit_applied": 3
}
Errors
| Code | Meaning | What to do |
|---|---|---|
INVALID_ARGUMENT | A direction or edge_types value is unknown, or an id is malformed | Use a value from the list in the message |
TITLE_NOT_IN_FORCE | The seed title is not in force | Show the frl_link |