Ravenpost
Schedule and publish posts to Instagram, TikTok, X, LinkedIn, YouTube, Pinterest, Facebook & more.
Open source Repository Open in the app JSON README (API)
About
Schedule and publish posts to Instagram, TikTok, X, LinkedIn, YouTube, Pinterest, Facebook & more.
Details
- Kind
- MCP servers
- Topic
- Social & content
- Publisher
- st.ravenpo
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.1.0
- Stars
- 1
- Last push
- 2026-08-30T16:33:49Z
- Repository state
- ativo
- License
- MIT
- Added
- 2026-08-29 04:01:54
- Updated
- 2026-08-30 18:01:02
- Origin id
st.ravenpo/ravenpost
README
# Ravenpost MCP server Schedule and publish social media posts from an AI assistant. [Ravenpost](https://ravenpo.st/) 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`](https://registry.modelcontextprotocol.io/v0/servers?search=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): ```bash 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.