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. |
posts_get | Returns one post with its social account posts inline. |
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_delete | Deletes one social account post by ID. |
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. |
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. |
Media
| Tool | Description |
|---|---|
media_list | Returns media library items that belong to the API key’s organization. |
media_delete | Deletes one media item by ID. |
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. 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_session | Get media upload session status |
media_uploads_complete_session | Completes the upload session started by createUploadSession. |
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 | Delete webhook endpoint |
Health
| Tool | Description |
|---|---|
health_get | Returns a minimal response proving the WoopSocial API is reachable. |