Social

Tools in the social scope, callable over space-mcp (tools/call) or space-api (REST) with a wks_live_* key that grants social.

create_social_draft

Scope: social:write

Create a DRAFT (or scheduled) social post in the Social Manager — does NOT publish. Requires text; optional platforms (names), media_urls, schedule_time. Publish it with publish_social_post.

get_social_analytics

Scope: social:read

Get social analytics. Omit post_id for account-level; pass post_id for a single post.

list_social_accounts

Scope: social:read

List social accounts connected to this space (platform, name, username).

list_social_planners

Scope: social:read

List the space's social posting planner templates and slots.

list_social_posts

Scope: social:read

List this space's social posts (drafts, scheduled, published, failed) from the Social Manager. Optional status filter ('draft'|'scheduled'|'published'|'failed') and limit. Use this to see the draft/post queue instead of guessing.

publish_social_post

Scope: social:run

PUBLISH or schedule a social post live (consequential). Requires text and platforms ([{platform, accountId}] from list_social_accounts). Optional media_urls, schedule_time.