Postoria MCP server is now available for AI agents
Postoria now has an official MCP server, making it easier to connect AI agents and MCP-compatible tools to your social publishing workflow.
The Postoria MCP server works with the Postoria Public API and gives supported AI clients a structured way to understand your workspaces, connected social accounts, queues, media, and posts. Instead of manually copying details between tools, you can let an AI agent prepare parts of the publishing workflow through Postoria while keeping the final action clear and traceable.
You can use the MCP server in two ways. Local desktop clients can run the npm package, and hosted MCP clients can connect to the Postoria hosted MCP endpoint at https://mcp.postoria.io/mcp. The server is open source on GitHub, available as an npm package, and documented in the Postoria MCP server help article.
What is MCP?
MCP, or Model Context Protocol, is a standard way for AI tools to connect to external apps and services.
For Postoria users, this means an AI agent can use Postoria actions through a supported MCP client. For example, it can list your workspaces, find connected social accounts, import media, schedule a post, add a post to a queue, or check a post status.
The goal is not to replace your publishing workflow. The goal is to make Postoria easier to connect with AI-assisted planning, automation, and content operations.
Works with MCP-compatible AI tools
The Postoria MCP server is designed for MCP-compatible clients and agents, including tools such as Claude Desktop, Cursor, Claude Code, and ChatGPT custom apps where MCP support is available.
Local desktop clients can run the server from npm. Hosted MCP support depends on the MCP-compatible client you use and whether it supports custom MCP connections and bearer token authentication.
What the Postoria MCP server can do
The Postoria MCP server focuses on practical publishing workflows.
It supports tools for:
- Listing workspaces
- Listing social accounts in a workspace
- Listing queues in a workspace
- Importing media from a public URL
- Creating a signed media upload URL
- Completing a media upload after file bytes are uploaded
- Uploading local media files from supported desktop MCP clients
- Checking media status
- Publishing posts now
- Scheduling posts
- Adding posts to queues
- Checking post status
- Deleting posts
This gives AI tools a focused set of actions around the core publishing flow: choose a workspace, choose accounts or queues, prepare media, create a post, and check the result.
Built on the Postoria Public API
The MCP server is built on top of the Postoria Public API.
That means it follows the same account-level API key model and the same publishing capabilities available through the API. If you already use the Public API, the MCP server gives AI tools another way to work with those same workflows.
The Public API is available on Pro and Agency plans.
You can learn more in the Postoria Public API help article.
Local and hosted options
The Postoria MCP server can be used locally or through the hosted endpoint.
Local usage is usually the right choice for desktop and IDE tools. A client such as Claude Desktop, Cursor, or Claude Code can run the npm package and use your Postoria Public API key from the local MCP configuration.
Hosted usage is usually the right choice for tools that support remote MCP connections. A hosted client can connect to https://mcp.postoria.io/mcp and authenticate with a Postoria Public API key.
Both options connect to the same Postoria Public API workflows. The best option depends on the MCP client you use and how it supports custom servers, authentication, and tool execution.
For setup details, read the Postoria MCP server help article.
Media workflows
The Postoria MCP server supports several media workflows, depending on where your media file already exists.
If the media is available through a public URL, the agent can import it into Postoria. This is useful when images or videos already live in a CMS, asset library, website, or another public location.
For API-style upload workflows, the server can create a signed upload URL. A client uploads the raw file bytes to that URL, then completes the upload so Postoria can process the media.
For desktop MCP clients, the server also supports local file upload. The MCP server can read the local file, upload it to Postoria storage, complete the upload, and return the media status.
Why this matters
Social media work increasingly involves AI-assisted planning, rewriting, repurposing, and workflow automation.
But publishing still needs structure. Teams need to know which workspace is being used, which social accounts are selected, which media is attached, when the post is scheduled, and what happened after publishing.
The Postoria MCP server gives AI agents a structured way to work with Postoria without turning publishing into a black box.
It is especially useful for:
- Agencies preparing posts across multiple clients
- Developers connecting internal tools to social publishing
- Teams experimenting with AI-assisted content operations
- Businesses that want to reduce manual steps between content planning and scheduling
- Power users who already use MCP-compatible desktop tools
Get started
You can explore the source code on GitHub, install the package from npm, or use the hosted MCP endpoint at https://mcp.postoria.io/mcp.
For local usage, configure your MCP client to run the Postoria MCP server package and pass your Postoria Public API key through the environment.
For hosted usage, use an MCP-compatible client that supports custom MCP connections and authenticate with a Postoria Public API key.
For the full setup guide, read How to use the Postoria MCP server.
Final thoughts
The Postoria MCP server gives AI agents a more reliable way to work with Postoria’s publishing workflow.
It connects AI-assisted planning with real social media operations: workspaces, accounts, queues, media, posts, statuses, and scheduled publishing.
This is another step toward making Postoria easier to connect with the tools teams already use, while keeping the publishing workflow clear, controlled, and built around the Postoria Public API.
Tag:
product updates