RepeatPost MCP server

---

Overview

RepeatPost MCP is a remote, hosted Model Context Protocol server. Add one URL to your AI assistant, sign in to RepeatPost in your browser, and choose what the assistant may do. It then works with the channels connected to your RepeatPost workspace and stays within your workspace role.

There is nothing to install or run. This repository holds the server's public metadata and documentation, not its source code. The server itself runs at https://api.repeatpost.com/mcp.

Connection details

Setting	Value
Server URL	https://api.repeatpost.com/mcp
Transport	Streamable HTTP
Authentication	OAuth 2.1 with dynamic client registration and PKCE. No API keys, client IDs or headers to copy.
Permissions	Five OAuth scopes, each one chosen by the user on the consent screen
Tools	35 (see MCP tools)
Platforms	15 (see Supported social media platforms)
MCP Registry name	com.repeatpost/mcp
Support	support@repeatpost.com

Key features

• Publish to 15 platforms. Create drafts, schedule, publish, edit and reschedule posts on any connected channel. Send one post to several channels at once as a post group, with a status for each channel and a retry for the failed ones.
• Captions in your brand voice. The assistant writes ready-to-publish captions in the brand voice that applies. Each caption costs 1 AI credit.
• Branded graphics without an image model. The assistant designs a layout as SVG and RepeatPost renders it to a PNG, using your brand colours and logo. It can also add your logo to a photo.
• Media library. Search, browse, upload, organise, rename, favourite and delete files and folders.
• Workspaces and brand voices. List and switch workspaces, see which brand voice applies, and set the default one.
• You choose the permissions. Five OAuth scopes, each with its own checkbox on the consent screen. The workspace role is always the ceiling, and channel approvals still apply.
• Standard MCP sign-in. OAuth 2.1 with dynamic client registration and PKCE. Credentials never pass through the AI client or the model.
• Annotated tools. Every tool carries MCP tool annotations, so clients can ask before running destructive ones.

What it doesn't do

• AI images and videos. Create them in the RepeatPost app, then ask your assistant to schedule them from the media library.
• Connecting channels. Connect social channels in the RepeatPost app.
• Accounts and billing. Create an account and change plans in the RepeatPost app.

Supported social media platforms

An assistant can publish to any channel connected in RepeatPost, on 15 platforms:

Platform	Group	Notes
Facebook	Social networks	Pages, groups and profiles
Instagram	Social networks
LinkedIn	Social networks	Profiles and pages
X (Twitter)	Social networks
Threads	Social networks
Bluesky	Social networks
Mastodon	Social networks
YouTube	Video and visual
Pinterest	Video and visual	Boards: listPinterestBoards, createPinterestBoard
Dribbble	Video and visual
Google Business Profile	Business, chat and blogs
Telegram	Business, chat and blogs
Slack	Business, chat and blogs	Channels: listSlackChannels
Discord	Business, chat and blogs	Channels: listDiscordChannels
WordPress	Business, chat and blogs	Post types, categories and tags: listWordPressPostTypes, listWordPressCategories, listWordPressTags

MCP tools

The server exposes 35 tools in seven groups. tools.json holds the full tools/list output: names, titles, descriptions, input schemas and MCP tool annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint). The Scope column refers to the OAuth scopes.

Channels

Tool	What it does	Scope
integrationList	List connected channels with platform, name, status, character limit and remaining posting capacity	mcp:read
integrationSchema	Get a platform's posting rules: character limits, supported media and per-post settings	mcp:read
listPinterestBoards	List the boards of a connected Pinterest account	mcp:read
createPinterestBoard	Create a board on a connected Pinterest account	mcp:write
listWordPressPostTypes	List the post types of a connected WordPress site	mcp:read
listWordPressCategories	List the categories of a connected WordPress site	mcp:read
listWordPressTags	List the tags of a connected WordPress site	mcp:read
listSlackChannels	List the channels of a connected Slack workspace	mcp:read
listDiscordChannels	List the channels of a connected Discord server	mcp:read

Posts

