# Postomator MCP
endpoint: https://postomator.com/mcp
transport: streamable-http
authorization_server: https://postomator.com
authentication: OAuth authorization code with S256 PKCE; API keys are not accepted for MCP
protocol_compatibility: 2025-11-25 initialize; 2026-07-28 server/discover metadata

# Tools
## apply_queue_assign
title: Apply queue assign
description: Apply a previously previewed queue assign mutation.
scope: mcp:schedule
documentation: /docs/mcp/tools/apply_queue_assign/

## apply_queue_enqueue
title: Apply queue enqueue
description: Apply a previously previewed queue enqueue mutation.
scope: mcp:schedule
documentation: /docs/mcp/tools/apply_queue_enqueue/

## apply_queue_occurrence
title: Apply queue occurrence
description: Apply a previously previewed queue occurrence mutation.
scope: mcp:schedule
documentation: /docs/mcp/tools/apply_queue_occurrence/

## apply_queue_remove
title: Apply queue remove
description: Apply a previously previewed queue remove mutation.
scope: mcp:schedule
documentation: /docs/mcp/tools/apply_queue_remove/

## apply_queue_reorder
title: Apply queue reorder
description: Apply a previously previewed queue reorder mutation.
scope: mcp:schedule
documentation: /docs/mcp/tools/apply_queue_reorder/

## apply_queue_rule
title: Apply queue rule
description: Apply a previously previewed queue rule mutation.
scope: mcp:schedule
documentation: /docs/mcp/tools/apply_queue_rule/

## apply_queue_timezone
title: Apply queue timezone
description: Apply a previously previewed queue timezone mutation.
scope: mcp:schedule
documentation: /docs/mcp/tools/apply_queue_timezone/

## approve_post
title: Approve post
description: Approve the current content revision for its selected profile.
scope: mcp:approve
documentation: /docs/mcp/tools/approve_post/

## assist_text
title: Assist with text
description: Apply one existing tracked and scrubbed LinkedIn editing operation.
scope: mcp:ai
documentation: /docs/mcp/tools/assist_text/

## cancel_invitation
title: Cancel invitation
description: Cancel an unaccepted invitation.
scope: mcp:invitations
documentation: /docs/mcp/tools/cancel_invitation/

## convert_idea_to_draft
title: Convert idea to draft
description: Atomically create or return the idea's existing draft. To schedule it, next call schedule_post with the returned post_id and post_version.
scope: mcp:content
documentation: /docs/mcp/tools/convert_idea_to_draft/

## create_content_source
title: Create content source
description: Queue a public HTTPS article for asynchronous repurposing into post ideas. Poll get_content_source for results.
scope: mcp:ai
documentation: /docs/mcp/tools/create_content_source/

## create_followup_comment
title: Create follow-up comment
description: Add planned follow-up publication content.
scope: mcp:content
documentation: /docs/mcp/tools/create_followup_comment/

## create_invitation
title: Send invitation
description: Create and email a workspace invitation.
scope: mcp:invitations
documentation: /docs/mcp/tools/create_invitation/

## create_post
title: Create draft
description: Create an unscheduled LinkedIn draft.
scope: mcp:content
documentation: /docs/mcp/tools/create_post/

## create_workspace
title: Create workspace
description: Create a workspace and explicitly add it to this connection.
scope: mcp:teams
documentation: /docs/mcp/tools/create_workspace/

## delete_content_source
title: Delete content source
description: Delete one of the caller's source jobs and its ideas.
scope: mcp:delete
documentation: /docs/mcp/tools/delete_content_source/

## delete_followup_comment
title: Delete follow-up comment
description: Delete planned follow-up publication content.
scope: mcp:delete
documentation: /docs/mcp/tools/delete_followup_comment/

## delete_media
title: Delete media
description: Permanently remove an attachment with content concurrency guards.
scope: mcp:delete
documentation: /docs/mcp/tools/delete_media/

## delete_post
title: Delete post
description: Permanently delete an unpublished draft.
scope: mcp:delete
documentation: /docs/mcp/tools/delete_post/

## delete_workspace
title: Delete workspace
description: Permanently delete the active workspace and its related records.
scope: mcp:teams
documentation: /docs/mcp/tools/delete_workspace/

## generate_linkedin_bios
title: Generate LinkedIn bios
description: Generate up to five scrubbed LinkedIn About-section drafts from a professional description.
scope: mcp:ai
documentation: /docs/mcp/tools/generate_linkedin_bios/

