Post to Telegram from an agent

PostWharf ships a Model Context Protocol server, so Claude and other MCP clients can draft, queue and check Telegram posts as tools rather than as scraped UI.

Overview API MCP CLI

Connect it

claude mcp add --transport http \
  wharf https://mcp.postwharf.com/mcp \
  --header "Authorization: Bearer $POSTWHARF_KEY"

The key scopes every call to one workspace, so an agent can only ever act on the brand you hand it. Find it in the dashboard under API keys.

What the agent can do with Telegram

get_workspaceWhich brand this key reaches, and the clock it schedules on

list_channelsFind your connected Telegram account and its token health

describe_networksWhat Telegram takes: shapes, how many files, how much text, its own settings

connect_channelAttach a channel to the workspace

stage_uploadAn upload link and a public address for a file just made

upload_mediaRegister an image or video, get a media id

describe_mediaWrite or replace the alt text on an image

create_postPublish to Telegram now

schedule_postQueue a post for a given time

schedule_manyQueue a month of Telegram posts in one go

save_draftKeep a post without sending it, channels optional

list_draftsEverything saved and not yet sent

update_postChange the words, the time or the files on a draft or a queued post

publish_draftRelease a draft, now or at a time you pick

get_statusDelivery state, live URL, error text

list_queueWhat is scheduled and when

cancel_postPull something back out of the queue

list_eventsThe delivery receipt feed

healthWhether the API is reachable

What Telegram accepts

4,096 characters, counting one message. Up to 10 images or 10 videos per post — and the two can travel together.

Read from the table the API enforces, so a post over 4,096 is refused when you create it rather than truncated on the way to Telegram.

Asking for it in practice

# to Claude, with the connector attached
"Draft three Telegram posts about the new release,
 queue the best one for Tuesday morning,
 and tell me once it is live."

The agent drafts and queues; the delivery receipt tells you what actually published. Posts to channels you administer via a bot token you control.

Every other network

Instagram · TikTok · X · LinkedIn · YouTube · Facebook · Threads · Pinterest · Bluesky · Reddit · Discord · Snapchat · WordPress