Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.woopsocial.com/llms.txt

Use this file to discover all available pages before exploring further.

MCP Tools Reference

Posts

ToolDescription
posts_createCreates a (parent) post with one or more social account (child) posts.
posts_validateValidates a post without creating one.
posts_getReturns one post with its social account posts inline.
posts_deleteDeletes one scheduled post by post ID.
social_account_posts_listReturns standalone social account posts for the API key’s organization.
social_account_posts_deleteDeletes one social account post by ID.

Projects

ToolDescription
projects_createCreates a project in the API key’s organization.
projects_listReturns projects that belong to the same organization as the API key. A project corresponds to a “Business Profile” in the UI.
projects_deletePermanently deletes one project and its related data, including connected social accounts, OAuth grants, media references, and posts.

Social Accounts

ToolDescription
oauth_create_authorizationGenerates a browser authorization URL for connecting a new social account to a project.
social_accounts_listReturns social accounts that can currently be used for publishing.
social_accounts_get_platform_inputsReturns platform-specific input options for a connected social account.

Media

ToolDescription
media_listReturns media library items that belong to the API key’s organization.
media_deleteDeletes one media item by ID.
media_uploads_create_sessionThis 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. The presigned URLs are hosted on Cloudflare. If your MCP client has restrictions on which domains it is allowed to send data to, you will need to add r2.cloudflarestorage.com to your MCP client’s approved domains. On Claude Desktop, you can do this in Settings > Capabilities > Scroll Down > Domain Allowlist > enter ‘r2.cloudflarestorage.com’.
media_uploads_get_sessionGet media upload session status
media_uploads_complete_sessionCompletes the upload session started by createUploadSession.

Webhooks

ToolDescription
webhooks_create_endpointRegisters a URL to receive webhook events for the specified event types.
webhooks_list_endpointsReturns all registered webhook endpoints for the organization. The signingSecret field is omitted.
webhooks_delete_endpointDelete webhook endpoint

Health

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