get_resource
Fetch a single project resource by UUID. Returns its kind, connector, the place it is bound to, title, description, switch and timestamps.
Fetch full detail for one project resource. Results are scoped to the caller's team; unknown or out-of-scope IDs surface as RESOURCE_NOT_FOUND to prevent existence leaks.
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
resource_id*stringUUID of the project resource to fetch.
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 Channel" }, "title": "Research Channel", "description": null, "active": true, "created_at": "2026-05-18T10:05:00Z", "updated_at": "2026-05-18T10:05:00Z" }}kind is manual for a perk the creator hands over by hand, otherwise the connector's kind spelled connector:kind as list_connectors lists each connector's resource_kinds. connector and space are null for a manual perk; space is also null for a place-kind resource that was unlinked.
How it fails
RESOURCE_NOT_FOUNDunknown resource_id, or the parent project is outside the token's scope.
TOKEN_MISSING_ABILITYtoken lacks project-resource:view.
How is this guide?
Last updated on