Tool	What it does	Scope
schedulePost	Create a draft or schedule a post, on one channel or on several at once as a post group	mcp:write for drafts, mcp:publish to schedule
listPosts	List posts by status, channel and date range	mcp:read
getPost	Get one post with its full content, channel, schedule time and status	mcp:read
updatePost	Edit, reschedule or publish a draft or scheduled post	mcp:write, or mcp:publish to schedule or publish
deletePost	Delete a post from RepeatPost, and optionally from the platform	mcp:delete
getPostGroup	Get a post group: one post sent to several channels, with each channel's status	mcp:read
deletePostGroup	Delete the unpublished posts of a post group	mcp:delete
publishPostGroup	Publish a post group now on every channel	mcp:publish
retryPostGroup	Put the failed posts of a post group back in the queue	mcp:publish

Media library

Tool	What it does	Scope
mediaList	Search files across the whole media library by name, type and favourite status	mcp:read
mediaBrowse	Browse the media library one folder at a time	mcp:read
mediaUpload	Upload a file from a public URL or from base64 data	mcp:write
folderCreate	Create a media folder	mcp:write
mediaRename	Rename a file or folder, or change a file's caption	mcp:write
mediaMove	Move files and folders into another folder	mcp:write
mediaDelete	Delete files and folders	mcp:delete
mediaFavorite	Toggle the favourite flag on files and folders	mcp:write

Branded graphics

Tool	What it does	Scope
renderGraphic	Render an SVG design to a PNG and save it to the media library	mcp:write
brandImage	Add the brand logo, and optionally a frame or caption band, to an image and save it as a new file	mcp:write

Brand voice

Tool	What it does	Scope
listBrandVoices	List the workspace's brand voices	mcp:read
getBrandVoice	Show which brand voice applies and why, with its colours, logo and visual style	mcp:read
setDefaultBrandVoice	Make a brand voice the workspace default	mcp:write

AI captions

Tool	What it does	Scope
generateCaption	Write a ready-to-publish caption in the brand voice that applies. Uses 1 AI credit.	mcp:ai

Workspaces and credits

Tool	What it does	Scope
listWorkspaces	List the workspaces the user can access	mcp:read
switchWorkspace	Switch the active workspace for the rest of the session	mcp:read
creditsBalance	Get the AI credit balance and the cost of each AI action	mcp:read

These tools are marked destructiveHint: true, so clients can ask the user before running them: updatePost, deletePost, deletePostGroup, publishPostGroup, mediaRename, mediaDelete and setDefaultBrandVoice.

Graphic sizes and fonts

No AI image model is involved. The assistant designs the layout as SVG, and RepeatPost renders it to a PNG in the media library.

Size	Pixels
Square	1080x1080
Portrait	1080x1350
Story	1080x1920
Landscape	1200x628
Wide	1920x1080

Text can be set in Inter, Montserrat, Poppins, Playfair Display or Roboto, and the design can use the colours and logo from the workspace's brand voice. brandImage puts the brand logo on a photo from the media library and saves a new copy, so the original never changes.

AI credits

Only captions cost AI credits. Everything else is free.

Action	AI credits
Writing a caption (generateCaption)	1
Branded graphics and logos on photos	Free
Scheduling, publishing and editing posts	Free
Media library actions	Free

Installation and setup

There is nothing to install. You add the server URL to your AI client and sign in.

Before you connect

• You need a RepeatPost account.
• Connect your social channels in the RepeatPost app first. An assistant can only use channels that are already connected.

Connect in four steps

1. Add https://api.repeatpost.com/mcp as a remote MCP server in your client. See Client configuration.
2. Sign in to RepeatPost on the page your client opens in the browser.
3. On the consent screen, untick anything you don't want to allow, then approve. See Permissions (OAuth scopes).
4. Ask your assistant to do something, for example one of the example workflows.

Authentication and OAuth

The server uses the standard MCP authorization flow. Credentials never pass through the AI client or the model: the user signs in on RepeatPost's own page in their browser, and the client receives OAuth tokens.

1. An unauthenticated request to /mcp returns 401 with a WWW-Authenticate header that points to the protected resource metadata.
2. The client reads the metadata, registers itself (RFC 7591 dynamic client registration) and opens the authorization page in the browser.
3. The user signs in, reviews the consent screen and approves.
4. The client exchanges the authorization code for tokens (PKCE S256) and calls /mcp with Authorization: Bearer <access_token>.

