Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "postlyra-mcp": {
      "type": "http",
      "url": "https://postlyra.app/mcp"
    }
  }
}

claude mcp add --transport http postlyra-mcp https://postlyra.app/mcp

[mcp_servers.postlyra-mcp]
url = "https://postlyra.app/mcp"

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "postlyra-mcp": {
      "type": "remote",
      "url": "https://postlyra.app/mcp",
      "enabled": true
    }
  }
}

{
  "mcpServers": {
    "postlyra-mcp": {
      "type": "http",
      "url": "https://postlyra.app/mcp"
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=postlyra-mcp&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vcG9zdGx5cmEuYXBwL21jcCJ9"
}

{
  "servers": {
    "postlyra-mcp": {
      "type": "http",
      "url": "https://postlyra.app/mcp"
    }
  }
}

{
  "mcpServers": {
    "postlyra-mcp": {
      "httpUrl": "https://postlyra.app/mcp"
    }
  }
}

extensions:
  "postlyra-mcp":
    enabled: true
    name: "postlyra-mcp"
    type: streamable_http
    uri: "https://postlyra.app/mcp"
    timeout: 300

Quality 76 / 100good

protocol88 · weight 25

pass
protocol.modernsupports 2026-07-28 (server/discover)
pass
protocol.statelessanswers without a session
pass
protocol.transportstreamable HTTP
warn
protocol.list_ttltools/list declares ttlMs 0, so clients re-fetch it on every use

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene93 · weight 30

pass
tools.descriptionsevery tool has a description
pass
tools.description_lengthdescriptions are concise
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations41 of 41 tools declare readOnlyHint or destructiveHint
pass
tools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
warn
tools.token_costabout 15,283 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stability25 · weight 15

warn
stability.changes38 tool changes in 30 days
fail
stability.rug_pull6 tools kept their name but changed most of their description in 30 days; review before trusting them

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

41 tools, about 15,283 tokens to load them all · tool set f2b24c03c5b8 · tools last changed 2026-10-14 · checked 2026-10-20 12:13 UTC

Tool changes

2026-10-14show_post_cardchangeddescriptionmeaning changed
before
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.
after · 37% of words in common
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 publication controls in MCP Apps hosts; a browser preview link is different. Never publishes, schedules or enables a public link.
2026-10-14attach_media_to_draftchangedoutput schema
2026-10-14update_post_draftchangedoutput schema
2026-10-14preview_postchangedoutput schema
2026-10-14create_post_draftchangeddescription, output schema
before
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 card on MCP Apps hosts; keep the link and follow display instructions. Image references/file inputs are validated and imported; direct RichDocument media.src can remain external. Check validation. Never publishes.
after · 80% of words in common
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 card. Keep the link and follow display instructions. Image references/file inputs are validated and imported; direct RichDocument media.src can remain external. Check validation. Never publishes.
2026-10-14get_formatting_capabilitieschangedoutput schema
2026-10-13list_channelschangedoutput schema
2026-10-13get_auth_statuschangeddescription, output schemameaning changed
before
Use this when you need to check whether the current MCP caller is authorized through Telegram and linked to a Postlyra account.
after · 20% of words in common
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.
2026-10-13list_publicationschangedinput schema
2026-10-13update_postchangedinput schema

Showing the latest 10. Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 94 / 100

provenance90

liveness100

freshness85

hygiene100

+repository +namespace-matches-repo +website +reachable +uptime-100% ~updated-39d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://postlyra.app/mcp` streamable-http	none	yes	100%	492 ms	2026-07-28	2026-10-20

Tools (41)

`apply_post_to_publication`destructive	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.
`archive_post`destructive	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.
`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 unchanged. Never publishes.
`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.
`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 richDocument file-slot bindings. Returns JPEG/public preview; follow display instructions, validation and error nextAction. Never publishes.
`cancel_publication`destructive	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.
`convert_draft_to_signature`destructive	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.
`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.
`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.
`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 card. Keep the link and follow display instructions. Image references/file inputs are validated and imported; direct RichDocument media.src can remain external. Check validation. Never publishes.
`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.
`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.
`delete_publication`destructive	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.
`delete_signature`destructive	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.
`delete_template`destructive	Use when the author asks to delete their saved template. Existing posts made from it are preserved.
`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.
`get_auth_status`read-only	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_content_attention`read-only	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.
`get_formatting_capabilities`read-only	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_post`read-only	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_postlyra_guide`read-only	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 examples. Explains IDs, revisions, media, buttons, consent and Free attribution. Public help only: reads no user data and never sends. Use get_formatting_capabilities for full RichDocument syntax.
`get_signature`read-only	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.
`get_workspace`read-only	Use when checking publication quotas, storage, connected chat count or the account time zone before planning content.
`list_channels`read-only	Use this when you need to list Telegram channels, groups, and chats the authorized user can manage through Postlyra.
`list_publications`read-only	Use when inspecting scheduled publications, delivery failures or messages previously published by Postlyra. Returns publicationId for rescheduling, cancellation, targeted edits or deletion.
`list_signatures`read-only	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.
`list_templates`read-only	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.
`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.truncated and retry unavailable screenshots without recreating the draft. May fetch external image URLs for screenshot rendering. 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.
`publish_post`destructive	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 without a job or send. expectedRevision protects against stale content. Reuse idempotencyKey on retry. Pending/uncertain is not delivered. Never invent consent or bypass it with scheduling.
`reschedule_publication`destructive	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.
`restore_post`	Use when restoring an archived Postlyra post as a working draft. Previously canceled publication jobs are not restarted.
`schedule_post`destructive	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.
`search_post_drafts`read-only	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_posts`read-only	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.
`show_post_card`read-only	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 publication controls in MCP Apps hosts; a browser preview link is different. Never publishes, schedules or enables a public link.
`update_post`destructive	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_draft`destructive	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 instructions and validation. Image references/files are imported; arbitrary RichDocument media.src may remain external. Never publishes.
`update_signature`destructive	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.
`update_template`destructive	Use when changing the author's saved template. System templates and other users' templates cannot be edited.
`update_workspace`destructive	Use when the author asks to change the account time zone, weekly publication target or content reminder preference. Does not change existing publication times.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "io.github.prof-1t/postlyra-mcp",
  "title": "Postlyra",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://postlyra.app/mcp",
      "type": "streamable-http"
    }
  ],
  "version": "0.2.0-rc.1",
  "repository": {
    "url": "https://github.com/prof-1t/postlyra-mcp",
    "source": "github"
  },
  "websiteUrl": "https://postlyra.app",
  "description": "Manage Telegram drafts, media, schedules and publications from AI clients."
}