Skip to main content

MCP Tools Reference

Posts

ToolDescription
createPostCreates a post with one or more social-account targets.
validatePostValidates a post without creating one.
getPostReturns one post with its social account posts inline.
deletePostDeletes one scheduled post by post ID.
listSocialAccountPostsReturns standalone social account posts for the API key’s organization.

Projects

ToolDescription
listProjectsReturns projects that belong to the same organization as the API key. A project corresponds to a “Business Profile” in the UI.

Social Accounts

ToolDescription
createOAuthAuthorizationGenerates a browser authorization URL for connecting a new social account to a project. Open the returned url in a browser to complete the platform-specific OAuth flow.
listSocialAccountsReturns social accounts that can currently be used for publishing.
getSocialAccountPlatformInputsReturns platform-specific input options for a connected social account.

Media

ToolDescription
createUploadSessionThis endpoint can be used to upload both smaller and larger files (up to 5GB) in a chunked manner. Calling this creates an upload session and returns presigned URLs for uploading the file in parts.
getUploadSessionGet media upload session status
completeUploadSessionCompletes the upload session started by createUploadSession.

Webhooks

ToolDescription
createWebhookEndpointRegisters a URL to receive webhook events for the specified event types.
listWebhookEndpointsReturns all registered webhook endpoints for the organization. The signingSecret field is omitted.
deleteWebhookEndpointDelete webhook endpoint

Health

ToolDescription
getHealthReturns a minimal response proving the WoopSocial API is reachable.