Model Context Protocol

Let your assistant hold the calendar. You keep the final say on what goes out.

Postonus is an MCP server. Add it as a connector in Claude Desktop, Cursor, or ChatGPT and your assistant can list your channels, read the queue, and stage a scheduled post — through the same code the dashboard runs on. There is no API key to paste and no config file to hand-edit.

Connect your assistant

Works on every plan. Approve it in the browser.

How it works

MCP server, step by step.

  1. 1

    Open connector settings

    In Claude Desktop: Settings → Connectors → Add custom connector.

  2. 2

    Paste the URL

    https://app.postonus.com/api/mcp — no trailing slash.

  3. 3

    Approve in the browser

    Sign in to Postonus and approve. OAuth, so no key is copied anywhere.

  4. 4

    Ask it something

    “What is in my Postonus queue this week?” is the fastest way to check it worked.

Capabilities

What you get with MCP server.

Five tools, not a wrapper around one
list_channels, list_queue, get_best_times, schedule_post, and reschedule_post. Enough for an assistant to answer questions about your calendar and act on it, without a generic HTTP escape hatch.
Writes stage, they do not publish
schedule_post creates a scheduled post you can still move, edit, or delete. An assistant cannot push something live the moment it decides to, which is the failure mode worth designing against.
OAuth, not a pasted key
You approve the connection in a browser and the grant is recorded against your account. Revoke it from the dashboard and the assistant loses access immediately.
The same limits as the dashboard
Plan caps are enforced inside the services, not per surface. An assistant hitting your monthly cap for a platform gets a message naming the limit and your plan, exactly as the composer would.

What the assistant can actually do

Five tools, each mapping to something the dashboard already does:

ToolWhat it does
list_channelsYour connected accounts, and whether each one is healthy
list_queueUpcoming scheduled posts
get_best_timesRecommended posting windows for a set of platforms
schedule_postStages a scheduled post — never publishes on the spot
reschedule_postMoves an already-scheduled post to a new time

That list is deliberately short. An assistant with a generic "call any endpoint" tool is hard to reason about and harder to trust; five named tools mean the set of things it can do to your calendar is something you can read in one sitting.

Why writes stage instead of publishing

An assistant that can publish is an assistant that can publish the wrong thing at 2am, to the wrong channel, with no undo. Social platforms do not have a real edit-after-post story, so the damage is permanent.

So schedule_post always produces a scheduled post. It lands on your calendar, it shows up in the dashboard queue, and you can move it or delete it right up to the publish time. If you asked for something in ten minutes, you have ten minutes.

Revoking access is one click in the dashboard. The OAuth grant records which client connected and under what name, so a connector you set up months ago on a machine you no longer use is visible rather than invisible.

Setting it up in Cursor and ChatGPT

Both follow the same shape as Claude Desktop: find the custom connector or MCP server setting, give it the endpoint, and approve in the browser when it opens.

https://app.postonus.com/api/mcp

No JSON config to edit, and nothing to keep in sync when a token rotates. The dashboard's AI Assistants page lists what you have connected and how much each one is being used, which is usually the fastest way to confirm a new connector took.

What it does not do

Being straight about the edges, since finding them by trial is annoying:

  • No media upload. Attaching images or video is the CLI's job (postonus media upload) or the dashboard's.
  • No channel connecting. Adding a social account needs an OAuth hop, which belongs in a browser.
  • One workspace at a time. It follows your default. Agencies running a workspace per client switch defaults rather than pointing one assistant at several.

If you need any of those from a script, the CLI and API keys cover them.

On "the only one"

Worth saying plainly, because a lot of marketing copy in this category is not: Postonus is not the only scheduler with an MCP server. Buffer, Hootsuite, Metricool, Postiz, and RecurPost all ship one. If you are shopping for MCP alone, you have options.

What we would point at instead is the shape of ours — five tools rather than a thin wrapper, writes that stage instead of publish, and availability on every plan rather than a tier you have to reach first.

Found this useful? Pass it on.

Questions

Frequently asked questions Everything the first evaluation usually needs.

Which assistants can connect?

Anything that speaks MCP over HTTP. Claude Desktop, Cursor, and ChatGPT all take a custom connector URL and follow the same browser approval. The endpoint is https://app.postonus.com/api/mcp.

Can the assistant publish a post immediately?

No. Every write stages a scheduled post, which you can change or delete before it goes out. There is no tool that publishes on the spot.

Which workspace does it use?

Your default workspace. To point an assistant at a different one, change your default in Settings first — the connection follows it.

Do I need a paid plan?

The MCP server is available on every plan. Creating a live schedule needs a subscription, so on a free workspace the assistant can read your channels and queue and stage dated drafts, but publishing stays gated.

Is there a way in for server-to-server callers?

Yes. The same MCP endpoint accepts an API key as an x-api-key header, which suits a script or a cron job that would rather speak MCP directly than shell out to the CLI.

It is not connecting. What should I check first?

Three things, in order: the URL has no trailing slash; your account has a default workspace set (open the dashboard once and pick one); and, if scheduling specifically fails, whether you have hit your plan’s monthly cap for that platform.

Keep reading

Connect your assistant

Works on every plan. Approve it in the browser.