## generate_linkedin_carousel_text
title: Generate LinkedIn carousel text
description: Generate scrubbed titles and body copy for three to eight carousel slides; this does not render, download, or publish a PDF.
scope: mcp:ai
documentation: /docs/mcp/tools/generate_linkedin_carousel_text/

## generate_linkedin_comments
title: Generate LinkedIn comments
description: Generate exactly three scrubbed comment drafts grounded in a pasted LinkedIn post and the caller's genuine perspective; nothing is published.
scope: mcp:ai
documentation: /docs/mcp/tools/generate_linkedin_comments/

## generate_linkedin_headlines
title: Generate LinkedIn headlines
description: Generate up to ten scrubbed profile headline options from a professional description.
scope: mcp:ai
documentation: /docs/mcp/tools/generate_linkedin_headlines/

## generate_linkedin_hooks
title: Generate LinkedIn hooks
description: Generate up to ten scrubbed opening hooks for a LinkedIn post topic.
scope: mcp:ai
documentation: /docs/mcp/tools/generate_linkedin_hooks/

## generate_linkedin_post
title: Generate LinkedIn post
description: Generate one scrubbed 150–250 word LinkedIn draft from a topic or source text; this does not create or publish a post.
scope: mcp:ai
documentation: /docs/mcp/tools/generate_linkedin_post/

## generate_post_text
title: Generate post text
description: Generate scrubbed LinkedIn post text from an idea with usage tracking.
scope: mcp:ai
documentation: /docs/mcp/tools/generate_post_text/

## get_calendar
title: Get calendar
description: List scheduled posts in a bounded aware datetime interval.
scope: mcp:read
documentation: /docs/mcp/tools/get_calendar/

## get_content_source
title: Get content source
description: Get one bounded source result with all generated ideas.
scope: mcp:read
documentation: /docs/mcp/tools/get_content_source/

## get_invitation
title: Get invitation
description: Read one workspace invitation.
scope: mcp:read
documentation: /docs/mcp/tools/get_invitation/

## get_post
title: Get post
description: Read one post including scheduling and delivery state.
scope: mcp:read
documentation: /docs/mcp/tools/get_post/

## get_post_idea
title: Get post idea
description: Read one generated idea and its existing draft link.
scope: mcp:read
documentation: /docs/mcp/tools/get_post_idea/

## get_profile
title: Get profile
description: Read the authenticated connection actor's profile. This does not return or imply granted scopes.
scope: mcp:read
documentation: /docs/mcp/tools/get_profile/

## get_queue
title: Get queue
description: Read a bounded page of queue posts plus the exact IANA timezone, queue revision, and weekly rules. IDs in each post can be passed to remove, reorder, or occurrence tools.
scope: mcp:read
documentation: /docs/mcp/tools/get_queue/

## get_workspace
title: Get workspace
description: Read the active workspace and members.
scope: mcp:read
documentation: /docs/mcp/tools/get_workspace/

## list_connected_accounts
title: List connected accounts
description: Read social profile capabilities and connection health without credentials.
scope: mcp:read
documentation: /docs/mcp/tools/list_connected_accounts/

## list_content_sources
title: List content sources
description: List recent workspace repurposing jobs.
scope: mcp:read
documentation: /docs/mcp/tools/list_content_sources/

## list_followup_comments
title: List follow-up comments
description: List comments that will be published as ordered follow-up content.
scope: mcp:read
documentation: /docs/mcp/tools/list_followup_comments/

## list_invitations
title: List invitations
description: List workspace invitations.
scope: mcp:read
documentation: /docs/mcp/tools/list_invitations/

## list_pending_invitations
title: List my pending invitations
description: List pending invitations matching the actor's verified or unverified emails.
scope: mcp:read
documentation: /docs/mcp/tools/list_pending_invitations/

## list_post_ideas
title: List post ideas
description: Page generated ideas for a workspace source.
scope: mcp:read
documentation: /docs/mcp/tools/list_post_ideas/

## list_post_media
title: List post media
description: List attachment metadata; binary content is not embedded.
scope: mcp:read
documentation: /docs/mcp/tools/list_post_media/

## list_posts
title: List posts
description: Search and page through workspace posts.
scope: mcp:read
documentation: /docs/mcp/tools/list_posts/

