Model Context Protocol

Run your social workspace
from your AI assistant

Connect Octopost to Claude, ChatGPT, Cursor or any MCP client. Ask about your analytics, review what is scheduled, and draft posts in plain language — using the same permissions and approval rules as the app.

Connect in one step

The server URL is the same everywhere. Your client walks you through signing in to Octopost and picking the workspace it may access.

https://octopost.ai/mcp

Claude Code

Run this in your terminal:

claude mcp add --transport http octopost https://octopost.ai/mcp

Claude Desktop

Settings → Connectors → Add custom connector, then paste the server URL above. A browser window opens for you to sign in and choose a workspace.

ChatGPT

Settings → Connectors → Create, paste the server URL, and authorize when prompted. Requires a plan where custom connectors are available.

Cursor & others

Any client that supports remote MCP over HTTP with OAuth works. Point it at the server URL — discovery and sign-in are handled for you.

Publishing immediately is off until you turn it on

A connected assistant can draft, schedule, edit and cancel posts out of the box. It cannot publish straight to your social accounts — a published post reaches real followers and Octopost cannot take it back.

If you want that, enable Allow publishing immediately for that specific client in Settings → API → App Clients. Turn it back off at any time; existing connections respect the change on their next request.

What you can ask for

Fourteen tools, grouped by the permission they need. Your assistant only sees the ones you granted.

Workspace & accounts

workspace:read, accounts:read

Which workspace am I in, and which social accounts are connected? Flags accounts that need reconnecting.

Reading posts

posts:read

List what is scheduled, drafted or published, filter by platform and date, and open one post in full.

Writing posts

posts:write

Create drafts, edit them, reschedule, cancel, and delete. New posts are drafts unless you give a time.

Media

media:read, media:write

Browse the media library and pull in an image or video from a public URL. File uploads stay in the Octopost app.

Analytics

analytics:read

Followers, impressions, reach and engagement over a period, day-by-day trends, top posts and audience demographics.

Good to know

One connection, one workspace

The workspace you pick when authorizing is the only one that connection can touch. To work in another workspace, add a second connection and authorize it separately.

Approvals still apply

If your workspace requires editor approval, posts an editor creates through MCP land in the approval queue just as they would in the app. Approving is done by a person, in Octopost.

Your plan limits still apply

MCP uses the same API access and monthly scheduling limits as the REST API. If a limit is reached, your assistant is told why and what to do about it.

You can revoke it instantly

Delete the client in Settings → API → App Clients and every open session stops working on its next request.

No file uploads

Tool calls carry JSON only, so a file cannot travel over the protocol. Upload media in Octopost, or have your assistant import it from a public URL.

Building your own integration instead? The REST API reference covers the same capabilities over plain HTTP.