Version
READ

list_resources

Paginated list of project resources (the places a connector gates plus manual perks) scoped to one project, narrowable by kind and by connector.

List every resource attached to a project — the places a connector gates, manual PDF / URL perks, and any other unit the creator has registered as gated content. Results are scoped to the caller's team and ordered newest-first. kind narrows the page to one kind of resource and connector to everything one connector gates; either alone or both together.

The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.

The REST endpoint and this tool share one action, so validation, permissions and events are identical.

Annotations

Read-only

It reads and never changes anything.

Arguments

project_id*string

UUID of the parent project.

limitintegeroptional

Maximum resources to return per page (1..100).

min1max100
pageintegeroptional

1-indexed page number.

min1
kindstringoptional

Only resources of one kind: `manual`, or a connector's kind spelled `connector:kind` as `list_connectors` lists each connector's `resource_kinds`.

connectorstringoptional

Only the resources one connector gates, by the key `list_connectors` lists it under.

What it returns

{  "data": [    {      "id": "b73c5f21-9d80-4a6e-8215-4f70ce13a9d6",      "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",      "kind": "telegram:channel",      "connector": "telegram",      "space": {        "id": "3c1f7a58-2b6e-4d90-8f41-6a2e9c5d7b10",        "external_id": "-1001234567890",        "title": "Research Premium Lounge"      },      "title": "Research Premium Lounge",      "description": "Daily research notes.",      "active": true,      "created_at": "2026-05-18T10:05:00Z",      "updated_at": "2026-05-18T10:05:00Z"    },    {      "id": "8c2f4a61-3d7e-4b90-a5c8-1e6f9d0b2c73",      "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",      "kind": "manual",      "connector": null,      "space": null,      "title": "Onboarding PDF",      "description": "Link to the onboarding pack.",      "active": true,      "created_at": "2026-05-18T10:05:00Z",      "updated_at": "2026-05-18T10:05:00Z"    }  ],  "meta": {    "page": 1,    "limit": 25,    "total": 2,    "has_more": false  }}

space is the place the resource is bound to, null for a manual perk and for a place-kind resource that was unlinked. The row is the same object GET /v1/projects/{project}/resources returns.

How it fails

RESOURCE_NOT_FOUND

unknown project_id, or the project belongs to a team outside the token's scope.

VALIDATION_FAILED

kind is neither manual nor connector:kind, or connector is not a connector key.

TOKEN_MISSING_ABILITY

token lacks project-resource:view-any.

How is this guide?

Last updated on