# Codex

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

Canonical page: https://www.socialfaktory.com/agents/codex

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.

- **21** Tools
- **3** Scopes

## 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: `POST https://www.socialfaktory.com/mcp`

### Codex CLI

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


### Codex config file

`~/.codex/config.toml`

```toml
[mcp_servers.socialfaktory]
url = "https://www.socialfaktory.com/mcp"
bearer_token_env_var = "SOCIALFAKTORY_TOKEN"
```


## What the agent can do

- `list_brands` (Read)
- `list_channels` (Read)
- `get_channel_requirements` (Read)
- `list_formats` (Read)
- `get_generation` (Read)
- `list_generations` (Read)
- `get_text_generation` (Read)
- `quote_generation` (Read)
- `create_generation` (Generate)
- `generate_text` (Generate)
- `create_upload` (Generate)
- `complete_upload` (Generate)
- `get_upload` (Read)
- `list_media` (Read)
- `create_posts` (Publish)
- `send_post` (Publish)
- `list_posts` (Read)
- `delete_post` (Publish)
- `check_reference` (Read)
- `get_wallet` (Read)
- `list_actors` (Read)


## 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 won't 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

1. **Mint the token**: Pick its scopes, pin it to a brand, set a monthly cap. The secret is shown once.
2. **Ask for a price**: quote_generation prices a video for free. It's an optional check, and a render runs without one.
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.
4. **Schedule it**: create_posts composes one post per channel, and send_post puts it on its channel now or at its time.

## Questions

### 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 can't 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.

## More for developers

- For AI agents: https://www.socialfaktory.com/agents.md
- MCP server: https://www.socialfaktory.com/agents/mcp-server.md
- Claude: https://www.socialfaktory.com/agents/claude.md
- ChatGPT: https://www.socialfaktory.com/agents/chatgpt.md
- OpenClaw: https://www.socialfaktory.com/agents/openclaw.md
- Meta Muse: https://www.socialfaktory.com/agents/muse.md
- Read the MCP reference: https://www.socialfaktory.com/docs/mcp.md
- AI assistant: https://www.socialfaktory.com/features/ai-assistant.md