Tool Reference

Complete reference for all 25 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:

Parameter	Type	Required	Description
`content`	string	Yes	The text content of the post
`social_account_ids`	string[]	Yes	IDs of social accounts to post to
`scheduled_at`	string	No	ISO 8601 datetime for scheduling (up to 30 days ahead)
`media_ids`	string[]	No	IDs of uploaded media to attach
`first_comment`	string	No	First comment to add after publishing
`thread_content`	string[]	No	Additional posts for thread/carousel format

Platform-specific overrides (optional object per platform):

Instagram: publish_as_story, reel_thumb_offset, user_tags, collaborators, alt_text
YouTube: is_short, category_id, privacy_status, made_for_kids, tags, title
TikTok: post_mode, privacy_level, disable_comment, disable_duet, disable_stitch, auto_add_music
Google Business: topic_type (standard/event/offer), event details, offer details, call-to-action
Pinterest: board_id, link, alt_text, title
Threads: country geo-restrictions

Example conversation:

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

list_posts

Query posts with optional filters and pagination.

Parameters:

Parameter	Type	Required	Description
`status`	string	No	Filter by status: `draft`, `scheduled`, `published`, `failed`
`social_account_id`	string	No	Filter by social account
`limit`	number	No	Number of results (default: 20)
`offset`	number	No	Pagination offset

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:

Parameter	Type	Required	Description
`post_id`	string	Yes	The post ID

get_post_analytics

Fetch engagement metrics for a published post across platforms.

Parameters:

Parameter	Type	Required	Description
`post_id`	string	Yes	The post ID

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:

Parameter	Type	Required	Description
`post_id`	string	Yes	The post ID

create_reply

Reply to a published post on the platform.

Parameters:

Parameter	Type	Required	Description
`post_container_id`	string	Yes	The container ID of the post to reply to
`content`	string	Yes	The reply content

get_replies

Fetch comments and replies on a published post.

Parameters:

Parameter	Type	Required	Description
`post_container_id`	string	Yes	The container ID of the post

list_social_accounts

List all connected social media accounts.

Parameters:

Parameter	Type	Required	Description
`network`	string	No	Filter by network (e.g., `x`, `linkedin`, `instagram`)
`username`	string	No	Filter by username

Example conversation:

"Show me all my connected accounts"

get_social_account

Get details of a specific connected account.

Parameters:

Parameter	Type	Required	Description
`social_account_id`	string	Yes	The account ID

delete_social_account

Permanently disconnect a social account.

Parameters:

Parameter	Type	Required	Description
`social_account_id`	string	Yes	The account ID

connect_bluesky

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

Parameters:

Parameter	Type	Required	Description
`handle`	string	Yes	Bluesky handle (e.g., `yourname.bsky.social`)
`app_password`	string	Yes	App password from Bluesky settings

get_account_metrics

Get follower count and engagement metrics over a date range.

Parameters:

Parameter	Type	Required	Description
`social_account_id`	string	Yes	The account ID
`start_date`	string	No	Start date (ISO 8601)
`end_date`	string	No	End date (ISO 8601)

list_pinterest_boards

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

Parameters:

Parameter	Type	Required	Description
`social_account_id`	string	Yes	The Pinterest account ID

Media

upload_media

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

Parameters:

Parameter	Type	Required	Description
`file_name`	string	Yes	Name of the file to upload
`content_type`	string	Yes	MIME type (e.g., `image/jpeg`, `video/mp4`)

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

Upload workflow:

Call upload_media to get the presigned URL and media ID
Upload the file via HTTP PUT to the presigned URL
Call confirm_media_upload with the media ID to activate it
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:

Parameter	Type	Required	Description
`media_id`	string	Yes	The media ID from `upload_media`

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

list_media

List all media files in your organization.

Parameters:

Parameter	Type	Required	Description
`limit`	number	No	Number of results
`offset`	number	No	Pagination offset

get_media

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

Parameters:

Parameter	Type	Required	Description
`media_id`	string	Yes	The media ID

delete_media

Delete a media file from storage.

Parameters:

Parameter	Type	Required	Description
`media_id`	string	Yes	The media ID

create_social_network

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

Parameters:

Parameter	Type	Required	Description
`network`	string	Yes	Platform identifier (e.g., `x`, `linkedin`, `instagram`)
`client_key`	string	Yes	OAuth Client ID / API Key
`client_secret`	string	Yes	OAuth Client Secret / API Secret