Skip to main content
Glama
Ravenpost MCP server

Ravenpost MCP server

by target1m

Ravenpost

Schedule and publish social media posts from Claude. Ravenpost is a social media scheduler for content creators, influencers and agencies: write a post once, send it to Instagram, TikTok, X, LinkedIn, Threads, Bluesky, YouTube, Pinterest and Telegram, and see how each network will show it before anything goes out.

This plugin connects Claude to Ravenpost's hosted MCP server and adds four skills that teach Claude the workflow around it: settle the workspace and the accounts, preview before writing anything, and publish or schedule only after you say yes to the accounts, the caption and the time — and Ravenpost itself holds every publish until you confirm it.

What you can do

  • Preview a post as every network will show it, before anything is created, with a warning for anything a network would reject: a caption over X's 280 characters, a post with no media where one is required, a Pinterest pin with no board.

  • Draft, schedule, queue or publish to one account or several at once — at a time you name, or in the next free slot of your weekly posting queue.

  • Edit, reschedule or cancel posts that have not gone out yet, and check how a published post landed on each account.

  • Bring in images and video from a link, and reshape one image into each network's format.

  • Read followers and engagement for the accounts each network lets Ravenpost measure.

Related MCP server: so-easy-mcp

Getting started

  1. Create a Ravenpost account at ravenpo.st — the free plan is enough to try it — and connect your social accounts in the dashboard. Connecting a social account happens there, not in Claude.

  2. Add the plugin, then connect Ravenpost from its Connectors tab and sign in when asked. There is no API key to copy: the server uses OAuth.

  3. Ask Claude, for example:

    • "Preview a launch post for my Instagram and X accounts before anything is posted."

    • "Schedule the LinkedIn version for Tuesday at 9am."

    • "Put this in the queue for all my accounts."

    • "What's scheduled for next week, and did yesterday's post go out everywhere?"

    • "How are my accounts doing — followers and engagement on recent posts?"

Skills

Skill

What it teaches Claude

publish-a-social-post

Settle the workspace, pick the accounts, collect what each destination requires, preview before writing, and wait for your yes before anything is published or scheduled — publishing is the one step that cannot be taken back

manage-scheduled-posts

Find, edit, move, cancel and check posts — including that editing resets a post to a draft, and that deleting removes Ravenpost's copy rather than the live one

prepare-post-media

Getting files in, the canvases each network wants, cutting one image for several networks, and the media rules a post actually fails on

measure-and-time-posts

Reading analytics without turning "not collected" into a zero, and answering "when should I post?" without inventing a measured hour

Data and privacy

The plugin runs nothing on your computer. Its skills are written instructions, and its one connector is Ravenpost's hosted server at https://api.ravenpo.st/mcp. When Claude calls a tool, the request — captions, links to media, the accounts you choose, the times you set — goes to Ravenpost under your own sign-in, and Ravenpost posts to the networks you selected when you publish or when a scheduled time arrives.

One other destination, and only for a file you hand over: a large image or video can go straight into Ravenpost's own storage, a Cloudflare R2 bucket (*.r2.cloudflarestorage.com), through a one-time upload link the connector issues (create_media_upload), so its bytes never pass through the conversation. Nothing is sent anywhere else.

Ravenpost keeps your posts and media until you delete them, and a connected account until you disconnect it; deleting your Ravenpost account erases all of it. Privacy policy: https://ravenpo.st/privacy/.

Good to know

  • Nothing is published on Claude's word. A post you ask to publish now — or to schedule less than 15 minutes ahead — waits for you: press Publish on the post card in the chat, or confirm it on the post in Ravenpost. A published post cannot be taken back through Ravenpost on Instagram, TikTok, Threads or YouTube, and deleting a post in Ravenpost never removes it from a network, so that click is yours. A schedule further ahead goes out by itself, so Claude shows you the accounts, the caption and the time and schedules it only when you say yes. Drafts stay in your workspace.

  • Account names, other posts' captions, analytics, a page Ravenpost screenshots and a tool's warnings are written by somebody other than you. The skills tell Claude to read them as data and never to follow an instruction found in them.

  • Ravenpost does not write captions or generate images. The words and the files come from you or from Claude, and media is brought in from a link you give.

  • Some networks report no numbers to Ravenpost. Those are shown as not collected, never as zero.

  • With several workspaces — one per client, on the Agency plan — Claude asks which one to use rather than guessing, so one client's post never lands on another's accounts.

Tools

26 tools, and one more that only the post card calls (below). Every one declares a title and read-only / destructive / open-world 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

Posts 50 at a time — newest first, or soonest first when filtered to scheduled — optionally filtered by status, with the total that matches.

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. A publish — now, or less than 15 minutes ahead — waits for you to confirm it.

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. Never takes a live post down from a network.

schedule_post

Move a post to a new time. A time less than 15 minutes ahead waits for your confirmation.

publish_post

Ask to publish a post now. Nothing goes out until you confirm it — Publish on the post card, or on the post in Ravenpost.

The post card's Publish button calls confirm_publish, which releases a publish you just confirmed. It is registered for the card alone: clients that show MCP Apps keep it out of Claude's tool list, and it acts only on a one-time code the card is given with the post.

Media

Tool

What it does

upload_media

