A response is not a publication
accepted, requires_approval and scheduled are workflow states. Keep the returned post ID and read it with get_publish until each destination reports published or failed.
Claude Code
Postdom as a Claude Code MCP server for social media
Add Postdom as a Claude Code MCP server and Claude can check your connected accounts, make slideshows on your brand kit, submit a finished video for your approval and read whether it published on TikTok, Instagram, YouTube and more.
Updated
A Claude Code MCP server gives Claude Code tools outside your code. Postdom's hosted server at https://api.postdom.com/mcp gives it 17 tools to make, publish and track social posts. Postdom is an AI social media tool that turns your website into short videos, slideshows and posts, then publishes them.
Connect the hosted MCP server: 17 tools
Postdom's hosted MCP server at https://api.postdom.com/mcp has all 17 tools, including create_slideshow, which makes a slideshow on your brand kit from slides your agent writes. Nothing to install: clients that support MCP sign-in connect to your workspace, and any client can send a workspace key instead.
Add the hosted server to Claude Code
claude mcp add --transport http postdom https://api.postdom.com/mcp
claude mcp get postdom| Tool | What it does | Reads or writes |
|---|---|---|
get_workspace_status | Start here to read setup progress, connection availability, accounts, policy, brief, and activity counts. | Reads |
list_accounts | List destination account IDs and connection state, synchronizing provider state into Postdom for this workspace. | Writes |
connect_account | Create a platform authorization URL for a human to complete when the workspace connection gate is unlocked. | Writes |
get_brief | Read the current workspace-owned brand guidance before planning or writing content. | Reads |
get_digest | Read the latest completed workspace week as descriptive evidence. | Reads |
get_learning | Read shared account learning: source-linked observations and exploratory advice for one learning scope. | Reads |
upload_media | Create a short-lived direct-upload contract for finished video or image bytes. | Writes |
get_media | Verify one uploaded media handle before publishing it. | Writes |
submit_plan | Propose a time-bounded publication plan for one human approval. | Writes |
get_plan | Read the current plan state and structured feedback from the human reviewer. | Reads |
publish_video | Submit finished media for immediate or UTC-scheduled execution using the current-source publish_video contract. | Writes |
get_publish | Read one post state, every destination outcome, and structured approval feedback. | Reads |
list_posts | List this workspace's posts to answer what is scheduled without already holding a post ID. | Reads |
get_performance | Read normalized measurements for one post or one connected account. | Reads |
get_best_posts | Rank one account's posts by one evidence-backed metric over a requested window. | Reads |
create_slideshow | Render carousel slides on the workspace brand kit from words and images, and store each slide as image media. | Writes |
account_music | Read or set who adds the music on each connected account, and read where each handed-off video stands. | Writes |
Sign up and your API key is in Settings, Connected apps. The REST API, MCP server, SDKs and webhooks are on every plan. Starter, Growth and Scale start with a 7-day free trial.
How to add the Postdom Claude Code MCP server
The quickest setup is the hosted server: one command, nothing to install, every tool.
Claude Code · hosted server
claude mcp add --transport http postdom https://api.postdom.com/mcpIn claude.ai or Claude Desktop, open Settings, Connectors, add a custom connector with the same URL, and sign in to Postdom. To run the local package instead, save this block as .mcp.json in your repository root. It names an environment variable and holds no key.
.mcp.json
{
"mcpServers": {
"postdom": {
"command": "npx",
"args": ["-y", "@postdom/mcp@0.4.0"],
"env": { "POSTDOM_API_KEY": "${POSTDOM_API_KEY}" }
}
}
}Or register it from the command line, then run claude mcp list to confirm it:
claude mcp add --transport stdio --scope local postdom -- npx -y @postdom/mcp@0.4.0The package needs Node.js 22 or newer. Create the workspace key in Postdom under Connect, Agents. Postdom shows it once.
Claude Code MCP server, free for 7 days
Starter, Growth and Scale start with a 7-day free trial, so you can see posts made from your website before you pay. Cancel anytime. After the trial, Starter is $39 a month for 30 posts.
The MCP server, the REST API, the SDKs and webhooks are included on every plan. Your own agent uses its own model.
Claude MCP server
As a Claude MCP server, Postdom's hosted server gives Claude 17 tools: read workspace status, accounts, the brief and the digest; make slideshows on your brand kit; upload media; submit plans and posts; and read publish results and performance. The local package @postdom/mcp@0.4.0 has the original 14.
Over MCP, your agent can make slideshows and publish them: create_slideshow draws the slides your agent writes on your brand kit, and publish_video posts them or a finished video you supply. The videos Postdom writes from your website are made in the app, and every post waits for the approval its account needs.
For claude.ai and Claude Desktop, add https://api.postdom.com/mcp as a custom connector and sign in to Postdom.
Claude Code MCP
Start with one read-only check. Ask Claude to call get_workspace_status, list_accounts and get_brief, and to stop before submitting anything.
Help me prepare one social video post, but do not submit it yet. First call get_workspace_status, list_accounts and get_brief. Show the connected account, the approval rule, and what finished video I still need to give you.An agent cannot approve itself
You own the accounts, the rules and the approval. Your agent prepares the request; you decide what goes out.
A missing metric is not a zero
When a platform does not report a value, Postdom marks it unavailable with the reason, and leaves it out of totals.
Claude Code MCP server questions
Is Postdom a Claude MCP server?
Yes. The hosted server at https://api.postdom.com/mcp gives Claude 17 tools, and the local package @postdom/mcp@0.4.0 runs over stdio with the original 14.
Which Postdom plan do I need?
Any of them. MCP access is included on every plan, and your agent uses its own model.
Can Claude post without my approval?
No. Claude can prepare a request; a person approves it in Postdom.
Does Claude Desktop use the same setup?
No. Claude Desktop keeps its servers separate from Claude Code: add Postdom there as a custom connector with https://api.postdom.com/mcp.
Get your Postdom API key
Sign up, then create a key in Settings, Connected apps. The same key works with the REST API, the MCP server and the SDKs.
The REST API, MCP server, SDKs and webhooks are on every plan. Starter, Growth and Scale start with a 7-day free trial.
Start your free trial
Start your free trial, connect Claude, and let Postdom make your posts from your website too.
Your website is all it needs
Starter, Growth and Scale start with a 7-day free trial.