MCP Tools Reference
Posts
| Tool | Description |
|---|---|
posts_create | Creates a (parent) post with one or more social account (child) posts. |
posts_validate | Validates a post without creating one. This tool applies the same validation rules as posts_create, including social account resolution, platform-specific validation, and media validation for referenced media library items. |
posts_get | Returns one post with its social account posts inline: one per target social account, each with its own deliveryStatus. |
posts_delete | Deletes one scheduled post by post ID. |
social_account_posts_list | Returns standalone social account posts for the API key’s organization. |
social_account_posts_list_analytics | Returns the organization’s social account posts published in a range of UTC days, each with its latest stored metrics. Posts are ordered by sortBy, highest first, or newest first when sortBy is omitted. |
social_account_posts_delete | Deletes one social account post by ID. |
social_account_posts_update | Updates the content or schedule of one social account post. |
Projects
| Tool | Description |
|---|---|
projects_create | Creates a project in the API key’s organization. |
projects_list | Returns projects that belong to the same organization as the API key. A project corresponds to a “Business Profile” in the UI. |
projects_delete | Permanently deletes one project and its related data, including connected social accounts, OAuth grants, media references, and posts. |
Social Accounts
| Tool | Description |
|---|---|
oauth_create_authorization | Generates a browser authorization URL for connecting a new social account to a project. Flow: 1. Call this tool with the projectId and target platform. Omit redirectUrl unless the user asks for one. 2. Give the returned url to the user and ask them to open it in their browser and complete the authorization. 3. Once the user says they are done, call social_accounts_list with the projectId to confirm the connected account. For Facebook, WoopSocial shows a page-selection screen after authorization. The selected pages are connected to the projectId. |
social_accounts_list | Returns social accounts that can currently be used for publishing. |
social_accounts_delete | Deletes one social account connection by ID. |
social_accounts_get_platform_inputs | Returns platform-specific input options for a connected social account. |
social_accounts_get_analytics | Returns account-level metrics of one social account over a range of UTC days: its follower count and the views, engagements and other activity across all of its content. Per-post metrics are in each social account post’s metrics. |
Media
| Tool | Description |
|---|---|
media_list | Returns media library items that belong to the API key’s organization. |
media_import | Imports a file attached to this chat into a project’s media library and returns its mediaId for use in posts. Call it once per attached file. For a file on disk, use media_uploads_create_session instead. |
media_delete | Deletes one media item and its stored files. |
media_uploads_create_session | This 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. Upload the file in partCount parts by sending an HTTP PUT with the raw bytes of each part to the matching parts[n].uploadUrl. Every part except the last must be exactly partSizeInBytes bytes. The last part may be smaller. After all parts have been uploaded, call media_uploads_complete_session to finalize the upload and create the media item. The presigned URLs expire at expiresAt. Uploading the parts requires making HTTP requests yourself (for example with curl in a shell or code execution tool). If you cannot make HTTP requests, tell the user the upload is not possible from this client. The presigned URLs are hosted on Cloudflare R2 (<account-id>.r2.cloudflarestorage.com). If a network allowlist blocks the PUT, ask the user to allow *.r2.cloudflarestorage.com: - claude.ai / Claude Desktop chat: Settings > Capabilities, in the code execution network settings. - Claude Code: the sandbox’s allowed network domains in settings.json. |
media_uploads_get_session | Returns the current status of a media upload session. |
media_uploads_complete_session | Finalizes an upload session started by media_uploads_create_session and creates the media item. Call it once every part has been uploaded to its parts[n].uploadUrl. It returns status READY with the new mediaId, or FAILED with failureCode and failureMessage. Calling it again on a finished session returns the same result. |
Webhooks
| Tool | Description |
|---|---|
webhooks_create_endpoint | Registers a URL to receive webhook events for the specified event types. |
webhooks_list_endpoints | Returns all registered webhook endpoints for the organization. The signingSecret field is omitted. |
webhooks_delete_endpoint | Deletes one webhook endpoint, so its URL stops receiving events. |
Health
| Tool | Description |
|---|---|
health_get | Returns a minimal response proving the WoopSocial API is reachable. |
Me
| Tool | Description |
|---|---|
me_get | Returns the email of the WoopSocial user this connection acts as: the user who approved the OAuth connection, or who created the API key. |
Fallback tools
Workarounds for MCP clients that can’t load a tool’s full input schema. Prefer the tools above when your client supports them.| Tool | Description |
|---|---|
posts_create_simple | Compatibility workaround for MCP clients that cannot load the full posts_create input schema. This is not a simplified input format and uses the same validation and behavior as posts_create. Prefer posts_create when available. To call this fallback: call schema_describe with toolName: "posts_create_simple", construct an object matching the returned canonical schema, JSON-encode the entire object, and pass that string as requestJson. Do not pass canonical fields such as content, schedule, or socialAccounts directly to this tool. |
posts_validate_simple | Compatibility workaround for MCP clients that cannot load the full posts_validate input schema. This is not a simplified input format and uses the same validation and behavior as posts_validate. Prefer posts_validate when available. To call this fallback: call schema_describe with toolName: "posts_validate_simple", construct an object matching the returned canonical schema, JSON-encode the entire object, and pass that string as requestJson. Do not pass canonical fields such as content, schedule, or socialAccounts directly to this tool. |
schema_describe | Returns the canonical input schema. |