# WoopSocial — how to use (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.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_woop_social?ms=1787296020000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `woop_social_create_draft_post`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/woop_social`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/woop_social/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/woop_social/create/draft/post` — 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
  - body: { content: object[], social_accounts: object[], auto_delete_media_after_publish?: boolean }
- `POST https://api.mcp.ai/api/woop_social/create/project` — Create a WoopSocial project in the API key's organization.
  - body: { name: string }
- `POST https://api.mcp.ai/api/woop_social/delete/media` — 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.
  - body: { media_id: string }
- `POST https://api.mcp.ai/api/woop_social/delete/post` — 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
  - body: { post_id: string }
- `POST https://api.mcp.ai/api/woop_social/delete/project` — 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
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/woop_social/delete/social/account` — 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
  - body: { social_account_id: string }
- `POST https://api.mcp.ai/api/woop_social/delete/social/account/post` — Permanently delete one social-account-specific post delivery using its exact delivery ID. The ID is distinct from the parent post ID.
  - body: { social_account_post_id: string }
- `POST https://api.mcp.ai/api/woop_social/delete/webhook` — 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.
  - body: { webhook_id: string }
- `POST https://api.mcp.ai/api/woop_social/get/post` — Get a parent post and its per-social-account delivery records by post ID.
  - body: { post_id: string }
- `POST https://api.mcp.ai/api/woop_social/get/social/account/platform/inputs` — Get dynamic Pinterest board choices or TikTok posting-policy options for a connected social account before constructing a post target.
  - body: { social_account_id: string }
- `POST https://api.mcp.ai/api/woop_social/list/media` — List one page of WoopSocial media-library items, optionally filtered by project or exact media IDs.
  - body: { limit?: integer, media_ids?: string[], project_id?: string, next_cursor?: string }
- `POST https://api.mcp.ai/api/woop_social/list/projects` — List all projects accessible to the connected WoopSocial API key.
- `POST https://api.mcp.ai/api/woop_social/list/social/account/posts` — List one page of per-account post deliveries, optionally filtered by projects, social accounts, parent posts, platforms, or delivery statuses.
  - body: { limit?: integer, post_ids?: string[], platforms?: string[], next_cursor?: string, project_ids?: string[], delivery_statuses?: string[], social_account_ids?: string[] }
- `POST https://api.mcp.ai/api/woop_social/list/social/accounts` — List connected social accounts available for publishing, optionally within one project.
  - body: { project_id?: string }
- `POST https://api.mcp.ai/api/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.
- `POST https://api.mcp.ai/api/woop_social/publish/post/now` — 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
  - body: { content: object[], social_accounts: object[], auto_delete_media_after_publish?: boolean }
- `POST https://api.mcp.ai/api/woop_social/register/webhook` — 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
  - body: { url: string, event_types: string[] }
- `POST https://api.mcp.ai/api/woop_social/schedule/post` — 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
  - body: { content: object[], scheduled_for: string, social_accounts: object[], auto_delete_media_after_publish?: boolean }
- `POST https://api.mcp.ai/api/woop_social/upload/media` — Upload one image or video of at most 100 MB into a WoopSocial project using the atomic multipart endpoint.
  - body: { file: object, project_id: string }
- `POST https://api.mcp.ai/api/woop_social/validate/post` — Validate a proposed WoopSocial post without creating it. Returns blocking errors and non-blocking warnings for the complete multi-platform request.
  - body: { content: object[], schedule: object, social_accounts: object[], auto_delete_media_after_publish?: boolean }

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

## More
- Page: https://mcp.ai/woop_social
- Agent spec (llms.txt): https://mcp.ai/woop_social/llms.txt
- Postman collection: https://mcp.ai/woop_social/postman.json