get_portfolio_rankings
Ranks the titles in force within a portfolio by how central each is to that portfolio's own law. This is computed per portfolio, not a filtered view of the corpus-wide ranking.
| Fact | Value |
|---|---|
| Tool | get_portfolio_rankings |
| Partner scope required | graph:read |
| Subscriber tier required | AI Pro |
Accepts as_at | no |
Parameters
| Name | Type | Required | Default |
|---|---|---|---|
portfolio | string | no | null |
limit | integer | no | 5 |
Notes
portfoliois matched case-insensitively against part of the department's name: "Treasury" matches "Department of The Treasury". A portfolio that matches nothing returns an emptyrankingslist, not an error.- Omit
portfolioto get the toplimittitles from every portfolio at once. portfolio_centrality_scoreandportfolio_pagerank_scoreare two measures of importance within the portfolio, each from 0 to 1.- Acts cited by almost every other title, such as the Acts Interpretation Act 1901, are excluded, because their citations say nothing about importance within a portfolio.
made_under_count, where counted, is the number of instruments in force the Federal Register records as made under the title. It is shown beside the score and is not part of it.
Request (get_portfolio_rankings with {"portfolio":"Treasury","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_portfolio_rankings", {
"portfolio": "Treasury",
"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_portfolio_rankings","arguments":{"portfolio":"Treasury","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 "...".
{
"portfolio_filter": "Treasury",
"rankings": [
{
"id": "c8f249e2-f3b5-4d43-9ac5-fd464e43a97c",
"title": "Income Tax Assessment Act 1997",
"short_title": "Income Tax Assessment Act",
"portfolio_centrality_score": 0.7125767440459525,
"portfolio_pagerank_score": 0.9138766595574594,
"made_under_count": 32,
"made_under_note": "In-force instruments FRL records as made under this title, matched to it by exact title or title id. Shown beside the score; not counted in it."
},
{
"id": "8d10b297-598e-4127-88ae-d7411655afe1",
"title": "Corporations Act 2001",
"short_title": "Corporations Act",
"portfolio_centrality_score": 0.6784005741988607,
"portfolio_pagerank_score": 1,
"made_under_count": 409,
"made_under_note": "In-force instruments FRL records as made under this title, matched to it by exact title or title id. Shown beside the score; not counted in it."
},
{
"id": "f8b19d76-a601-449a-ae9d-a37e4fe0a6b7",
"title": "Superannuation Industry (Supervision) Act 1993",
"short_title": "Superannuation Industry (Supervision) Act",
"portfolio_centrality_score": 0.5372209570022585,
"portfolio_pagerank_score": 0.6995077684219371,
"made_under_count": 1826,
"made_under_note": "In-force instruments FRL records as made under this title, matched to it by exact title or title id. Shown beside the score; not counted in it."
}
]
}
Errors
This tool returns no tool-specific errors. Check for an empty rankings list.