# WoopSocial — MCP server on mcp.ai
> Connect your WoopSocial account and use 20 tools for social media marketing straight from your AI agent. Connect with your own API key. WoopSocial provides social media publishing, scheduling, media, project, account, and webhook management through its REST API.

By: mcp.ai · official
Page: https://mcp.ai/woop_social

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_woop_social?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/woop_social/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/woop_social/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/woop_social/skill.md
Postman collection (v2.1): https://mcp.ai/woop_social/postman.json

## Tools
- woop_social_create_draft_post(content: object[], social_accounts: object[], auto_delete_media_after_publish?: boolean) — Save a post as a WoopSocial draft without publishing it externally. TikTok MEDIA_UPLOAD targets require human completion in TikTok if publication is later initiated. If enabled, media cleanup may perm
- woop_social_create_project(name: string) — Create a WoopSocial project in the API key's organization.
- woop_social_delete_media(media_id: string) — Permanently delete one WoopSocial media-library item by its exact, explicitly supplied media ID. This operation cannot be undone. Never infer, guess, or automatically select the media ID.
- woop_social_delete_post(post_id: string) — Permanently delete a parent post by its exact ID. Deletion is allowed only while every social-account delivery is still NOT_STARTED; any delivery in another state causes a conflict and the post is not
- woop_social_delete_project(project_id: string) — Permanently delete a WoopSocial project by an exact, explicitly supplied project ID. This irreversible cascading deletion also permanently deletes the project's social accounts, OAuth grants, media re
- woop_social_delete_social_account(social_account_id: string) — Permanently remove a connected social account from WoopSocial using its exact ID. This irreversible operation disconnects the account and revokes and deletes its stored OAuth grant and tokens. The con
- woop_social_delete_social_account_post(social_account_post_id: string) — Permanently delete one social-account-specific post delivery using its exact delivery ID. The ID is distinct from the parent post ID.
- woop_social_delete_webhook(webhook_id: string) — Permanently delete one WoopSocial webhook endpoint using its exact, explicitly supplied webhook ID. This operation cannot be undone. Never infer, guess, or automatically select the webhook ID.
- woop_social_get_post(post_id: string) — Get a parent post and its per-social-account delivery records by post ID.
- woop_social_get_social_account_platform_inputs(social_account_id: string) — Get dynamic Pinterest board choices or TikTok posting-policy options for a connected social account before constructing a post target.
- woop_social_list_media(limit?: integer, media_ids?: string[], project_id?: string, next_cursor?: string) — List one page of WoopSocial media-library items, optionally filtered by project or exact media IDs.
- woop_social_list_projects() — List all projects accessible to the connected WoopSocial API key.
- woop_social_list_social_account_posts(limit?: integer, post_ids?: string[], platforms?: string[], next_cursor?: string, project_ids?: string[], delivery_statuses?: string[], social_account_ids?: string[]) — List one page of per-account post deliveries, optionally filtered by projects, social accounts, parent posts, platforms, or delivery statuses.
- woop_social_list_social_accounts(project_id?: string) — List connected social accounts available for publishing, optionally within one project.
- woop_social_list_webhooks() — List registered WoopSocial webhook endpoints and their subscribed events. Signing secrets are not returned and cannot be recovered with this tool.
- woop_social_publish_post_now(content: object[], social_accounts: object[], auto_delete_media_after_publish?: boolean) — Publish a post to external social platforms now; external publication is an irreversible action. TikTok MEDIA_UPLOAD requires a human to finish publication in TikTok instead of completing direct publi
- woop_social_register_webhook(url: string, event_types: string[]) — Register a public HTTPS endpoint for WoopSocial publishing-success and/or publishing-failure events. The response contains a sensitive signing secret exactly once; capture and store it securely becaus
- woop_social_schedule_post(content: object[], scheduled_for: string, social_accounts: object[], auto_delete_media_after_publish?: boolean) — Schedule automatic future publication to external social platforms; that future publication is irreversible. TikTok MEDIA_UPLOAD still requires a human to finish publication in TikTok. If enabled, med
- woop_social_upload_media(file: object, project_id: string) — Upload one image or video of at most 100 MB into a WoopSocial project using the atomic multipart endpoint.
- woop_social_validate_post(content: object[], schedule: object, social_accounts: object[], auto_delete_media_after_publish?: boolean) — Validate a proposed WoopSocial post without creating it. Returns blocking errors and non-blocking warnings for the complete multi-platform request.

## Example prompts
- "What can I do in WoopSocial?"
- "Show me a summary of my WoopSocial account"

## Links
Docs: https://mcp.ai/docs/mcps/woop_social
Website: https://mcp.ai/mcps/woop_social