Connect an agent

A single endpoint your agent client talks to. It can read your brands and channels, generate video and text, upload files, schedule and send posts, and read back how they performed.

It cannot connect a social channel or change your plan. What it may spend is bounded by its scopes, the monthly credit cap on its token, and idempotency keys that stop a retry from paying twice. Connecting a channel is a browser sign-in, so it stays in the app.

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

• Scopes decide what the token may do — read on its own, plus generate for anything that spends credits, plus publish for posting.
• Pin it to one brand and it sees only that brand's 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. A text write already running settles at its real cost, which can land a little over.

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

Streamable HTTP, protocol version 2025-06-18, bearer authentication on the Authorization header. There is no session id to carry: the token is the session. A GET answers 405.

Claude Desktop starts local servers from its config file, so this entry runs mcp-remote through npx as a bridge to the endpoint, and Node.js has to be installed. claude.ai and Cowork reach it only when an organization administrator adds it as a connector with the token as a request header, a beta feature on Anthropic's side that shares the token across the organization.

1{
2  "mcpServers": {
3    "socialfaktory": {
4      "command": "npx",
5      "args": ["-y", "mcp-remote", "https://www.socialfaktory.com/mcp", "--header", "Authorization:${SOCIALFAKTORY_AUTH}"],
6      "env": { "SOCIALFAKTORY_AUTH": "Bearer sfp_…" }
7    }
8  }
9}

Send JSON-RPC 2.0 over POST. Accept both JSON and the event-stream type, and name the protocol version on every request.

1POST https://www.socialfaktory.com/mcp
2Authorization: Bearer sfp_…
3Content-Type: application/json
4Accept: application/json, text/event-stream
5MCP-Protocol-Version: 2025-06-18
6
7{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }

Every tool names the scope it needs. A token without that scope is refused before the tool runs. quote_generation is an optional price check for a video, and generate_text reserves a few credits up front and settles what the write actually used.

Pass this argument on every call that spends or publishes. A replay within 24 hours returns the original result, marked replayed, rather than doing the work twice.

• 120 calls a minute per token, and 300 requests every 5 minutes per address.
• Cloning a video from a link, and generating still images or carousels, are not available through an agent yet.