What Ravenpost does
The Ravenpost MCP server exposes Ravenpost's hosted social publishing service through MCP. It lets an agent work with connected accounts, create or inspect posts, prepare media, schedule content, publish immediately, and read available analytics. Supported destinations listed in the material include Instagram, TikTok, X, LinkedIn, Facebook, Threads, Bluesky, YouTube, Pinterest, and Telegram, although account availability depends on what has been connected in Ravenpost.
The service is intended for creators, influencers, and agencies managing one or more social accounts. Workspaces separate clients or operating contexts. If a credential can access multiple workspaces, the agent must identify the intended workspace before using the other workspace-scoped tools.
How it works
Ravenpost runs the MCP endpoint at https://api.ravenpo.st/mcp using Streamable HTTP. The repository contains documentation, a registry manifest, and a plugin; Ravenpost's service implementation is hosted rather than included for local deployment.
An agent can first inspect workspaces and connected accounts, then preview a proposed post without creating it. Preview results show how destinations will render the content, with an interactive card in clients that support MCP Apps and platform-specific character counts elsewhere. After review, the agent can create a draft, schedule or queue it, or publish it immediately.
Posts can target several accounts at once. A post's destination statuses and permalinks are available through retrieval tools. Editing a draft or scheduled post returns it to draft status, so another action is needed to send it again. Deleting a Ravenpost record cancels a pending publish but does not remove content already live on a social network.
Setup and configuration
Create a Ravenpost account and connect social accounts in the Ravenpost dashboard. Account connections are made there rather than inside the MCP client. Add the hosted endpoint as a custom connector in an MCP client that supports authorization, then complete the OAuth sign-in flow.
For clients without a browser-based authorization flow, generate a personal access token from the Ravenpost dashboard's MCP page. The token can be supplied as a Bearer header; clients that cannot set headers can use the token query parameter described by the service documentation. No local process or required environment variables are specified.
Tools and capabilities
The Ravenpost MCP server provides tools in several groups:
- Account tools list available workspaces and connected accounts.
- Post tools list, retrieve, preview, create, update, delete, schedule, and publish content.
- Media tools accept image or video URLs and base64 data, support direct presigned uploads, attach uploaded assets, reuse recent media, and create platform-specific image variants.
- Reference tools report accepted image formats, platform limits, Pinterest boards, Instagram licensed audio, and available queue slots.
- Analytics tools report followers and recent-post engagement where a platform provides those measurements.
Large or production media can use a direct upload so file bytes do not pass through the model context. Image variants are cropped around the subject rather than simply from the center. The service does not write captions or generate images; those inputs come from the user or agent.
Limitations and notes
The Ravenpost MCP server cannot retract a post from Instagram, TikTok, Threads, or YouTube after publication, and deleting its copy never removes a live network post. Previewing before publication is therefore an important part of the workflow.
Analytics are incomplete when a platform does not report a metric. Ravenpost represents an unavailable value as not collected rather than zero. Pinterest publishing requires a named board because Pinterest has no default board. Instagram licensed-audio search is limited to Instagram accounts connected through a Facebook Page.
A local file path is accepted by the regular media upload tool only on a development server. For large or production files, use the direct upload flow. Ravenpost retains posts and media until they are deleted, and retains connected accounts until they are disconnected. Deleting the Ravenpost account removes its stored data.