Developer documentation

MCP tools

Tools and required scopes

The list below comes from tool definitions in the code. Public MCP access is still unverified. Tools outside an approved scope are hidden.

list_accounts

accounts:read

List connected accounts · Call before publishing to find connected account IDs and their platforms.

list_platforms

accounts:read

List platform rules · Check platform availability and verified text and media rules.

validate_post

posts:read

Validate a post · Check every selected platform without saving a post. Return all rule violations together.

get_post

posts:read

Get a post · Read a post's status, per-account result, and available engagement metrics.

list_posts

posts:read

List posts · Read this workspace's post history using filters and a cursor.

media_upload_status

posts:read

Check media upload · Check whether media verification is complete. Attach it only when ready is true.

get_quota

posts:read

Get remaining quota · Read this workspace's monthly usage and per-platform daily limits.

publish

posts:write

Publish or schedule a post · Publish to connected accounts now, schedule a post, or save a draft. With wait=true, wait up to 10 seconds for text or 60 seconds for media. Reuse the idempotencyKey when retrying the same request.

update_post

posts:write

Update a draft or scheduled post · Change content, accounts, media, platform options, or scheduled time before publishing.

delete_post

posts:write

Delete a post · Remove a draft or scheduled post, or request deletion from each platform for a published post. This cannot be undone.

retry_post

posts:write

Retry failed targets · Revalidate and retry only targets with a confirmed temporary failure.

media_upload_link

posts:write

Create a media upload link · Create a 30-minute browser upload link for supported images. Check the returned sessionId with media_upload_status.

media_from_url

posts:write

Import media from a URL · Fetch an image from a public HTTPS URL, verify it server-side, and return a media ID for a post.

list_webhooks

webhooks:read

List customer webhooks · List this workspace's webhook subscriptions without revealing signing secrets.

manage_webhook

webhooks:write

Manage a customer webhook · Create, edit, pause, resume, or revoke a webhook, or rotate its signing secret. Confirm with the user before revoke because it cannot be undone. The new secret is shown only in the first successful response.

list_queue_slots

posts:read

List queue slot rules · Read this workspace's recurring schedule rules, including paused and revoked states.

manage_queue_slot

posts:write

Manage a queue slot rule · Create, edit, pause, resume, or revoke a recurring schedule rule. Confirm with the user before revoke because it cannot be undone. Use queueSlot=true in publish to schedule a post.