posts_createLABSCO SUMMARY
Social publishing an agent can drive end to end.
The tools mirror the whole API rather than a read-only slice, so an assistant can connect an account, upload the video and schedule the post without you opening the dashboard. The validate call is the one worth building a habit around: it checks a post against each platform's rules before anything exists.
What it is
A hosted server at https://api.woopsocial.com/mcp, over Streamable HTTP, that gives an assistant the same operations as the WoopSocial API: projects, connected social accounts, posts, media, webhooks and a health check.
What you get
- posts_create builds a parent post with one child post per social account; posts_validate checks the same post without creating anything
- posts_get, posts_delete, social_account_posts_list and social_account_posts_delete for reading and cleaning up what is already scheduled
- social_accounts_list returns the accounts cleared for publishing, and social_accounts_get_platform_inputs the options each platform accepts
- oauth_create_authorization returns the browser URL that connects a new social account to a project
- media_uploads_create_session handles files up to 5GB in parts; media_list and media_delete manage the library
- webhooks_create_endpoint registers a URL to receive the post events you name
Requirements
A WoopSocial account. The endpoint implements OAuth, so the client sends you to log in; an API key is the fallback for clients that cannot complete that flow. Chunked uploads hand back presigned URLs on r2.cloudflarestorage.com, which some clients need added to their domain allowlist first.
Setup effort
One command, then sign in — claude mcp add --transport http woopsocial "https://api.woopsocial.com/mcp", then approve the OAuth sign-in
USE CASES
01
Scheduling a week of posts across several platforms
Create one post carrying a child post per connected account, and validate it first so platform-specific rejections surface before anything is scheduled.
02
Connecting a new social account without leaving the chat
Ask for the authorization URL for the project, open it in the browser, and the account appears in the publishable list.
03
Publishing a video too big for one request
Open a chunked upload session for files up to 5GB, upload the parts, then attach the finished media to the post.
04
Being told when a post actually goes out
Register a callback URL for the post events you care about instead of polling for status.
22 tools
Listed in project docs. Your client may show a different list.
posts_validateposts_getposts_deletesocial_account_posts_listsocial_account_posts_deleteprojects_createprojects_listprojects_deleteoauth_create_authorizationsocial_accounts_listsocial_accounts_deletesocial_accounts_get_platform_inputsmedia_listmedia_deletemedia_uploads_create_sessionmedia_uploads_get_sessionmedia_uploads_complete_sessionwebhooks_create_endpointwebhooks_list_endpointswebhooks_delete_endpointhealth_getBEFORE YOU INSTALL
What to know first
Tools you get
22 tools named in the project's documentation.
INSTALLATION
Connect your client
Server setup
Setup
Create a WoopSocial account here.
Make sure you have at least one social media account connected (Connect accounts in your dashboard)
OAuth route (preferred): claude mcp add --transport http woopsocial "https://api.woopsocial.com/mcp", then in Claude type /mcp, select the woopsocial · △ needs authentication menu item, select Authenticate, and click Authorize on the WoopSocial page.
Codex: codex mcp add woopsocial --url https://api.woopsocial.com/mcp then codex mcp login woopsocial
API-key fallback for clients that can't do OAuth: Create an API key here, copy the MCP URL, and use https://api.woopsocial.com/mcp?api_key=<YOUR_API_KEY>.
If the client has an allowlist for outbound domains, add *.cloudflarestorage.com so media uploads work.
Hosted endpoint
ENDPOINT URL
https://api.woopsocial.com/mcpAdd this hosted endpoint to your MCP client, then sign in.
MCP Clients
Claude Desktop
Settings → Connectors → Customize → Add Connector → Add Custom Connector, name it 'woopsocial', URL https://api.woopsocial.com/mcp
Claude Code
CLAUDE CODE · TERMINAL
claude mcp add --transport http woopsocial "https://api.woopsocial.com/mcp"Codex
CODEX · TERMINAL
codex mcp add woopsocial --url https://api.woopsocial.com/mcp
codex mcp login woopsocialChatGPT
Copy your MCP link from your API Key page (https://app.woopsocial.com/api-access) — it is https://api.woopsocial.com/mcp?api_key=<YOUR_API_KEY> with your key in place, so ChatGPT connects with that key rather than the OAuth sign-in
In ChatGPT open Settings → Apps and enable Developer Mode
Select Create App and enter Name: WoopSocial, MCP Server URL: the MCP link you copied, Authentication: No Auth
Notion
Settings → Connections → + Add Custom MCP, enter your MCP Server URL and name it “woopSocial”, then complete the OAuth flow
Gemini CLI
GEMINI CLI · JSON
{
"mcpServers": {
"woopsocial": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.woopsocial.com/mcp"
]
}
}
}Cursor
Open the Cursor section of WoopSocial's own MCP docs, https://docs.woopsocial.com/mcp/integrating-clients#cursor, and follow its link to WoopSocial's Cursor Directory page
Click “Add to Cursor”
Run through the authorization sequence