Upload an image or video from a URL or base64 (a local path too, on a development server only); 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 — a number a platform doesn't report is absent, never a zero.

Studio

Tool

What it does

list_video_templates

The video templates create_video renders — a storyboard told in scenes, and the fixed app showcase, feature list, announcement and milestone — with the fields each reads, what each scene takes and what a video and a screenshot cost in credits.

create_video

Lay out the workspace's own pictures, clips and words as a short branded video (9:16, 1:1 or 16:9) saved to the media library as an mp4, ready for a post: a storyboard of up to ten scenes and 30 seconds with an optional music bed from Ravenpost's own three tracks, or a fixed template. No generative model draws or composes anything. Waits and reports progress; returns the render's id when it needs longer.

get_video

Check a render's progress, or wait for it, and get the media id once it is ready.

capture_screenshot

Screenshot a web page on a desktop and a phone into the media library — shots for a video, or pictures for a post.

import_app_screenshots

Copy an app's App Store or Google Play screenshots and icon into the media library, free of credits.

Reference

Tool

What it does

list_audio

Search Instagram's licensed audio catalog for a reel track — Instagram accounts connected through a Facebook Page only.

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, posting rules and recommended specs per platform.

Other ways to connect

The server is hosted; there is nothing to install or run.

https://api.ravenpo.st/mcp

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

Claude's Connectors Directory. Ravenpost is listed there — https://claude.ai/directory/ravenpost — so in Claude on the web, the desktop and mobile it is Connect and a sign-in, with nothing to paste.

OAuth (recommended). Add the URL above as a custom connector in any client that speaks MCP authorization — Claude, ChatGPT, Cursor, VS Code — and sign in when it 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 the client runs the whole flow on its own.

Personal access token. For clients with no browser flow. Generate one on the MCP page of the Ravenpost dashboard (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_….

Gemini CLI. This repository is also a Gemini CLI extension: the hosted server and the four skills.

gemini extensions install https://github.com/target1m/ravenpost-mcp

Gemini CLI finds the OAuth sign-in on its own; /mcp auth ravenpost starts it again when it is needed.

Just the skills. The four skills install into Claude Code, Codex, Cursor and the other agents the skills CLI supports. They teach the workflow and the server does the work, so connect the server as above too.

npx skills add target1m/ravenpost-mcp

OpenClaw. OpenClaw saves the server and runs the sign-in itself:

openclaw mcp add ravenpost --url https://api.ravenpo.st/mcp \
  --transport streamable-http --auth oauth --oauth-scope mcp
openclaw mcp login ravenpost

openclaw/ravenpost/SKILL.md is the skill for it: the four skills' workflow in the one-folder shape ClawHub publishes, with those two commands as its setup and the sign-in for a machine with no browser. It is on ClawHub as ravenpost:

openclaw skills install @muratkaragozgil/ravenpost

This repository

Documentation, the registry manifest and the plugin 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.

plugin.json                 portable manifest (Agent Plugins 1.0.0), with the
                            ChatGPT listing and review metadata under
                            extensions.com.openai
mcp.json                    the hosted server, Agent Plugins format, OAuth (DCR)
.claude-plugin/plugin.json  the same identity, for Claude
.mcp.json                   the hosted server, Claude format
.cursor-plugin/plugin.json  the same identity, for Cursor and Grok Bot (server
                            inline, with "placement": "server")
gemini-extension.json       the same identity, for Gemini CLI
skills/<name>/SKILL.md      one workflow each
skills/publish-a-social-post/references/
    tools.md                every tool, its arguments and what it returns
    platforms.md            caption budgets, media rules, per-platform limits
openclaw/ravenpost/SKILL.md the skill for OpenClaw, in the one-folder shape
                            ClawHub publishes (no plugin manifest reads it)
server.json                 the official MCP registry entry
scripts/package.sh          builds the ZIP the ChatGPT plugin portal takes

Both reference files are generated from the server's own tool registrations and platform registry, not transcribed — a skill that describes an argument the server no longer takes is worse than one that says nothing, because the model follows it and the call fails.

Submitting to ChatGPT. OpenAI's plugin portal takes the package as a ZIP (Plugins → Upload plugin). scripts/package.sh builds it from plugin.json, mcp.json, skills/, the licence and the icon the site serves — nothing Claude-only and no credentials (reviewer sign-in goes in the portal's Review details form). The repository keeps no image of its own: the Claude directory holds a plugin for review while one sits beside a script that could reach it. The listing text, the five positive and three negative review cases and the release notes ride in plugin.json, so changing them means a new version and a new ZIP; changes to the hosted tools don't — the portal rescans the server.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    B
    maintenance
    Schedule and manage social media posts across 10 platforms (Instagram, Facebook, TikTok, X, LinkedIn, YouTube, Threads, Pinterest, Bluesky, Telegram) from any MCP-compatible AI assistant. Supports batch posting, media uploads, analytics, and platform-specific features like Reels, Shorts, and carousels.
    11
    412 npm
    7
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    A full social media management MCP server enabling post, read, schedule, and analyze across Facebook, Instagram, LinkedIn, X/Twitter, Pinterest, and YouTube from any MCP-compatible AI client.
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    MCP server to manage social media accounts from AI assistants, enabling post creation, scheduling, publishing, and media uploads across multiple platforms.
    13
    20 npm
    1
    MIT