Work with activities through MCP
An agent can read your activities, create and edit drafts, and request a launch or stop when its key has the necessary permissions. A connection carries the same permissions. Activity drafts and content plan posts are separate: preparing one does not create the other. See permissions and capabilities.
Prepare and review a draft
Give the agent the channel, title, description, dates and time zone, participation conditions and prizes. Ask it to clarify missing details and show the result for review. It can also find an existing draft and update its settings, conditions, markers or prizes. Draft tools do not launch an activity.
Request a launch or stop
An agent with activities:control on an Enterprise live key can request a launch or stop and check the request status. A connection carries the same permission. The activity owner must review and confirm each request in the app before the action can run. Review the draft and its settings before confirming. You can also launch or stop the activity in the app.
Three example prompts#
Adapt these prompts to your task. Reading activities and working with drafts require activities:read and activities:draft respectively.
- Create an activity. “Prepare a draft contest for my channel [name]: title [title], start [date and time], end [date and time], time zone [zone]. Participation conditions: [conditions]; prizes: [prizes]. Ask me for any missing details and show me the result for review.” This creates a draft, not a launch.
- Edit a draft. “Find my draft [name or ID], show its current conditions and prizes, then change [details]. Show me the result and tell me if the requested change is unavailable.” Editing tools work on drafts.
- Prepare a launch and announcement. “Review my draft [name or ID] and show its settings. If a launch request is available, send it for my confirmation. Also prepare an announcement draft in content plan [name] for [date and time], using these conditions and link: [details].” The launch request requires an Enterprise live key with
activities:controlor a connection with the same permission; the post requirescontent:readandcontent:draft. Confirm the launch in the app and approve the post under the content plan approval rules.
For integration developers#
activities_list lists the owner's activities with pagination (offset, limit from 1 to 100), and activities_get returns details by activity_id. When the activity has a comment condition, activities_get adds telegramCommentSetupWarnings with the codes tg_no_discussion_group and tg_bot_not_discussion_admin if the Telegram check confirmed that problem. An empty list means there is no confirmed problem. A new comment condition is rejected when the code is tg_no_discussion_group: link a discussion group first. tg_bot_not_discussion_admin does not reject the condition; it is a warning. activities_draft_create, activities_draft_edit, activities_draft_add_conditions, activities_draft_update_condition, activities_draft_upsert_marker, activities_draft_add_prizes and activities_draft_update_prize create or edit drafts. Writes require a unique operation_id; edits also require the current expected_revision.
activities_request_launch and activities_request_stop create confirmation requests; activities_get_action_request checks their status. The owner must confirm before the action can run.