## list_workspaces
title: List workspaces
description: List consented workspaces where membership remains active.
scope: mcp:read
documentation: /docs/mcp/tools/list_workspaces/

## prepare_cv_generation
title: Prepare CV generation
description: Validate CV metadata and return truthful instructions for one read-only PDF upload that generates headlines or bios.
scope: mcp:ai
documentation: /docs/mcp/tools/prepare_cv_generation/

## preview_queue_assign
title: Preview queue assign
description: Preview the exact queue assign mutation without committing it.
scope: mcp:read
documentation: /docs/mcp/tools/preview_queue_assign/

## preview_queue_enqueue
title: Preview queue enqueue
description: Preview the exact queue enqueue mutation without committing it.
scope: mcp:read
documentation: /docs/mcp/tools/preview_queue_enqueue/

## preview_queue_occurrence
title: Preview queue occurrence
description: Preview the exact queue occurrence mutation without committing it.
scope: mcp:read
documentation: /docs/mcp/tools/preview_queue_occurrence/

## preview_queue_remove
title: Preview queue remove
description: Preview the exact queue remove mutation without committing it.
scope: mcp:read
documentation: /docs/mcp/tools/preview_queue_remove/

## preview_queue_reorder
title: Preview queue reorder
description: Preview the exact queue reorder mutation without committing it.
scope: mcp:read
documentation: /docs/mcp/tools/preview_queue_reorder/

## preview_queue_rule
title: Preview queue rule
description: Preview the exact queue rule mutation without committing it.
scope: mcp:read
documentation: /docs/mcp/tools/preview_queue_rule/

## preview_queue_timezone
title: Preview queue timezone
description: Preview the exact queue timezone mutation without committing it.
scope: mcp:read
documentation: /docs/mcp/tools/preview_queue_timezone/

## publish_post
title: Publish post now
description: Authorize immediate publication; worker delivery remains asynchronous.
scope: mcp:publish
documentation: /docs/mcp/tools/publish_post/

## rename_document
title: Rename document
description: Change the LinkedIn document title with content concurrency guards.
scope: mcp:content
documentation: /docs/mcp/tools/rename_document/

## request_audio_transcription
title: Request audio transcription
description: Describe the bounded companion audio transfer needed for tracked transcription.
scope: mcp:ai
documentation: /docs/mcp/tools/request_audio_transcription/

## request_media_download
title: Request media download
description: Describe the required authenticated bounded companion download.
scope: mcp:read
documentation: /docs/mcp/tools/request_media_download/

## request_media_upload
title: Request media upload
description: Describe the required bounded companion transfer for an attachment.
scope: mcp:content
documentation: /docs/mcp/tools/request_media_upload/

## retry_video_preparation
title: Retry video preparation
description: Reset failed pending LinkedIn video deliveries and enqueue preparation again.
scope: mcp:publish
documentation: /docs/mcp/tools/retry_video_preparation/

## schedule_post
title: Schedule post
description: Schedule or reschedule using the actor's timezone.
scope: mcp:schedule
documentation: /docs/mcp/tools/schedule_post/

## set_post_target
title: Set post target
description: Select a LinkedIn profile for an unscheduled draft.
scope: mcp:content
documentation: /docs/mcp/tools/set_post_target/

## suggest_content_emoji
title: Suggest content emoji
description: Suggest one unused emoji for the sentence or paragraph immediately before a cursor; content is not modified or published.
scope: mcp:ai
documentation: /docs/mcp/tools/suggest_content_emoji/

## unschedule_post
title: Unschedule post
description: Remove a movable post from publication and queue.
scope: mcp:schedule
documentation: /docs/mcp/tools/unschedule_post/

## update_followup_comment
title: Update follow-up comment
description: Edit planned follow-up publication content.
scope: mcp:content
documentation: /docs/mcp/tools/update_followup_comment/

## update_invitation
title: Update invitation
description: Update an unaccepted invitation's role and permissions.
scope: mcp:invitations
documentation: /docs/mcp/tools/update_invitation/

## update_post
title: Update post
description: Replace draft content using optimistic concurrency and approval confirmation.
scope: mcp:content
documentation: /docs/mcp/tools/update_post/

## update_workspace
title: Update workspace
description: Rename the active workspace.
scope: mcp:teams
documentation: /docs/mcp/tools/update_workspace/