Endpoint	URL
Protected resource metadata	https://api.repeatpost.com/.well-known/oauth-protected-resource
Authorization server metadata	https://api.repeatpost.com/.well-known/oauth-authorization-server
Client registration	https://api.repeatpost.com/auth/oauth/register
Authorization	https://api.repeatpost.com/auth/oauth/authorize
Token	https://api.repeatpost.com/auth/oauth/token
Revocation	https://api.repeatpost.com/auth/oauth/revoke

Detail	Value
PKCE	Required, S256 only
Client authentication	none (public clients) or client_secret_post
Access token lifetime	15 minutes
Refresh token lifetime	30 days, rotated on every refresh
Two-factor authentication	Supported on the sign-in page

The scopes a token can carry are listed under Permissions (OAuth scopes).

Client configuration

Claude (web and desktop)

1. In Claude, open Settings, then Connectors, and select Add custom connector.
2. Paste https://api.repeatpost.com/mcp and select Connect.
3. Sign in to RepeatPost on the page that opens.
4. On the consent screen, untick anything you don't want to allow, then approve.

Claude Code

claude mcp add --transport http repeatpost https://api.repeatpost.com/mcp

Then run /mcp in Claude Code, select repeatpost and authenticate in your browser.

Cursor

Add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "repeatpost": {
      "url": "https://api.repeatpost.com/mcp"
    }
  }
}

VS Code

Add this to .vscode/mcp.json:

{
  "servers": {
    "repeatpost": {
      "type": "http",
      "url": "https://api.repeatpost.com/mcp"
    }
  }
}

Cline

In Cline, open MCP Servers, then Remote Servers. Enter repeatpost as the name and https://api.repeatpost.com/mcp as the URL, choose Streamable HTTP, and select Add Server. Then select Authenticate and sign in to RepeatPost in your browser.

To edit cline_mcp_settings.json instead, add this. Keep "type": "streamableHttp": without it, Cline uses the legacy SSE transport and can't connect.

{
  "mcpServers": {
    "repeatpost": {
      "type": "streamableHttp",
      "url": "https://api.repeatpost.com/mcp",
      "disabled": false,
      "autoApprove": []
    }
  }
}

llms-install.md has step-by-step instructions for AI agents such as Cline that install the server themselves.

Clients that only support stdio

Use mcp-remote as a bridge:

{
  "mcpServers": {
    "repeatpost": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.repeatpost.com/mcp"]
    }
  }
}

Any other MCP client

Any client that supports remote MCP servers with OAuth sign-in can connect. Add a remote server with the URL https://api.repeatpost.com/mcp and sign in when asked.

Example workflows

• "Schedule a post about our weekend sale to Instagram and LinkedIn for Friday at 9am."
• "Make a square post announcing our 20% weekend sale in our brand style and save it as a draft."
• "Add our logo to the summer product photo in my media library."
• "What's scheduled for next week, and did any posts fail?"
• "Write three LinkedIn captions about our new feature in our brand voice."

Agent skill

The repeatpost-social-media-manager skill teaches AI agents how to use these tools well. It covers finding the right channel, staying within each platform's limits, converting times to UTC, reporting only real results, and asking before anything that schedules, publishes or deletes.

The skill folder has three parts, all installed together:

Part	Contents
SKILL.md	The rules and workflows the agent follows
references/	Details the agent opens only when needed: every tool with its permission, platform requirements, and the rules for graphics
evals/	Tests for whoever changes the skill: 8 behaviour scenarios and 20 checks of when the skill should load. Agents don't load them

Install it in Claude Code, Cursor, Codex, Cline and other agents that support Agent Skills. The skills CLI needs Node.js 22.20 or later:

npx skills add repeatpost/repeatpost-mcp

Installing the skill doesn't connect RepeatPost. Add the MCP server and sign in separately (see Client configuration). The skill is listed on skills.sh, and it's also included in the Cursor plugin.

GitHub Copilot

GitHub Copilot supports Agent Skills in Copilot CLI, the Copilot cloud agent, and agent mode in VS Code, Visual Studio and JetBrains IDEs. Install the skill with GitHub CLI 2.90 or later. gh skill is in preview, and installs for Copilot by default:

# For the current project
gh skill install repeatpost/repeatpost-mcp repeatpost-social-media-manager

