Postlyra
REMOTE · POSTLYRA.APP · SCANNED SEP 20
Manage Telegram drafts, media, schedules and publications from AI clients.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →
Endpoint Security89
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation is enforced on tool calls, advertised via RFC 9728 protected-resource metadata. Discovery is public, which costs nothing: no tool can be invoked without a token. View diagnostics → Pass
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
- The authorisation server offers only Dynamic Client Registration (RFC 7591), which MCP 2026-07-28 deprecated in favour of Client ID Metadata Documents. View diagnostics → Partial
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability77
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (good).Pass
- Context-footprint check failed: tool/resource definitions use about 5610 tokens (~170/item across 33 items; 32 tools + 1 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management30
- Stability observed for 9 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage81
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 35% of tool parameters carry a description.Partial
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- All 3 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
- An AI judge read all 34 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
- Supports UI / widget rendering.Pass
How do I install the Postlyra MCP server?
Postlyra is a hosted endpoint at https://postlyra.app/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
remote · postlyra.app
claude mcp add --transport http prof-1t-postlyra-mcp 'https://postlyra.app/mcp'
{
"mcpServers": {
"prof-1t-postlyra-mcp": {
"url": "https://postlyra.app/mcp"
}
}
} {
"servers": {
"prof-1t-postlyra-mcp": {
"type": "http",
"url": "https://postlyra.app/mcp"
}
}
} [mcp_servers.prof-1t-postlyra-mcp] url = "https://postlyra.app/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"prof-1t-postlyra-mcp": {
"type": "remote",
"url": "https://postlyra.app/mcp",
"enabled": true
}
}
} openclaw mcp add prof-1t-postlyra-mcp --url 'https://postlyra.app/mcp' --transport streamable-http
mcp_servers:
prof-1t-postlyra-mcp:
url: "https://postlyra.app/mcp" {
"McpServers": {
"prof-1t-postlyra-mcp": {
"Transport": "http",
"Url": "https://postlyra.app/mcp"
}
}
} assistant mcp add prof-1t-postlyra-mcp -t streamable-http -u 'https://postlyra.app/mcp'
{
"mcpServers": {
"prof-1t-postlyra-mcp": {
"type": "http",
"url": "https://postlyra.app/mcp"
}
}
} The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 19 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.
- 17 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.
- 15 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 10 to 13. That category is still filling its 30-day observation window: 3 days of observed history at the previous scan, 4 at this one. The score rises as the window fills, whether or not the server changes.
- 13 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.
- 12 Sept 26 +2
- The server rewrote its instructions, which are the text every model session reads security
- Tool “attach_media_to_draft” rewrote its description, which is the text the model reads security
- Tool “create_post_draft” rewrote its description, which is the text the model reads security
- Tool “preview_post” rewrote its description, which is the text the model reads security
- Tool “search_post_drafts” rewrote its description, which is the text the model reads security
- Tool “update_post_draft” rewrote its description, which is the text the model reads security
- Stability: unverified → 0.03 ▲ functional
- The server now declares the “resources” capability functional
- First check of Capabilities: pass functional
- First check of Schema quality: 100 functional
- New resource “postlyra-post-card” functional
- Server version: 0.2.0 → 0.3.5 functional
- New tool “show_post_card” functional
- 11 Sept 26 74
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 20 Sept 2026 · Probed https://postlyra.app/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=postlyra.app | CN=YE1,O=Let's Encrypt,C=US | 29 Aug 2026 | 27 Nov 2026 | ECDSA 256 | ECDSA-SHA384 | 6c758b19e922c3cb313fe3430484c60f9b5 |
| SANs: postlyra.app, www.postlyra.app | ||||||
| CN=YE1,O=Let's Encrypt,C=US (CA) | CN=Root YE,O=ISRG,C=US | 3 Sept 2025 | 2 Sept 2028 | ECDSA 384 | ECDSA-SHA384 | 5ddd70dd31f801c85c186a7a04b80afe |
| CN=Root YE,O=ISRG,C=US (CA) | CN=ISRG Root X2,O=Internet Security Research Group,C=US | 13 May 2026 | 2 Sept 2032 | ECDSA 384 | ECDSA-SHA384 | 872165fc34b6e5fba8add5b3705fb53a |
| CN=ISRG Root X2,O=Internet Security Research Group,C=US (CA) | CN=ISRG Root X1,O=Internet Security Research Group,C=US | 13 May 2026 | 2 Sept 2032 | ECDSA 384 | SHA256-RSA | 6c8f1dc727c7117f7baf853ac980f9cd |
Background: What to check on a remote MCP endpoint →
DNSSEC insecure
Validation of postlyra.app. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| app. | present | 23684 | 8 | Verified |
| postlyra.app. | absent | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication Enforced and verified
The endpoint asked for a token and published valid RFC 9728 metadata describing how to get one.
| Result | Enforced and verified |
|---|---|
| Enforced | On tool calls |
| HTTP status | 200 |
WWW-Authenticate challenge Bearer resource_metadata="https://postlyra.app/.well-known/oauth-protected-resource"
Bearer resource_metadata="https://postlyra.app/.well-known/oauth-protected-resource"Protected resource metadata
| Document | https://postlyra.app/.well-known/oauth-protected-resource |
|---|---|
| Retrieved | Yes |
| Resource | https://postlyra.app/mcp |
| Authorisation server | https://postlyra.app |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://postlyra.app/mcp | Verified | 200 | |
| http (plaintext) | http://postlyra.app/mcp | HTTPS enforced | 301 | https://postlyra.app/mcp |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
apply_post_to_publication Apply edits to one publication ~62
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.
| Name | Type | Req | Description |
|---|---|---|---|
| expectedRevision | integer | yes | – |
| publicationId | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| message | string | yes | – |
No examples provided.
archive_post Archive a Postlyra post ~44
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.
| Name | Type | Req | Description |
|---|---|---|---|
| postId | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| message | string | yes | – |
No examples provided.
attach_media Attach uploaded media to a post ~73
Use when adding a finalized owner mediaId to a working post. Read the post revision first. Images and videos become media blocks; other files become a link. Does not publish or change existing delivery snapshots.
| Name | Type | Req | Description |
|---|---|---|---|
| expectedRevision | integer | yes | – |
| mediaId | string | yes | – |
| postId | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| message | string | yes | – |
No examples provided.
attach_media_to_draft Attach media to a Postlyra draft ~669
Use this when adding images without changing draft text. Pass mediaFile1..mediaFile6 or mediaFiles: six total, JPEG/PNG/GIF/WebP, 10 MiB each. Exact placement uses update_post_draft with richDocument slot bindings. Returns JPEG and enables a public preview link. Display the image in the FINAL answer via native attachment or display.imageMarkdown. On error follow nextAction. May fetch external image URLs during import or screenshot rendering. Never publishes.
| Name | Type | Req | Description |
|---|---|---|---|
| draftId | string | yes | – |
| mediaFile1 | object | – | Actual attached or generated image file, up to 10 MiB: JPEG, PNG, GIF or WebP. Pass the file through the client upload mechanism; the server receives download_url and file_id. mime_type and file_name… |
| mediaFile2 | object | – | Actual attached or generated image file, up to 10 MiB: JPEG, PNG, GIF or WebP. Pass the file through the client upload mechanism; the server receives download_url and file_id. mime_type and file_name… |
| mediaFile3 | object | – | Actual attached or generated image file, up to 10 MiB: JPEG, PNG, GIF or WebP. Pass the file through the client upload mechanism; the server receives download_url and file_id. mime_type and file_name… |
| mediaFile4 | object | – | Actual attached or generated image file, up to 10 MiB: JPEG, PNG, GIF or WebP. Pass the file through the client upload mechanism; the server receives download_url and file_id. mime_type and file_name… |
| mediaFile5 | object | – | Actual attached or generated image file, up to 10 MiB: JPEG, PNG, GIF or WebP. Pass the file through the client upload mechanism; the server receives download_url and file_id. mime_type and file_name… |
| mediaFile6 | object | – | Actual attached or generated image file, up to 10 MiB: JPEG, PNG, GIF or WebP. Pass the file through the client upload mechanism; the server receives download_url and file_id. mime_type and file_name… |
| mediaFiles | array | – | Alternative file array for clients supporting file arrays. Prefer mediaFile1..mediaFile6 otherwise. At most 6 files total across slots and array; use mediaFiles[0] etc. as richDocument src bindings. |
| placementHint | string | – | Legacy advisory field; placement is automatic (after heading, then near opening body). For exact placement use update_post_draft with richDocument and file-slot src bindings. |
| references | array | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| display | object | – | – |
| documentJson | object | – | – |
| draftId | string | yes | – |
| id | string | – | – |
| inlineButtons | array | – | – |
| locale | string | – | – |
| mediaAttachmentsAdded | integer | yes | – |
| message | string | yes | – |
| previewUrl | string|null | – | – |
| richHtml | string | – | – |
| screenshot | object | – | – |
| screenshotUrl | string|null | – | JPEG screenshot of the saved Telegram preview; null if rendering is temporarily unavailable. |
| status | string | – | – |
| text | string | – | – |
| title | string | – | – |
| updatedAt | string | – | – |
No examples provided.
cancel_publication Cancel a scheduled publication ~46
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.
| Name | Type | Req | Description |
|---|---|---|---|
| publicationId | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| message | string | yes | – |
No examples provided.
copy_post Copy a Postlyra post ~51
Use when reusing an existing post as a new independent draft. Copies formatting, media and buttons; does not copy publication jobs or publish.
| Name | Type | Req | Description |
|---|---|---|---|
| postId | string | yes | – |
| title | string | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| message | string | yes | – |
No examples provided.
create_media_upload Prepare a media upload ~90
Use when uploading a local image, video or document 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.
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | – | – |
| contentType | string | yes | – |
| fileName | string | yes | – |
| sizeBytes | integer | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| message | string | yes | – |
No examples provided.
create_post_draft Create a Postlyra post draft ~863
Use this when creating a Telegram draft. Read get_formatting_capabilities; prefer finished richDocument, which overrides text/preset/template. Bind mediaFile1..mediaFile6 or mediaFiles slots as media.src. Returns draftId, JPEG and 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.
| Name | Type | Req | Description |
|---|---|---|---|
| channelId | string | – | Optional owner-bound Postlyra channel id or exact title returned by list_channels. |
| formatPreset | string | – | Optional Postlyra formatting preset/layout recipe. Leave unset when the user did not name one; Postlyra will infer a recipe from topic, style, structure, and references. |
| language | string | – | – |
| mediaFile1 | object | – | Actual attached or generated image file, up to 10 MiB: JPEG, PNG, GIF or WebP. Pass the file through the client upload mechanism; the server receives download_url and file_id. mime_type and file_name… |
| mediaFile2 | object | – | Actual attached or generated image file, up to 10 MiB: JPEG, PNG, GIF or WebP. Pass the file through the client upload mechanism; the server receives download_url and file_id. mime_type and file_name… |
| mediaFile3 | object | – | Actual attached or generated image file, up to 10 MiB: JPEG, PNG, GIF or WebP. Pass the file through the client upload mechanism; the server receives download_url and file_id. mime_type and file_name… |
| mediaFile4 | object | – | Actual attached or generated image file, up to 10 MiB: JPEG, PNG, GIF or WebP. Pass the file through the client upload mechanism; the server receives download_url and file_id. mime_type and file_name… |
| mediaFile5 | object | – | Actual attached or generated image file, up to 10 MiB: JPEG, PNG, GIF or WebP. Pass the file through the client upload mechanism; the server receives download_url and file_id. mime_type and file_name… |
| mediaFile6 | object | – | Actual attached or generated image file, up to 10 MiB: JPEG, PNG, GIF or WebP. Pass the file through the client upload mechanism; the server receives download_url and file_id. mime_type and file_name… |
| mediaFiles | array | – | Alternative file array for clients supporting file arrays. Prefer mediaFile1..mediaFile6 otherwise. At most 6 files total across slots and array; use mediaFiles[0] etc. as richDocument src bindings. |
| references | array | – | – |
| richDocument | object | – | Preferred finished layout: {version:1, blocks:[...]}. Overrides text, template and preset. Call get_formatting_capabilities for exact block/inline schemas and examples. For uploaded images use media.… |
| structure | string | – | Desired content structure in natural language. Mention available facts such as gallery, CTA, comparison, details, map, report, changelog, or before/after. |
| style | string | – | Natural style request from the user, for example beautiful, premium, business, blog, presentation, informal, real-estate, launch, or landing-page-like. Use this as guidance, not literal post copy. |
| templateId | string | – | – |
| text | string | – | Optional user-approved draft text supplied by ChatGPT. |
| topic | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| display | object | – | – |
| documentJson | object | – | – |
| draftId | string | yes | – |
| id | string | – | – |
| inlineButtons | array | – | – |
| locale | string | – | – |
| message | string | yes | – |
| previewUrl | string|null | yes | – |
| richHtml | string | – | – |
| screenshot | object | – | – |
| screenshotUrl | string|null | – | JPEG screenshot of the saved Telegram preview; null if rendering is temporarily unavailable. |
| status | string | – | – |
| text | string | – | – |
| title | string | – | – |
| updatedAt | string | – | – |
No examples provided.
create_template Save a personal template ~71
Use when the author asks to save a reusable post layout. Supply a name and RichDocument. Creates an owner-only template without publishing.
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | – | – |
| description | string | – | – |
| documentJson | object | yes | – |
| locale | string | – | – |
| name | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| message | string | yes | – |
No examples provided.
delete_publication Delete one Telegram publication ~51
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.
| Name | Type | Req | Description |
|---|---|---|---|
| publicationId | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| message | string | yes | – |
No examples provided.
delete_template Delete a personal template ~35
Use when the author asks to delete their saved template. Existing posts made from it are preserved.
| Name | Type | Req | Description |
|---|---|---|---|
| templateId | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| message | string | yes | – |
No examples provided.
finalize_media_upload Verify an uploaded file ~56
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.
| Name | Type | Req | Description |
|---|---|---|---|
| uploadIntentId | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| message | string | yes | – |
No examples provided.
get_auth_status Get Postlyra auth status ~34
Use this when you need to check whether the current MCP caller is authorized through Telegram and linked to a Postlyra account.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| authMethod | string | – | – |
| authUrl | string | – | – |
| authorized | boolean | yes | – |
| instructions | string | – | – |
| message | string | yes | – |
| permissions | array | yes | – |
| scopes | array|null | – | – |
No examples provided.
get_content_attention Check content needing attention ~52
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.
| Name | Type | Req | Description |
|---|---|---|---|
| locale | string | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| message | string | yes | – |
No examples provided.
get_formatting_capabilities Get Postlyra formatting capabilities ~101
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.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| automaticSelection | object | – | – |
| blockExamples | object | – | – |
| blocks | array | – | – |
| creativeRoles | array | – | – |
| customDesignGuidance | string | – | – |
| defaultBeautifulBrief | object | – | – |
| examples | array | – | – |
| goodTasteRules | array | – | – |
| inlineMarkExamples | object | – | – |
| inlineMarks | array | – | – |
| inputContract | object | – | – |
| limits | object | – | – |
| mediaWorkflow | object | – | – |
| message | string | yes | – |
| nestingRules | array | – | – |
| presetRecipes | array | – | – |
| previewScreenshot | object | – | – |
| purpose | string | yes | – |
| toolSelection | array | – | – |
| version | integer | yes | – |
| workflow | array | – | – |
No examples provided.
get_post Read a Postlyra post ~42
Use when reading an existing post and its current revision before editing. Returns the working document without enabling a public preview or publishing anything.
| Name | Type | Req | Description |
|---|---|---|---|
| postId | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| message | string | yes | – |
No examples provided.
get_workspace Get Postlyra workspace ~28
Use when checking publication quotas, storage, connected chat count or the account time zone before planning content.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| message | string | yes | – |
No examples provided.
list_channels List Telegram channels ~32
Use this when you need to list Telegram channels, groups, and chats the authorized user can manage through Postlyra.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| channels | array | yes | – |
| message | string | yes | – |
No examples provided.
list_publications Read publication calendar ~91
Use when inspecting scheduled publications, delivery failures or messages previously published by Postlyra. Returns publicationId for rescheduling, cancellation, targeted edits or deletion.
| Name | Type | Req | Description |
|---|---|---|---|
| channelId | string | – | – |
| from | string | – | – |
| limit | integer | – | – |
| offset | integer | – | – |
| postId | string | – | – |
| status | string | – | – |
| to | string | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| message | string | yes | – |
No examples provided.
list_templates List Postlyra templates ~83
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.
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | – | Optional template category. |
| channelId | string | – | Optional owner-bound Postlyra channel id returned by list_channels. |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | – |
| templates | array | yes | – |
No examples provided.
preview_post Preview a Postlyra post ~97
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.
| Name | Type | Req | Description |
|---|---|---|---|
| draftId | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| display | object | – | – |
| documentJson | object | – | – |
| draftId | string | yes | – |
| id | string | – | – |
| inlineButtons | array | – | – |
| locale | string | – | – |
| message | string | yes | – |
| previewUrl | string|null | – | – |
| richHtml | string | – | – |
| screenshot | object | – | – |
| screenshotUrl | string|null | – | JPEG screenshot of the saved Telegram preview; null if rendering is temporarily unavailable. |
| status | string | – | – |
| telegramElements | array | – | – |
| text | string | – | – |
| title | string | – | – |
| updatedAt | string | – | – |
| validation | object | yes | – |
| warnings | array | yes | – |
No examples provided.
publish_post Publish a Postlyra post ~141
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.
| Name | Type | Req | Description |
|---|---|---|---|
| channelId | string | yes | Owner-bound Postlyra channel id or exact channel title returned by list_channels. |
| confirmationText | string | – | – |
| confirmed | boolean | – | – |
| draftId | string | yes | – |
| idempotencyKey | string | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| channelId | string | yes | – |
| draftId | string | yes | – |
| message | string | yes | – |
| status | string | yes | – |
No examples provided.
reschedule_publication Move a scheduled publication ~61
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.
| Name | Type | Req | Description |
|---|---|---|---|
| publicationId | string | yes | – |
| scheduledAt | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| message | string | yes | – |
No examples provided.
restore_post Restore an archived post ~38
Use when restoring an archived Postlyra post as a working draft. Previously canceled publication jobs are not restarted.
| Name | Type | Req | Description |
|---|---|---|---|
| postId | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| message | string | yes | – |
No examples provided.
schedule_post Schedule a Telegram publication ~120
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.
| Name | Type | Req | Description |
|---|---|---|---|
| channelId | string | yes | – |
| expectedRevision | integer | – | – |
| idempotencyKey | string | yes | – |
| postId | string | yes | – |
| scheduledAt | string | yes | – |
| timezone | string | – | IANA zone, for example Asia/Bangkok; publication times are stored in UTC. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| message | string | yes | – |
No examples provided.
search_post_drafts Search Postlyra drafts ~212
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.
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | string | – | Opaque nextCursor from the preceding response for the same query. Omit on the first call. |
| limit | integer | – | Maximum matches on this page. |
| query | string | – | Keywords or word fragments, not a full instruction; every term must match title or body. Example: 'ремонт тормоз' or 'brake cost'. Ignore case and е/ё differences. Omit or use empty string to list re… |
| Name | Type | Req | Description |
|---|---|---|---|
| drafts | array | yes | – |
| hasMore | boolean | yes | More drafts remain to search; later pages may have no matches. |
| message | string | yes | – |
| nextAction | string | yes | – |
| nextCursor | string|null | yes | – |
| query | string | yes | – |
No examples provided.
search_posts Search Postlyra content ~106
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.
| Name | Type | Req | Description |
|---|---|---|---|
| channelId | string | – | – |
| from | string | – | – |
| includeArchived | boolean | – | – |
| limit | integer | – | – |
| offset | integer | – | – |
| query | string | – | – |
| status | string | – | – |
| to | string | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| message | string | yes | – |
No examples provided.
show_post_card Show a Postlyra post in chat ~111
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.
| Name | Type | Req | Description |
|---|---|---|---|
| postId | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| message | string | yes | – |
No examples provided.
update_post Edit Postlyra working content ~110
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.
| Name | Type | Req | Description |
|---|---|---|---|
| documentJson | object | – | Full RichDocument from get_formatting_capabilities. |
| expectedRevision | integer | yes | – |
| inlineButtons | array | – | – |
| locale | string | – | – |
| needsAttention | boolean | – | – |
| postId | string | yes | – |
| title | string | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| message | string | yes | – |
No examples provided.
update_post_draft Update a Postlyra post draft ~774
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.
| Name | Type | Req | Description |
|---|---|---|---|
| appendCallToAction | string | – | – |
| channelId | string | – | Optional owner-bound Postlyra channel id or exact title returned by list_channels. |
| draftId | string | yes | – |
| instructions | string | – | Limited hints only: shorter, title, quote, CTA. For rewriting, restyling or exact placement supply the complete richDocument; this field does not run an AI editor. |
| mediaFile1 | object | – | Actual attached or generated image file, up to 10 MiB: JPEG, PNG, GIF or WebP. Pass the file through the client upload mechanism; the server receives download_url and file_id. mime_type and file_name… |
| mediaFile2 | object | – | Actual attached or generated image file, up to 10 MiB: JPEG, PNG, GIF or WebP. Pass the file through the client upload mechanism; the server receives download_url and file_id. mime_type and file_name… |
| mediaFile3 | object | – | Actual attached or generated image file, up to 10 MiB: JPEG, PNG, GIF or WebP. Pass the file through the client upload mechanism; the server receives download_url and file_id. mime_type and file_name… |
| mediaFile4 | object | – | Actual attached or generated image file, up to 10 MiB: JPEG, PNG, GIF or WebP. Pass the file through the client upload mechanism; the server receives download_url and file_id. mime_type and file_name… |
| mediaFile5 | object | – | Actual attached or generated image file, up to 10 MiB: JPEG, PNG, GIF or WebP. Pass the file through the client upload mechanism; the server receives download_url and file_id. mime_type and file_name… |
| mediaFile6 | object | – | Actual attached or generated image file, up to 10 MiB: JPEG, PNG, GIF or WebP. Pass the file through the client upload mechanism; the server receives download_url and file_id. mime_type and file_name… |
| mediaFiles | array | – | Alternative file array for clients supporting file arrays. Prefer mediaFile1..mediaFile6 otherwise. At most 6 files total across slots and array; use mediaFiles[0] etc. as richDocument src bindings. |
| references | array | – | – |
| richDocument | object | – | Complete replacement RichDocument: {version:1, blocks:[...]}. Start from preview_post.documentJson and preserve untouched content and stored media URLs. Read get_formatting_capabilities for syntax an… |
| templateId | string | – | – |
| text | string | – | Replaces the existing layout using the simple text parser. Prefer richDocument to preserve formatting and media. |
| Name | Type | Req | Description |
|---|---|---|---|
| display | object | – | – |
| documentJson | object | – | – |
| draftId | string | yes | – |
| id | string | – | – |
| inlineButtons | array | – | – |
| locale | string | – | – |
| message | string | yes | – |
| previewUrl | string|null | yes | – |
| richHtml | string | – | – |
| screenshot | object | – | – |
| screenshotUrl | string|null | – | JPEG screenshot of the saved Telegram preview; null if rendering is temporarily unavailable. |
| status | string | – | – |
| text | string | – | – |
| title | string | – | – |
| updatedAt | string | – | – |
No examples provided.
update_template Edit a personal template ~71
Use when changing the author's saved template. System templates and other users' templates cannot be edited.
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | – | – |
| description | string | – | – |
| documentJson | object | – | – |
| locale | string | – | – |
| name | string | – | – |
| templateId | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| message | string | yes | – |
No examples provided.
update_workspace Update Postlyra preferences ~76
Use when the author asks to change the account time zone, weekly publication target or content reminder preference. Does not change existing publication times.
| Name | Type | Req | Description |
|---|---|---|---|
| cadencePerWeek | integer | – | – |
| remindersEnabled | boolean | – | – |
| timezone | string | – | IANA zone, for example Asia/Bangkok; publication times are stored in UTC. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| message | string | yes | – |
No examples provided.
What is the Postlyra MCP server?
Postlyra is an MCP server listed in the public MCP registry as io.github.prof-1t/postlyra-mcp. Manage Telegram drafts, media, schedules and publications from AI clients. This page covers its hosted endpoint (https://postlyra.app/mcp).
Is the Postlyra MCP server safe to use?
Postlyra scores 80 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Postlyra MCP server expose?
Postlyra exposes 32 tools: get_auth_status, get_formatting_capabilities, list_channels, list_templates, search_post_drafts, and 27 more. Their descriptions and schemas cost roughly 4,491 tokens of context every time the server is loaded.
Does the Postlyra MCP server require authentication?
Yes. Postlyra asked us for credentials when we connected, so you will need to authorise it in your MCP client before it can do anything.
Is the Postlyra MCP server still maintained?
Postlyra is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.