Postlyra

Use when changing a post's working content, title, buttons or attention flag. Read its revision first. Scheduled and sent messages remain on their own snapshots until apply_post_to_publication is requested.

update_post

Use when changing the author's saved template. System templates and other users' templates cannot be edited.

update_template

Use this when you need to check whether the current MCP caller is authorized through Telegram and linked to a Postlyra account.

get_auth_status

Use this when composing or formatting any Postlyra post: call it FIRST, once per task. Postlyra creates beautifully structured rich Telegram posts, illustrated instructions, articles and presentations. Returns the complete RichDocument contract: exact JSON examples for every block and inline mark, nesting, limits, file uploads, error recovery, presets and which tool to use next. Use this contract for formatting; Telegram MarkdownV2/parse_mode documentation is not needed.

get_formatting_capabilities

Use when checking publication quotas, storage, connected chat count or the account time zone before planning content.

get_workspace

Use this when the user wants an existing reusable Postlyra layout template. Optional for custom composition. For supported blocks, JSON syntax or formatting choices call get_formatting_capabilities; this tool lists saved templates and their ids.

list_templates

Use this when you need to list Telegram channels, groups, and chats the authorized user can manage through Postlyra.

list_channels

Use when the author asks to change the date or time of one pending publication. Supply its publicationId and a concrete ISO date with UTC offset. Does not change its content.

reschedule_publication

Use when uploading a local image, video, document, audio or voice file from any MCP client. Returns a short-lived PUT URL, headers and uploadIntentId. Upload the actual bytes, then call finalize_media_upload. A local filesystem path cannot be read by the server.

create_media_upload

Use this when requesting a saved draft screenshot, public browser preview or validation warnings. Find draftId with search_post_drafts. Returns documentJson/richHtml, JPEG and enables a public preview link. Use show_post_card for an in-chat card. Follow display.instruction; check screenshot.truncated and retry unavailable screenshots without recreating the draft. May fetch external image URLs for screenshot rendering. Never publishes.

preview_post

Use this when the user explicitly authorizes publishing a reviewed existing Postlyra rich draft to a connected Telegram channel. Resolve channelId using list_channels, inspect preview_post, and supply confirmed=true plus confirmationText containing the user's authorization. Reuse idempotencyKey on retry. Queued/retrying means pending, not delivered. This is the external publication action; draft tools never send.

publish_post

Use when reading an existing post and its current revision before editing. Returns the working document without enabling a public preview or publishing anything.

get_post

Use when inspecting scheduled publications, delivery failures or messages previously published by Postlyra. Returns publicationId for rescheduling, cancellation, targeted edits or deletion.

list_publications

Use when restoring an archived Postlyra post as a working draft. Previously canceled publication jobs are not restarted.

restore_post

Use when the author asks to save a reusable post layout. Supply a name and RichDocument. Creates an owner-only template without publishing.

create_template

Use when the author explicitly asks to schedule a post to a connected channel or group. Supply an exact ISO date with UTC offset and an idempotency key. The server uses the shared publishing rules and stores an immutable delivery snapshot.

schedule_post

Use when finding any existing Postlyra post, including scheduled, published or archived content. Search owner content by words, status, connected channel and update dates. Read the selected post with get_post.

search_posts

Use this when finding an existing draft by topic, title or content. Search first when draftId is unknown; do not ask for a link. Matches all keywords/fragments in title and rich text, ignoring case. Empty query lists recent drafts. Follow nextCursor while hasMore. For an in-chat card, pass the returned draftId as postId to show_post_card; use preview_post for a screenshot/browser preview. Returns owner-only IDs and snippets. Never edits, enables sharing or publishes.

search_post_drafts

Use this when the author asks to show a post card inside the chat or choose publication controls there. After search_posts or search_post_drafts, pass the found post ID as postId. Renders the MCP Apps UI with preview, text editing and scheduling. A screenshot or preview_post URL is not this UI. Opens no public link and never publishes or schedules on its own. If unavailable, refresh the connection's tool metadata; clients without UI retain text/tool workflows.

show_post_card

Use when the author asks to change the account time zone, weekly publication target or content reminder preference. Does not change existing publication times.

update_workspace

Use this when editing a draft. Read preview_post and get_formatting_capabilities. Send the complete edited richDocument, preserving untouched content and media; text replaces layout. Bind imported file slots as media.src. Returns JPEG and enables a public preview link. Display the image in the FINAL answer via native attachment or display.imageMarkdown. Inspect preview_post. May fetch external image URLs during import or screenshot rendering. Never publishes.

update_post_draft

Use after uploading bytes to the URL from create_media_upload. Verifies file content, size and ownership and returns a durable mediaId for attach_media. Expired or invalid uploads are rejected.

finalize_media_upload