Claude social media automation. Claude Code and Claude Desktop.
Add SocialFaktory as an MCP server in Claude Code with one command, or in Claude Desktop through a small local bridge. One endpoint, one token, the same tools in both.
- Tools
- 20
- Scopes
- 3
- Channels
- 7
- Endpoint
- 1
Point your client at the endpoint
Mint a personal access token first. The secret is shown once, and it works on this endpoint only.
POST https://www.socialfaktory.com/mcp
Claude Code
claude mcp add -s user --transport http socialfaktory https://www.socialfaktory.com/mcp \--header "Authorization: Bearer sfp_…"
Claude Desktop, through a local bridge
{"mcpServers": {"socialfaktory": {"command": "npx","args": ["-y", "mcp-remote", "https://www.socialfaktory.com/mcp", "--header", "Authorization:${SOCIALFAKTORY_AUTH}"],"env": { "SOCIALFAKTORY_AUTH": "Bearer sfp_…" }}}}
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_brandsreadFreelist_channelsreadFreeget_channel_requirementsreadFreelist_formatsreadFreeget_walletreadFree
Making something new
quote_generationreadFreecreate_generationgenerateSpends creditsgenerate_textgenerateSpends creditscheck_referencereadFree
Reading results
get_generationreadFreelist_generationsreadFreeget_text_generationreadFreelist_mediareadFree
Bringing your own file
create_uploadgenerateFreecomplete_uploadgenerateFreeget_uploadreadFree
Publishing
create_postspublishFreesend_postpublishFreedelete_postpublishFreelist_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
Mint the token
Pick its scopes, pin it to a brand, set a monthly cap. The secret is shown once.
Ask for a price
quote_generation prices a video for free. It is an optional check, and a render runs without one.
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.
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
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.