deploy.social

npx add-mcp 'https://api.deploy.social/mcp'

What you can do

#

MCP lets an assistant work in one Deploy workspace for you: find your connected accounts, bring in a video or photos, make a draft, post it once you say yes and check how it went. The table lists every tool. A read-only connection sees only the tools that read.

Tool	What it does	Access
list_destinations	Lists the social accounts connected to this workspace: platform, handle, status, the post fields each platform uses, video limits, and the settings (options) a post can choose for it.	Read only
add_media	Brings a video or photo into the workspace.	Read + write
get_media	Checks on a video or photo from add_media.	Read only
create_post	Saves a post as a draft.	Read + write
update_post	Changes a draft.	Read + write
publish_post	Posts a draft, or moves a scheduled post to a new time.	Read + write
list_posts	Lists the workspace's posts, newest first, with where each destination stands and its link once it's live.	Read only
get_post	Shows one post in full: caption, settings, and for each destination its status, its link once it's live, and if it failed, why and what to do about it.	Read only
cancel_post	Deletes a draft, or cancels a scheduled post so it doesn't go out.	Read + write
retry_post	Tries the destinations that failed again and leaves the ones that worked alone.	Read + write

Clients that show prompts get four starting points: "Post a video", "Post photos" and "Post text", which each walk through the whole flow and wait for your yes before posting, and "Check my recent posts", which sums up what went out and what failed.

Connect a client

#

Claude.ai and ChatGPT sign in to Deploy with one click. Claude Code, Cursor and VS Code use a workspace API key. Pick your app below.

In Claude, open Customize → Connectors, choose Add custom connector and paste this URL. On a Team or Enterprise plan, an owner adds it first in Organization settings → Connectors, then each member connects. Sign in to Deploy when asked, then pick one workspace and choose read-only or read and write access.

https://api.deploy.social/mcp

The two URLs sign in differently. /mcp is for apps that sign in to Deploy; /v1/mcp takes an API key and nothing else. Use the key URL in code editors and scripts, because some of them drop your Authorization header when a server also offers sign-in.

Review before posting

#

create_post only saves a draft. publish_post tells the assistant to check the destinations, caption and time with you before it posts anything. Afterwards, get_post shows how each destination went.

create_post takes a kind of video (the default, with a media_id), photos (a media list of 1 to 35 photos in order, each with an optional alt_text) or text (just a caption). On X, Bluesky and Threads, a destination's thread option turns a long text post into a thread. update_post changes a draft's fields but not its kind, and for photos media replaces the whole list. YouTube takes video only, and a destination that can't take the kind you chose is refused.

A landscape video needs a decision before it goes to Facebook Reels, YouTube Shorts or TikTok, and so does a square one for Facebook Reels. get_media shows its orientation. If you leave out vertical_fit, create_post and publish_post fail with a video_needs_vertical_fit detail whose options say what to do: send vertical_fit as blur (the video over a blurred copy of itself) or bars (black above and below), or leave those destinations out. Ask the person which they want. X, Threads and Bluesky always get the original.

For a video that is online, give the assistant a public HTTPS link straight to the file. For one on your computer, add_media returns an upload command to run where the file is. Photos (JPEG, PNG or WebP, up to 30 MB) come from a file, not a link.

Manage connections

#

Account → API lists your connected apps and keys. You can revoke either there. Deploy emails you when a new app connection is made.

API getting started Make a key and learn the same media and post flow over REST.API limits See the allowances shared with MCP.