CodexAgents

FoPost for Codex

Register the FoPost MCP server with codex mcp add and Codex can draft, schedule, and verify posts across your connected accounts. Every tool call is shown for approval before it runs.

Terminal
codex mcp add fopost --env FOPOST_API_KEY=your-api-key -- npx -y @fopost/mcp

CLI or config

Use codex mcp add, or write the block into ~/.codex/config.toml by hand.

Approval first

Codex asks before running a tool. The server never publishes on its own.

14 tools

Posts, deliveries, accounts, workspaces, and AI rewriting.

Setup

Registered from the shell, ready in the next session

Create an API key in the FoPost dashboard and run the add command, or paste the TOML block. Start Codex and ask it to list accounts to confirm the server is reachable.

Set up Codex
~/.codex/config.toml
[mcp_servers.fopost]
command = "npx"
args = ["-y", "@fopost/mcp"]

[mcp_servers.fopost.env]
FOPOST_API_KEY = "your-api-key"

Scoped key

Limit the key to the scopes Codex needs. Revoke any time.

Workspace per key

One key reaches one workspace, never another client’s.

Verify first

Ask for list_accounts before you trust it with a schedule.

Ship and announce

Let the release announce itself

Codex has the diff and the commit log in context. Ask for a post per network and a time, and it drafts with rewrite_for_platforms, schedules with schedule_post, and prints the post ids.

Try it on your next release
A caption written once, with the post previewed as each network renders it

rewrite_for_platforms

Per-network lengths and conventions from one draft.

repurpose_url

Turn the changelog page into a series of posts.

schedule_post

Named times or the next open queue slot.

Check

Verify delivery from the same prompt

Ask whether the post landed. Codex reads deliveries per network, flags any account that needs a reconnect, and reports the remaining AI balance if you ask.

Get your API key
Prompt
> Did this morning's post go out everywhere?

Codex: list_post_deliveries → 3 of 3 delivered.
X, LinkedIn, Mastodon all live.

list_posts

Recent posts with status, by account or label.

get_account_health

Which tokens are healthy and which need a reconnect.

get_ai_credits

Balance before a long repurposing run.

Codex questions, answered

How do I install it?

Run codex mcp add as shown above, or add the [mcp_servers.fopost] block to ~/.codex/config.toml. Restart Codex.

Will it post without asking?

No. Codex shows the tool call for approval, and the server only acts inside an approved call.

Does it need Node?

Yes. The server runs through npx, so a current Node runtime must be installed.

Does it use my AI credits?

Only generate_caption, rewrite_for_platforms, and repurpose_url do. Scheduling and checks are free of credits.

Can it read analytics?

Not through MCP today. Use the dashboard or the REST API with the analytics scope.

Can I use it for several clients?

Register one server per workspace with its own key and name. Each stays isolated.

Run FoPost from Codex

Starting is free and the MCP server is included. Create a key, add the server, and schedule your first post from your agent.

Get your API key