Ravenpost
Schedule and publish posts to Instagram, TikTok, X, LinkedIn, Facebook, Telegram, Threads, Bluesky and YouTube — previewing each one exactly as the network will render it.
Documentation
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 and YouTube. 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
21 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. |
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.