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.
Codex
Postdom as a Codex MCP server for social media
Add Postdom as a Codex MCP server and Codex can check your connected accounts, submit finished videos for your approval and read what published on each platform, with Postdom keeping every result.
Updated
A Codex MCP server gives Codex tools outside your code through the Model Context Protocol. Postdom's hosted server at https://api.postdom.com/mcp gives Codex 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 Codex
codex mcp add postdom --url https://api.postdom.com/mcp --bearer-token-env-var POSTDOM_API_KEY| 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 Codex MCP server
Codex registers MCP servers with its own command. Replace the placeholders with your server URL and workspace key from Postdom.
codex mcp add \
--env POSTDOM_API_URL=YOUR_SERVER_URL \
--env POSTDOM_API_KEY=YOUR_WORKSPACE_KEY \
postdom -- npx -y @postdom/mcp@0.4.0Or add it to Codex's config file:
config.toml
[mcp_servers.postdom]
command = "npx"
args = ["-y", "@postdom/mcp@0.4.0"]
[mcp_servers.postdom.env]
POSTDOM_API_KEY = "YOUR_WORKSPACE_KEY"
POSTDOM_API_URL = "YOUR_SERVER_URL"Keep the key out of anything you commit. The package needs Node.js 22 or newer.
Codex MCP
Codex MCP support means Codex can call tools on servers you register with codex mcp add. Register Postdom's hosted server with the command below, set POSTDOM_API_KEY to a workspace key from Postdom, and Codex sees all 17 tools. Ask it to call list_accounts first, then make or publish one post and read the result with get_publish.
Codex · hosted server
codex mcp add postdom --url https://api.postdom.com/mcp --bearer-token-env-var POSTDOM_API_KEYCodex 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.
What Codex can do with Postdom
Through the hosted server, Codex gets 17 tools: workspace status, accounts, the brief, slideshows made on your brand kit, uploads, plans, publishing, and reading 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.
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.
Codex MCP server questions
Is Postdom a Codex MCP server?
Yes. The hosted server gives Codex 17 tools, and the local package @postdom/mcp@0.4.0 runs over stdio with the original 14.
Which plan do I need?
Any of them. MCP access is included on every plan.
Can Codex publish without approval?
No. Codex prepares the request; a person approves it in Postdom.
Can Codex make posts with Postdom?
Yes, slideshows: create_slideshow draws the slides Codex writes on your brand kit. Codex can also publish finished videos you supply; the videos Postdom writes from your website are made in the app.
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 Codex, and let Postdom make posts from your website while Codex ships the rest.
Your website is all it needs
Starter, Growth and Scale start with a 7-day free trial.