account_get
ChatGPTRead the connected workspace and granted permissions. This does not grant posting approval.
channels_list
ChatGPTRead connected social channels. The read-only widget displays verified profile photos when supported; otherwise use names, platforms and connection statuses as text. Channel profile photos and cards are rendered by the supplied Postnilo widget only. Do not search for, guess or substitute channel images, or create additional channel cards in your response. For an account/channel overview, reply with exactly one short plain-text sentence containing the requested account email and channel names, platforms and connection statuses. Do not add headings, tables, bullets, icons, images or extra channel cards to that overview. If no widget is displayed, use the same text-only fallback. Use IDs and permissions internally for tasks; show them in an overview only when the user explicitly requests them. Complete every part of a compound request, including requested account and library information, without repeating the channel cards.
draft_save
ChatGPTSave or update a private workspace draft without scheduling publication. Updates require ID and current version. A stable idempotencyKey recovers the same new draft after response loss.
draft_schedule
ChatGPTSchedule an approved existing draft by ID and current version with the supplied post payload. Response-loss recovery uses the same post ID. Provider requirements and confirmation apply as for a new reservation.
drafts_batch_save
ChatGPTSave up to 10 independent drafts without scheduling publication. A stable batchKey and clientItemId recover each same draft after response loss. Results identify individual successes and failures.
get_profile
ChatGPTReturn the connected Postnilo account profile. Its opaque ID is stable across token refresh, reconnection and email changes.
instagram_automation_activate
ChatGPTReactivate an approved paused Instagram rule at its current version with confirmActivation=true. Enables future automatic DMs using that exact target and settings. New rule creation already handles activation.
instagram_automation_delete
ChatGPTDelete an Instagram automation and its delivery history at the current version. Does not delete the Instagram post.
instagram_automation_events
ChatGPTRead bounded public delivery states and restoration eligibility for an Instagram rule. Waiting, sent, failed and unknown are distinct; recipient identifiers and message context are not exposed.
instagram_automation_get
ChatGPTRead an Instagram comment-to-DM rule, its exact settings and current version.
instagram_automation_pause
ChatGPTPause an Instagram automation at its current version, preserving pending progress. Does not send messages.
instagram_automation_resume
ChatGPTRestore an eligible canceled interaction after approval of the rule’s current settings, using rule ID, run ID and version. Restoration sends nothing; a new recipient response is required. Failed, completed and uncertain deliveries cannot be resent.
instagram_automation_save
ChatGPTCreate and enable an approved comment-to-DM rule, or update an existing paused rule with its ID and current version. A target is a connected channel’s published mediaId or scheduled sourceTargetId. New rules automatically enable future DMs or wait for successful publication; updates do not reactivate paused rules. activationStatus and activationError distinguish active, waiting and blocked states.
instagram_automation_template_apply
ChatGPTApply an exact template version to an approved connected channel and published mediaId or scheduled sourceTargetId, with optional message overrides. The new rule automatically enables future DMs or waits for successful publication. Omitted overrides inherit values; link=null removes an inherited link. Later template edits cannot change this saved snapshot.
instagram_automation_template_delete
ChatGPTDelete a reusable Instagram automation template at its current version. Existing automation snapshots remain unchanged.
instagram_automation_template_get
ChatGPTRead a reusable Instagram automation template and its current version. Reading does not activate or apply the template.
instagram_automation_template_save
ChatGPTCreate a reusable Instagram message template, or update one using its ID and current version. Existing rule snapshots are preserved. Does not activate an automation or send a message.
instagram_automation_templates_list
ChatGPTRead this workspace’s reusable message definitions. Templates contain no channel, post, recipient or enabled state.
instagram_automations_list
ChatGPTRead this workspace’s Instagram comment-to-DM rules, enabled states and current versions.
instagram_posts_list
ChatGPTRead recent posts owned by one connected Instagram channel. Returned media IDs can identify an automation target. Does not send a message.
mcp_upload_begin
ChatGPTWidget-only: validate a selected file and issue its short-lived direct-upload capability.
mcp_upload_complete
ChatGPTWidget-only: verify uploaded bytes using server validation and return a ready media ID.
media_get
ChatGPTRead current media status and safe metadata by ID in this workspace. Unready media cannot be attached; upload URLs and storage paths are not returned.
media_import_url
ChatGPTImport one user-selected public HTTPS JPEG, PNG or WebP image into this workspace. Redirects and private addresses are validated; videos are unsupported. The same idempotencyKey and URL recover the same import. No post is scheduled or published. Postnilo Media API documentation: https://postnilo.com/cli/guide.md#public-image-import-api.
media_list
ChatGPTRead the workspace media library with case-insensitive filename search, cursor and limit. Only ready media can be attached to a post.
platform_settings
ChatGPTRead supported publishing settings and limits. YouTube notices are returned only for the selected purpose, language and end-user device; requirements is the default and includes no upload or access-removal notice.
post_cancel
ChatGPTCancel the exact approved reservation using its current version. In-flight publication, uncertain outcomes or partial success may block cancellation. Returns recorded per-target outcomes.
post_delete
ChatGPTPermanently hide an exact approved internal Postnilo post at its current version and cancel untouched future targets. Library media and provider results remain; remote social content is never deleted. Active recurrence, in-flight dispatch and uncertain first-comment results block deletion. The same ID/version can recover the result after response loss.
post_get
ChatGPTRead one reservation and its per-channel results, review state and current version. Suitable for same-ID recovery after response loss. A recorded publication does not prove current availability or playback. The resultStatus and per-target statuses describe recorded outcomes; status may retain the original scheduled state. A publication record does not prove current availability or playback.
post_repeat_schedule
ChatGPTAttach a confirmed recurring rule to one existing future single-channel reservation. Supports 2–10 total occurrences, excluding TikTok, Instagram DM automation and first comments. Each confirmed publication schedules the next occurrence. Failure, unknown outcome, lost access, invalid media or ambiguous time pauses the rule. confirmFuturePublishing explicitly authorizes these future publications; response-loss recovery uses the existing rule.
post_schedule
ChatGPTCreate a reservation for explicitly approved content, channels, times and settings. targets[].scheduledAt overrides the default post time; offsets must match post.timezone. The same idempotencyKey recovers the existing reservation. TikTok’s next action is tiktok_review, then tiktok_approve. Instagram first comments run only after confirmed publication; an instagramAutomation template/version or complete definition activates only after its target is successfully published.
post_settings_update
ChatGPTUpdate selected YouTube settings on one future, unstarted target using the current post version. Content, media, time and other targets are preserved. An exact target and approved settings patch are required.
post_target_cancel
ChatGPTCancel one exact approved unstarted channel target using the current post version. Other channels retain their schedules and outcomes.
post_target_reschedule
ChatGPTChange one exact approved unstarted channel target’s time using the current post version. The offset must match the existing timezone. Other targets are preserved; TikTok needs a new review after the change.
posts_batch_schedule
ChatGPTSchedule up to 10 individually approved posts on their selected channels, times and settings. Stable batchKey/clientItemId pairs recover the same post IDs. Partial success is possible. TikTok is unsupported in this batch path because each post requires an individual in-conversation review and approval.
posts_list
ChatGPTRead this workspace’s posts and per-channel results as {items,nextCursor}. Optional cursor, limit and from/to retain the installed connection’s pagination contract. Results include every supported provider and visibility. The resultStatus and per-target statuses describe recorded outcomes; status may retain the original scheduled state. A publication record does not prove current availability or playback.
posts_search
ChatGPTPage through this workspace’s posts by per-target scheduled time, channel and status. from/to and channelId apply to the same target; undated drafts are excluded by date filters. Returns items and nextCursor. Published, sent to inbox and unknown are distinct recorded outcomes. The resultStatus and per-target statuses describe recorded outcomes; status may retain the original scheduled state. A publication record does not prove current availability or playback.
recurrence_get
ChatGPTRead a recurrence rule and its recorded occurrences by ID, including current version and state.
recurrence_stop
ChatGPTStop a recurrence rule at its current version and cancel an unstarted current reservation. A publication already in flight may still complete; no later occurrence is created.
recurrences_list
ChatGPTRead this workspace’s recurrence rules and recorded occurrences. Active rules can create a next occurrence after confirmed publication; paused and stopped rules cannot.
tiktok_approve
ChatGPTApprove the exact reviewed TikTok post with its unchanged review token and explicit policy acknowledgements. Requires approval after the human has seen the actual media and confirmed the account, caption, schedule and settings. May schedule Direct Post or inbox delivery; neither is proof of publication or receipt. Response-loss recovery uses the same post ID.
tiktok_review
ChatGPTRead the post’s actual media previews, account, current creator restrictions and selected publishing settings for an in-conversation review. Returns policy notices and a short-lived review token. Changed settings or expiry invalidate the prior review. Does not approve publication.
upload_open
ChatGPTOpen the media upload widget in this conversation, with a web fallback. File uploads are separate from drafts, scheduling and publication.
upload_status
ChatGPTRead ordered verified media IDs and per-file states for an upload session. Pending, incomplete and rejected files cannot be scheduled.