list_portals
Lists the source portals available through this tool, with metadata such as jurisdiction and language. A jurisdiction may have multiple portals, including those maintained by regulators or ministries.
When to use: When you need portals, legal websites, or sources for a known iso. Pass optional name, tag, or lang only to narrow that list. When not: Do not use this to read a document. For metadata use list_documents. For plain text use list_full_text. For structured Markdown use list_markdown. For a complete citation bundle use evidence_pull. For a temporary source-file URL use document_presigned_url. Do not call without an iso from list_jurisdictions. Skip if you already have this portal list for the same iso and filters.
Parameters: iso (required) is a jurisdiction code from list_jurisdictions (e.g. BE, or US_CA for a state). name, tag, and lang are optional and combined with AND: name is a case-insensitive substring of the portal name, tag must match one portal tag exactly, lang must match the language name exactly (e.g. English). With limit, next_id parameters to paginate the results. Empty data means the iso is outside the subscription, or no portal with crawled links matched.
Behavior: Read-only SELECT; does not create, update, or delete records, files, or credentials. The only effect is a database read. Auth: tools/call requires OAuth 2.0 or a Bearer token (401 if missing, invalid, revoked, or no active subscription). Rate limits: none at the MCP layer; safe to retry. Not cached; each call reads current subscription and portal data. Portals with total_links of 0 are omitted.
Returns: A list of portals matching the filters, with pagination information.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"iso": "<iso>"
},
"name": "list_portals"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| iso | Yes | iso (required) is a jurisdiction code from list_jurisdictions (e.g. BE, or US_CA for a state). | |
| lang | No | Exact language name, e.g. English | |
| name | No | Case-insensitive substring of the portal name | |
| limit | No | Number of portals to return | |
| next_id | No | Next portal ID to return | |
| portal_id | No | Portal ID | |
| portal_tags | No | Exact portal tag; the portal must include this tag | |
| advanced_search | No | Advanced search enabled |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | Portals in the requested jurisdiction that have crawled links; empty if none match. | |
| message | Yes | Result message | |
| pagination | No |