Ravenpost

Ravenpost MCP server

Schedule and publish social media posts from an AI assistant.

Ravenpost is a multi-platform social media scheduler — Instagram, TikTok, X, Telegram, Facebook, LinkedIn, Threads, Bluesky, YouTube and Pinterest. This repository documents its hosted MCP server, which exposes the same posting flow to any MCP client: list the accounts you have connected, upload or reshape media, preview a post exactly as each network will render it, then publish it now, schedule it, or drop it into a weekly posting queue.

The server is hosted. There is nothing to install and nothing to run.

https://api.ravenpo.st/mcp

Transport: Streamable HTTP. Official registry entry: st.ravenpo/ravenpost.

Connecting

Two ways, and the first needs no credential handling at all.

OAuth (recommended). Add the URL above as a custom connector and sign in when your client opens Ravenpost. The server is an OAuth resource server — /.well-known/oauth-protected-resource names the authorization server and the 401 carries the challenge — so a client that speaks MCP authorization runs the whole flow on its own.

Personal access token. For clients with no browser flow. Generate one in Ravenpost under Settings → MCP tokens (shown once, revocable at any time):

claude mcp add --transport http ravenpost https://api.ravenpo.st/mcp \
  --header "Authorization: Bearer rvp_your_token"

Clients that cannot set headers can pass it in the URL instead — https://api.ravenpo.st/mcp?token=rvp_….

You need a Ravenpost account with at least one connected social account. The free plan is enough to try it.

Tools

22 tools. Every one declares a title and read-only / destructive hints, so your client can tell you what a call will do before you allow it.

Accounts

Tool	What it does
list_workspaces	Every workspace the credential can act in. With more than one, the other tools require a workspaceId rather than guessing which client you meant.
list_accounts	Connected accounts with their ids, platforms and status.

Posts

Tool	What it does
list_posts	List posts, filtered by status or platform.
get_post	One post with every destination's status and permalink.
preview_post	Render a post as each platform will show it without creating anything — an interactive card in clients that support MCP Apps, and per-platform character counts everywhere else.
create_post	Draft, publish, schedule or queue a post across any set of accounts.
update_post	Edit a draft or scheduled post — resets it to draft, so pass an action to re-send it.
delete_post	Delete the Ravenpost copy and cancel a pending publish.
schedule_post	Move a post to a new time.
publish_post	Publish a post immediately.

Media

Tool	What it does
upload_media	Upload an image or video from a URL, a local path (dev only) or base64; images are reformatted to the platform shape you name.
create_media_upload	Presigned direct upload — for large or production files, so bytes never pass through the model's context.
attach_media	Register a direct upload as an asset, reformatting an image or recording a video as-is.
create_variants	Cut one image into several platform canvases at once, cropping on the subject rather than the middle.
list_media	Recent media assets, to reuse one instead of re-uploading.
image_formats	The image formats and target dimensions upload_media accepts.

Analytics

Tool	What it does
get_analytics	Followers per account and engagement on recent posts.
best_times	Recommended posting hours measured from this workspace's own posts — with an explicit "not enough data yet" answer rather than a confident guess.

Reference

Tool	What it does
list_audio	Search Instagram's licensed audio catalog for a reel track.
list_queue_slots	The weekly posting schedule and the next free slot.
list_boards	The Pinterest boards each connected account owns — a pin has to name one, and Pinterest has no default.
platform_limits	Caption budgets, media rules and recommended specs per platform.

Two things worth knowing

Preview before publish. preview_post writes nothing. It returns the post as each destination renders it, together with the warnings a picture cannot carry: a caption over the tightest selected platform's limit, a network that requires media when there is none, a thread aimed at a platform with no thread model, audio outside a reel. A preview that looks right and stays quiet about a rejection is worse than no preview.

It refuses to guess your workspace. A credential acts as a user, and a user can run several workspaces (one per client, on the Agency plan). Ask a workspace-scoped tool with more than one available and it errors, naming them, rather than posting one client's content to another's accounts.

Links

• Product: https://ravenpo.st/
• What the MCP server does: https://ravenpo.st/mcp/
• Tool reference: https://ravenpo.st/docs/mcp/
• REST API: https://ravenpo.st/docs/api/
• Privacy: https://ravenpo.st/privacy/ · Terms: https://ravenpo.st/terms/
• Support: support@ravenpo.st

About this repository

Documentation and the registry manifest (server.json) for a hosted service. Ravenpost's own source is not public. Issues about the MCP server are welcome here; anything account-specific should go to support.