TRELLO_GET_LISTS_BY_ID_LIST
Retrieves a Trello list by its unique ID, optionally including details for its cards and parent board.
This record as markdown: /tools/trello/trello-get-lists-by-id-list.md
What TRELLO_GET_LISTS_BY_ID_LIST does on Trello
AI agents call TRELLO_GET_LISTS_BY_ID_LIST to retrieve information from Trello without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.
| Parameter | Type | Required | Description |
|---|---|---|---|
board | string | — | Determines whether the board object the list belongs to is returned. Set to 'true' to include board details or 'false' to omit them. |
cards | string | — | Determines whether cards are returned as part of the list data. Valid values are 'all', 'closed', 'none', or 'open'. |
fields | string | — | Specifies the fields for the list itself to be returned. Valid values are 'all' or a comma-separated list of list fields: closed, idBoard, name, pos, or subscri |
idList | string | — | The ID of the Trello list to retrieve. |
card_fields | string | — | Specifies the fields for cards to be returned if 'cards' is not 'none'. Valid values are 'all' or a comma-separated list of card fields: badges, checkItemStates |
board_fields | string | — | Specifies the fields for the board to be returned if 'board' is 'true'. Valid values are 'all' or a comma-separated list of board fields: closed, dateLastActivi |
Parameters from the server's own tool schema.
Why TRELLO_GET_LISTS_BY_ID_LIST is rated Low
This tool performs a read-only query operation that retrieves existing data from Trello without any side effects. The optional parameters only expand what data is returned, not modify any state. Misuse would be limited to unauthorized information disclosure, which is a lower-severity risk in most organizational contexts.
From the tool's definition Tool name contains 'GET' and description states 'Retrieves a Trello list by its unique ID' with optional inclusion of cards and board details. No creation, modification, deletion, or execution of external operations.
Attacks that exploit this kind of access
The rule that runs TRELLO_GET_LISTS_BY_ID_LIST safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Trello, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For TRELLO_GET_LISTS_BY_ID_LIST, this is the rule to start with:
TRELLO_GET_LISTS_BY_ID_LIST is read-only, so it stays allowed. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect Trello, apply this rule, and every TRELLO_GET_LISTS_BY_ID_LIST call is checked against it from then on.
Questions about TRELLO_GET_LISTS_BY_ID_LIST
Retrieves a Trello list by its unique ID, optionally including details for its cards and parent board. It is categorised as a Read tool in the Trello MCP Server, which means it retrieves data without modifying state.
TRELLO_GET_LISTS_BY_ID_LIST accepts 6 parameters: board, cards, fields, idList, card_fields, board_fields. The full parameter table on this page comes from the server's own tool schema.
Register the Trello MCP server in PolicyLayer and add a rule for TRELLO_GET_LISTS_BY_ID_LIST: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Trello. Nothing to install.
TRELLO_GET_LISTS_BY_ID_LIST is a Read tool with low risk. Read-only tools are generally safe to allow by default.
Yes. Add a rate_limit block to the TRELLO_GET_LISTS_BY_ID_LIST rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for TRELLO_GET_LISTS_BY_ID_LIST. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
TRELLO_GET_LISTS_BY_ID_LIST is provided by the Trello MCP server (mcp-server-trello). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Trello, and thousands of servers like it.
This server
Across the catalogue