# For all your projects
gh skill install repeatpost/repeatpost-mcp repeatpost-social-media-manager --scope user

To review the skill before installing it, run gh skill preview repeatpost/repeatpost-mcp repeatpost-social-media-manager. To get later versions, run gh skill update. With the skills CLI, the install command is npx skills add repeatpost/repeatpost-mcp --skill repeatpost-social-media-manager -a github-copilot.

Copilot also needs the RepeatPost MCP server. In VS Code, add it as shown under VS Code, then ask Copilot in agent mode, for example "Show my RepeatPost channels."

This is Agent Skills support: Copilot loads the skill from your installation. RepeatPost isn't listed in a GitHub or Copilot marketplace.

Tool permissions and security

Permissions (OAuth scopes)

The consent screen lists five permissions, each with its own checkbox. A token carries only the scopes the user approved.

Scope	Shown on the consent screen as	Allows
mcp:read	View your workspaces, channels, posts, media and credits	Looking things up. Changes nothing on its own.
mcp:write	Create and edit drafts, media, folders and brand voice settings	Preparing work: drafts, uploads, folders, graphics and brand voice changes
mcp:publish	Schedule and publish posts to your channels	Putting posts on the schedule or publishing them now
mcp:delete	Delete posts and media	Removing posts and media
mcp:ai	Generate captions (uses your AI credits)	Writing captions. Each caption costs 1 AI credit.

Two rules apply whatever the user approves:

• The workspace role is the ceiling. An assistant can never do more than the user's role allows. A Viewer can only read.
• Approvals still apply. If posts on a channel need approval, posts scheduled there by an assistant go to approval first.

Security and privacy

• Sign-in happens on RepeatPost's own page. The assistant never sees the user's password.
• Each token carries only the permissions the user approved, and never more than the user's workspace role.
• By default, deleting a post removes it from RepeatPost only. Deleting it on the platform as well needs an explicit request from a workspace Owner.
• To disconnect, remove the RepeatPost connector in your assistant's settings, or email support@repeatpost.com to have its access revoked.

Read AI assistants and connectors in the RepeatPost Privacy Policy, and the Terms of Service.

To report a security issue, follow SECURITY.md or email support@repeatpost.com.

Troubleshooting

Problem	What to do
The client asks you to sign in, or reports 401	This is how sign-in starts. Finish signing in on the RepeatPost page in your browser. In Claude Code, run /mcp, select repeatpost and authenticate.
You are asked to sign in again after a long break	Refresh tokens last 30 days and are rotated on every refresh. After 30 days without use, sign in again.
A channel is missing	Connect it in the RepeatPost app. An assistant can only use channels that are already connected.
An action is refused for permissions	The scope wasn't approved on the consent screen, or your workspace role doesn't allow it (a Viewer can only read). Reconnect and approve the scope, or ask a workspace Owner.
A scheduled post went to approval	The channel needs approval, and posts scheduled there by an assistant go to approval first.
Captions aren't being written	Each caption costs 1 AI credit. Ask your assistant for your credit balance.
A post was deleted in RepeatPost but is still on the platform	This is the default. Deleting it on the platform as well needs an explicit request from a workspace Owner.
Your client only supports stdio servers	Use mcp-remote as a bridge. See Clients that only support stdio.
You want to disconnect	Remove the RepeatPost connector in your assistant's settings, or email support@repeatpost.com to have its access revoked.

Directory listings

RepeatPost is listed in these MCP directories:

Directory	Listing
Official MCP Registry	com.repeatpost/mcp
Glama	glama.ai/mcp/connectors/com.repeatpost/mcp
Smithery	smithery.ai/servers/info-342p/repeatpost
mcp.tc	mcp.tc/i/repeatpost
MCPBundles	mcpbundles.com/skills/repeatpost-mcp
skills.sh (agent skill)	skills.sh/repeatpost/repeatpost-mcp

Support

• Documentation: help.repeatpost.com/integrations/mcp-server
• MCP server page: www.repeatpost.com/mcp
• Website: www.repeatpost.com
• Email: support@repeatpost.com
• Bugs and tool requests: GitHub issues
• Security: SECURITY.md

See SUPPORT.md for what to include when you ask for help.