Where does the configuration live?

In your Codex config file, under an mcp_servers table keyed by the name you choose.

How do I pass the token?

Put the secret in an environment variable and name that variable in the config, so the file itself carries no secret.

Which tools will Codex see?

Every tool the server exposes, each one naming the scope it needs. A token without that scope is refused before the tool runs.

Should Codex be allowed to publish?

Leave publishing behind a confirmation until you trust the brief. A token without the publish scope cannot post at all.

Does it cost credits to look around?

No. Reading brands, channels, formats and quotes is free. Only generating a video and writing a post spend.

Can I run it against one brand only?

Yes. Pin the token to a brand, and Codex never sees the other brands. The credit wallet, uploads, actors and products stay shared across the account.

Codex social media automation. One config block, one token.

Declare SocialFaktory in your Codex config file, keep the secret in an environment variable, and the terminal can brief, price, generate and schedule a brand's week.

Mint a token Read the MCP reference

EndpointCodex

Tools: 20
Scopes: 3
Channels: 7
Endpoint: 1

Posts to

Point your client at the endpoint

Mint a personal access token first. The secret is shown once, and it works on this endpoint only.

Endpoint

http

1POST https://www.socialfaktory.com/mcp

Codex CLI

bash

1export SOCIALFAKTORY_TOKEN=sfp_…
2codex mcp add socialfaktory --url https://www.socialfaktory.com/mcp --bearer-token-env-var SOCIALFAKTORY_TOKEN

Codex config file

~/.codex/config.toml

1[mcp_servers.socialfaktory]
2url = "https://www.socialfaktory.com/mcp"
3bearer_token_env_var = "SOCIALFAKTORY_TOKEN"

What the agent can do

20 tools, grouped by what they touch. Every tool names the scope it needs, and a token without that scope is refused before the tool runs.

Reading what you have

list_brandsreadFree
list_channelsreadFree
get_channel_requirementsreadFree
list_formatsreadFree
get_walletreadFree

Making something new

quote_generationreadFree
create_generationgenerateSpends credits
generate_textgenerateSpends credits
check_referencereadFree

Reading results

get_generationreadFree
list_generationsreadFree
get_text_generationreadFree
list_mediareadFree

Bringing your own file

create_uploadgenerateFree
complete_uploadgenerateFree
get_uploadreadFree

Publishing

create_postspublishFree
send_postpublishFree
delete_postpublishFree
list_postsreadFree

How permissions work

Every token can read. Add generate for anything that spends credits, and publish for creating, scheduling, sending and deleting posts.
Pin a token to one brand and it sees only that brand, with its channels, generations, posts and text. The credit wallet, uploads, actors and products stay shared across the account.
Set a monthly credit cap and the token starts no paid call once the month's spend reaches it.
Every call that spends or publishes carries an idempotency key. A replay inside 24 hours returns the first result instead of doing the work twice.
120 calls a minute per token, and 300 requests every 5 minutes per address.

What it will not do

Clone a video from a link. That one runs in the app only.
Generate still images or carousels. Neither is available through an agent yet.
Connect a social channel. Connecting one is a browser sign-in, so it stays in the app.
Start a paid call that would pass the cap you set on the token, or change your plan.

A typical run

Step 1

Mint the token

Pick its scopes, pin it to a brand, set a monthly cap. The secret is shown once.

Step 2

Ask for a price

quote_generation prices a video for free. It is an optional check, and a render runs without one.

Step 3

Generate

create_generation makes the video and charges its price. generate_text reserves a few credits and settles what the write used. Both hand back an id you read the result from.

Step 4

Schedule it

create_posts composes one post per channel, and send_post puts it on its channel now or at its time.

Questions

More for developers

For AI agents MCP server Claude OpenClaw MCP reference AI assistant

Let an agent run the brand.

Mint a token, point your client at the endpoint, and brief it the way you would brief a person.

Mint a token Start your brand