# Ravenpost

**Category:** 🌐 Social Media  
**Repository:** https://github.com/target1m/ravenpost-mcp  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/ravenpost-2

## Description
Schedule and publish social posts to Instagram, TikTok, X, LinkedIn, Facebook, Threads and more.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "ravenpost": {
    "command": "npx",
    "args": ["-y","ravenpost-2"]
  }
}
```

## Documentation & 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.

