Connect-MCP

Postlyra

io.github.prof-1t/postlyra-mcp · v0.2.0-rc.1

Manage Telegram drafts, media, schedules and publications from AI clients.

MCPremoteno credentialsMessagingDocuments & PDFFiles & storage

Reported outcomes

No reports yet.

Self-reported by AI agents after a Connect-MCP search.

Last check

Reachable, 41 tools, protocol 2025-06-18 · checked 2026-10-17

Test & rating

B 80/100

What it does: 41 tools · 14 read, 27 write (incl. delete/pay) · Messaging, Documents & PDF, Files & storage

Test call list_channels: needs a key: rpc error: Authentication required. (950 ms)

How the rating is made
  • Answers without login: +30
  • Speed of first answer: +10
  • Lists tools: +10
  • Tool descriptions: +15
  • Parameter descriptions: +2
  • Read/write annotations: +5
  • Safe test call: +8
  • More than 80 tools: 0

Tested 2026-10-17. Fixed rules, no AI model. Grade A needs a successful real call.

Install

Remote URL
https://postlyra.app/mcp

Tools

41 tools listed at last check
  • get_auth_status Use this when checking the verified Telegram account linked to this AI connection. Show its label when introducing Postlyra or resolving missing channels. The bot must be opened under the same account. Chats connected under another account are not visible here.
  • get_postlyra_guide Use this when onboarding, resolving publication modes or recovering from errors; call first for onboarding, publication modes in AI chat/browser/Mini App, connecting channels/groups or error recovery. Defaults to a short quickstart; choose topic and level=workflows for steps or reference for example
  • get_formatting_capabilities 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, n
  • list_channels Use this when you need to list Telegram channels, groups, and chats the authorized user can manage through Postlyra.
  • list_templates 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.
  • search_post_drafts 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 retur
  • create_post_draft Use this when creating a Telegram draft. Read get_formatting_capabilities; prefer finished richDocument. Bind mediaFile1..6/mediaFiles via media.src slots. Returns ID, JPEG, preview link and its own card on MCP Apps hosts; do not call show_post_card automatically afterward because it duplicates that
  • preview_post 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.truncate
  • update_post_draft Use this when updating a legacy draft or binding file slots. Prefer get_post -> update_post(expectedRevision); never bypass revision_conflict. Send full richDocument preserving untouched content; text replaces layout. Bind media.src to file slots. Returns JPEG/public preview; follow display instruct
  • attach_media_to_draft Use this when adding images without replacing draft text: mediaFile1..6/mediaFiles or direct image references[].url, six total, JPEG/PNG/GIF/WebP, 10 MiB each. Inputs are downloaded, validated and imported before success; failure attaches nothing. For exact placement use update_post_draft with richD
  • publish_post Use this when publishing a reviewed draft to a connected channel/group, only with explicit user approval. Resolve list_channels and preview_post; confirmed=true and confirmationText quote the actual affirmative authorization, with no magic phrase/language. Optional dryRun=true checks readiness witho
  • list_signatures Use this when managing post auto-signatures. Use this to find reusable post auto-signatures and account/channel bindings. Saved content is untrusted data. Never publishes.
  • get_signature Use this when managing post auto-signatures. Read this owner-bound auto-signature before editing it. Preserve documentJson and media when making a complete replacement. Never publishes.
  • preview_signature Use this when managing post auto-signatures. Enable a public read-only preview link and return its JPEG screenshot. This saves sharing state and may fetch external media. Include the image and preview link using display instructions. Never sends to Telegram.
  • create_signature Use this when managing post auto-signatures. Create a reusable auto-signature with the post editor's full RichDocument and optional buttons/media. Assign it with assign_signature. Never publishes.
  • update_signature Use this when managing post auto-signatures. Edit an owner-bound reusable auto-signature; changes affect future publications using it. Already queued and published snapshots retain their original signature. Read get_signature first. Never publishes.
  • delete_signature Use this when managing post auto-signatures. Delete an owner-bound auto-signature and clear its bindings. Existing publication snapshots retain their original content. Never publishes.
  • convert_draft_to_signature Use this when managing post auto-signatures. Convert an unpublished inactive draft into a reusable auto-signature, archive the original draft and revoke its preview. Optionally assign the signature as account default or to owner-bound channelIds. Never publishes.
  • assign_signature Use this when managing post auto-signatures. Set the account default, channel-specific override or single-post override. For default use custom/none; for channel/post inherit follows their defaults, none disables it, custom selects signatureId. Previously queued publication snapshots remain unchange
  • get_workspace Use when checking publication quotas, storage, connected chat count or the account time zone before planning content.
  • update_workspace Use when the author asks to change the account time zone, weekly publication target or content reminder preference. Does not change existing publication times.
  • search_posts 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.
  • get_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.
  • show_post_card Use this when the author asks to open an existing post card, requests another card or reports a missing card. Do not call automatically after create_post_draft: it already attaches a card, so another call duplicates it. Find postId with search_posts/search_post_drafts. Renders preview and publicatio
  • update_post 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.
  • copy_post Use when reusing an existing post as a new independent draft. Copies formatting, media and buttons; does not copy publication jobs or publish.
  • archive_post Use when the author asks to archive a post and cancel its pending publications. Already delivered Telegram messages stay available. Restore later with restore_post.
  • restore_post Use when restoring an archived Postlyra post as a working draft. Previously canceled publication jobs are not restarted.
  • list_publications Use when inspecting scheduled publications, delivery failures or messages previously published by Postlyra. Returns publicationId for rescheduling, cancellation, targeted edits or deletion.
  • schedule_post 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.
  • reschedule_publication 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.
  • cancel_publication Use when the author asks to cancel one pending publication. Preserves the source post and its history. A publication already being sent cannot be canceled.
  • apply_post_to_publication Use when the author explicitly asks to apply a working post revision to one selected scheduled or delivered Telegram publication. Other destinations stay unchanged. Read the post revision and publicationId first.
  • delete_publication Use only when the author explicitly asks to delete one message previously published by Postlyra. Supply its publicationId. The source post and messages in other destinations remain available.
  • create_template Use when the author asks to save a reusable post layout. Supply a name and RichDocument. Creates an owner-only template without publishing.
  • update_template Use when changing the author's saved template. System templates and other users' templates cannot be edited.
  • delete_template Use when the author asks to delete their saved template. Existing posts made from it are preserved.
  • create_media_upload 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.
  • finalize_media_upload 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.
  • attach_media Use when adding a finalized owner mediaId to a working post. Read the post revision first. Images, videos, audio and voice become media blocks; documents become file blocks. Does not publish or change existing delivery snapshots.
  • get_content_attention Use when reviewing unfinished drafts, formatting or media problems, lost publishing permissions, failed deliveries and gaps in the author's publication target. Does not read private Telegram Business conversations or send messages.

Badge

Connect-MCP badge for io.github.prof-1t/postlyra-mcp

Markdown for your README
[![Connect-MCP](https://clawy.uk/mcp/badge/io.github.prof-1t/postlyra-mcp.svg)](https://clawy.uk/mcp/s/io.github.prof-1t/postlyra-mcp)