list_design_references
Paginated list of the links a project keeps to its designs, each with its kind, what it is attached to, version and notes, narrowed by kind, component, whole-project scope or search words.
Return the design references of one project in the project's order: the links the analyst and the designer pinned to Figma files, wireframes, prototypes, screenshots, API contracts, diagrams and documents, each with its title, address, kind, what it is attached to (the whole project or one component), version, notes as HTML and who added it. Read it before implementing a screen or a contract, so you build against the design the team linked rather than guessing it, and to find the current version of a design.
Narrow with kind (figma, wireframe, prototype, screenshot, api_contract, sequence_diagram, erd, document or other), component_id (the references attached to one component), project_wide (true for the references attached to the whole project only) and search (words in the title, the address or the version). A guest token reads every reference of its project.
Requires ability
The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.
Runs the same action as
The REST endpoint and this tool share one action, so validation, permissions and events are identical.
Annotations
It reads and never changes anything.
Arguments
project_id*stringUUID of the project whose design references to list.
kindstringoptionalOne kind: figma, wireframe, prototype, screenshot, api_contract, sequence_diagram, erd, document or other.
component_idstringoptionalUUID of a component; lists the references attached to it only.
project_widebooleanoptional`true` lists the references attached to the whole project only.
searchstringoptionalWords the title, the address or the version must contain.
limitintegeroptionalReferences per page (1..100, default 25).
1max100pageintegeroptional1-indexed page number.
1What it returns
{ "data": [ { "id": "e7f8a9b0-c1d2-4e3f-8a4b-5c6d7e8f9a01", "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13", "referenceable_type": "component", "referenceable_id": "c2d3e4f5-a6b7-4c8d-9e0f-1a2b3c4d5e6f", "kind": "figma", "title": "Checkout flow", "url": "https://www.figma.com/file/aB3dE5fG7hJ9kL1mN3pQ5r/Checkout", "version": "v3", "notes": "<p>Frames 12 to 18 are the signed-off flow; the rest are explorations.</p>", "added_by": "9b2e4f1a-3c5d-4e6f-8a7b-1c2d3e4f5a6b", "position": 0, "created_at": "2026-10-20T09:20:00+00:00", "updated_at": "2026-10-27T11:30:00+00:00" } ], "meta": { "page": 1, "limit": 25, "total": 1, "has_more": false }}How it fails
VALIDATION_FAILEDkind is not one of the nine kinds, or component_id is not a UUID.
RESOURCE_NOT_FOUNDunknown project_id, or a project outside the token's scope or the person's visibility.
TOKEN_MISSING_ABILITYtoken lacks design-reference:view-any.
How is this guide?
Last updated on