Tool Reference

Complete reference for all 28 tools exposed by the Outstand MCP server. Each tool includes its parameters, descriptions, and example usage.

Posts

create_post

Create and publish or schedule a post to one or more social media platforms.

Parameters:

Platform-specific overrides (optional object per platform):

• Instagram: publishAsStory, reelThumbOffset, userTags, collaborators, altText
• YouTube: isShort, categoryId, privacyStatus, madeForKids, tags, title
• TikTok: postMode, privacyLevel, disableComment, disableDuet, disableStitch, autoAddMusic
• Google Business: topicType (STANDARD/EVENT/OFFER), event details, offer details, call-to-action
• Pinterest: board_id, link, alt_text, title
• Threads: country geo-restrictions, reply_control

Field names are camelCase, except for Pinterest and threads.reply_control, which are snake_case. Names that do not match are dropped and reported in the response warnings array - so post_mode is silently ignored, while postMode takes effect. TikTok defaults to postMode: "MEDIA_UPLOAD" (a draft in the creator's inbox); set postMode: "DIRECT_POST" with a privacyLevel to publish straight to the profile.

Example conversation:

"Post 'Excited to announce our new feature!' to my X and LinkedIn accounts"

---

update_post

Update a post that has not been published yet. Every field is optional - only the fields you send are changed.

Parameters:

Platform-specific overrides accept the same per-platform objects as create_post, and are merged per network and per field within a network - sending only tiktok leaves the stored YouTube configuration alone, and sending only tiktok.disableComment leaves the stored TikTok postMode and privacyLevel alone.

Notes:

• Sending content or containers replaces the post body entirely; there is no per-container patching.
• The set of social accounts a post publishes to cannot be changed. Delete the post and create a new one instead.
• Changing scheduledAt cancels the queued publishing job and creates a new one for the new time. The response reports rescheduled: true when that happened.
• Posts that are already published, even for a single account, cannot be edited.

Example conversation:

"Move tomorrow's LinkedIn post to Friday at 9am and change the copy to mention the new pricing"

---

list_posts

Query posts with optional filters and pagination.

Parameters:

Example conversation:

"Show me my last 5 published posts on LinkedIn"

---

get_post

Retrieve details of a specific post including its containers and media.

Parameters:

---

get_post_analytics

Fetch engagement metrics for a published post across platforms.

Parameters:

Returns: likes, comments, shares, views, impressions, reach, engagement rate (where supported by the platform).

Example conversation:

"How did my last tweet perform? Show me the engagement numbers."

---

delete_post

Delete a post or cancel a scheduled post.

Parameters:

---

delete_remote_post

Delete a published post from the remote social network platforms it was published to. The Outstand record is kept, but the post is removed from the platforms themselves.

Parameters:

Returns: Per-account results. Networks that do not support deletion via API (TikTok, Instagram, Threads) are reported as failed while others are still attempted.

---

repost_post

Repost (reshare) a published post to the social networks it was published to. Optionally add a quote (commentary) on top of the repost where the network supports it.

Parameters:

Returns: Per-account results (network, username, platform_post_id, status, repost_id, error). Networks without a native repost API (Facebook, Instagram, Pinterest, TikTok, Google Business, Vimeo, YouTube) are reported as failed while others are still attempted. success is true if at least one network was reposted to.

Example conversation:

"Reshare my last LinkedIn post and add the comment 'Still true a month later.'"

---

create_reply

Reply to a published post on the platform.

Parameters:

---

get_replies

Fetch comments and replies on a published post.

Parameters:

---

Social Accounts

list_social_accounts

List all connected social media accounts.

Parameters:

Example conversation:

"Show me all my connected accounts"

---

get_social_account

Get details of a specific connected account.

Parameters:

---

delete_social_account

Permanently disconnect a social account.

Parameters:

---

connect_bluesky

Connect a Bluesky account using handle and app password (no OAuth required).

Parameters:

---

get_account_metrics

Get follower count and engagement metrics over a date range.

Parameters:

---

list_pinterest_boards

List available Pinterest boards for a connected Pinterest account. Required before creating pins.

Parameters:

---

Media

upload_media

Get a presigned URL for uploading an image or video file. The URL is valid for 1 hour.

Parameters:

Returns: upload_url (presigned URL for HTTP PUT) and media_id.

Upload workflow:

1. Call upload_media to get the presigned URL and media ID
2. Upload the file via HTTP PUT to the presigned URL
3. Call confirm_media_upload with the media ID to activate it
4. Use the media ID in create_post to attach it to a post

---

confirm_media_upload

Confirm a completed upload and make the file available for use.

Parameters:

Returns: Public URL of the uploaded file. Media files are retained for 60 days.

---

list_media

List all media files in your organization.

Parameters:

---

get_media

Get details of a specific media file including metadata and URLs.

Parameters:

---

delete_media

Delete a media file from storage.

Parameters:

---

Social Networks

create_social_network

Store OAuth credentials for a social media platform (BYOK model).

Parameters:

---

list_social_networks

List all configured social network credentials. Secrets are never returned.

---

get_social_network

Get configuration details of a specific platform.

Parameters:

---

update_social_network

Update or rotate OAuth credentials for a platform.

Parameters:

---

delete_social_network

Remove a platform configuration and its stored credentials.

Parameters:

---

get_auth_url

Generate an OAuth authorization URL to connect a new social account.

Parameters:

---

Account

get_account_usage

View your current usage statistics and billing information.

Returns:

• Connected social account count vs. plan limit
• Post count in current billing period
• Billing period start and end dates

Example conversation:

"How many posts have I used this month?"