# For AI agents

> SocialFaktory for AI agents. One endpoint, seven channels.

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

Mint a token, point an agent client at one URL, and it can read your brands, price a job, generate video and text, upload your own files, and schedule posts on every channel you have connected.

- **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`

Public MCP repository, with setup recipes for Cursor, VS Code and Windsurf: https://github.com/socialfaktory/socialfaktory-mcp

### Claude Code

```bash
claude mcp add -s user --transport http socialfaktory https://www.socialfaktory.com/mcp \
  --header "Authorization: Bearer sfp_…"
```


### Codex CLI

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


### OpenClaw CLI

```bash
openclaw mcp set socialfaktory '{"url":"https://www.socialfaktory.com/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer sfp_…"}}'
```


## 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

### Which agent clients can connect?

Anything that speaks MCP over Streamable HTTP. Claude Code, Claude Desktop, ChatGPT, the Codex CLI, OpenClaw and Meta Muse each have a page here.

### Do I need a separate API key?

No. You mint a personal access token in your settings, and it works on this endpoint only.

### Can an agent post without asking me?

Only with a token you gave the publish scope. A token that carries read alone can never create or send a post.

### How do I stop an agent spending too much?

Set a monthly credit cap on the token, and ask for a quote before each video. The token starts no paid call once the month's spend reaches the cap.

### Which channels can an agent publish to?

X, Instagram, TikTok, YouTube, LinkedIn, Facebook and Pinterest, once you have connected them in the app.

### What can't be done through an agent?

Cloning a video from a link, still images and carousels stay in the app for now, and connecting a channel needs a browser sign-in.

## More for developers

- 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
- Codex: https://www.socialfaktory.com/agents/codex.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