Version
DESTRUCTIVE

create_resource

Create a manual project resource (PDF link, token, URL placeholder) on a project with a connected connector. Gated places are linked through their connector.

Create a manual project resource. Delegates to an Action so policy checks and cache invalidation run identically to the dashboard, and a project.resource.created event fires.

Gated places (a channel, group or supergroup on Telegram, and whatever another connector gates) cannot be created through this tool. Only the connector can prove its installation administers the place, so a link starts with request_resource_link and finishes on the platform. Create manual perks here, and only once a connector on the project is connected: a project with none answers CONNECTOR_NOT_INSTALLED.

Requires ability

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.

Delivered to every endpoint subscribed to it once the change is made.

Annotations

DestructiveOpen world

A client that honours annotations asks a person before running it. It reaches beyond Subscriby: a connector, a provider or a member.

Arguments

project_id*string

UUID of the parent project.

title*string

Resource title (5..255 chars).

descriptionstringoptional

Optional resource description. Max 1000 chars, HTML is filtered.

activebooleanoptional

Defaults to true. Set false to create in inactive state.

What it returns

{  "data": {    "id": "b73c5f21-9d80-4a6e-8215-4f70ce13a9d6",    "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"  }}

The full get_resource row: a manual perk is kind: "manual" with connector and space both null.

How it fails

VALIDATION_FAILED

title is outside the 5..255 character range.

CONNECTOR_NOT_INSTALLED

no connector on the project is connected, so nothing could deliver the resource; install and connect one first.

RESOURCE_NOT_FOUND

project_id is unknown or out of the token's team scope.

TOKEN_MISSING_ABILITY

token lacks project-resource:create.

How is this guide?

Last updated on