SocialsForAI

SocialsForAI

One API to post to social networks, built for AI agents and the apps that run them. Send one request with the accounts and the text; get one result per account. This repository holds the agent-facing pieces: a skill, plugins for Claude Code, Cursor and Gemini CLI, the MCP server listing, and a command-line client.

• Site: https://socialsforai.com
• Docs: https://socialsforai.com/docs
• For agents: https://socialsforai.com/llms.txt
• OpenAPI: https://socialsforai.com/openapi.json

What an agent can do with it

• Create its own workspace and API key with one request, no human sign-up first.
• Hand a person a link to connect their social accounts. The agent never sees a password.
• Validate a post against each network's limits without publishing (dry_run).
• Publish now or schedule, with an idempotency key so a retry never posts twice.
• Ask a human to approve a post before it goes out, and read their feedback if they reject it.
• Read per-account results, metrics, and errors that say how to fix them.

Call GET https://socialsforai.com/v1/platforms for the networks available right now and their limits.

Install

MCP server (any MCP client)

https://socialsforai.com/api/mcp

Streamable HTTP. Clients that support MCP sign-in need only the URL: a browser window opens, you sign in by email and approve. Clients without sign-in can send an API key as Authorization: Bearer sk_....

Claude Code

As a plugin (skill and MCP server together):

/plugin marketplace add SocialsForAi/socialsforai/plugin install socialsforai@socialsforai

Or the MCP server alone:

claude mcp add --transport http socials https://socialsforai.com/api/mcp

Then run /mcp, pick socials, and sign in.

Skill (any agent that loads Agent Skills)

npx skills add SocialsForAi/socialsforai

Cursor

Add the MCP server in Cursor's MCP settings:

{  "mcpServers": {    "socials": { "url": "https://socialsforai.com/api/mcp" }  }}

This repository is also a Cursor plugin (.cursor-plugin/plugin.json) bundling the skill and the server.

Gemini CLI

gemini extensions install https://github.com/SocialsForAi/socialsforai

CLI

npx @socialsforai/cli --help# or install it: npm install -g @socialsforai/cli   (commands: socials, socialsforai)

Node 18 or later, no dependencies. See cli/README.md.

60-second quickstart

With the CLI:

# 1. Create a workspace. The key is saved to ~/.config/socialsforai/config.jsonnpx @socialsforai/cli signup --name "My agent" --email [email protected]
# 2. Connect accounts: open the printed link and approve on each networknpx @socialsforai/cli connect --platforms bluesky,linkedin --wait
# 3. Check the post without publishingnpx @socialsforai/cli post --accounts bluesky,linkedin --text "Hello from my agent" --dry-run
# 4. Publish. The same idempotency key never posts twicenpx @socialsforai/cli post --accounts bluesky,linkedin --text "Hello from my agent" --idempotency-key first-post

The same thing over HTTP:

curl -X POST https://socialsforai.com/v1/workspaces -d '{"name":"My agent","email":"[email protected]"}'# -> {"api_key":"sk_..."}   shown once
export SOCIALSFORAI_API_KEY=sk_...AUTH="Authorization: Bearer $SOCIALSFORAI_API_KEY"
curl -X POST https://socialsforai.com/v1/connect-links -H "$AUTH" -d '{"platforms":["bluesky","linkedin"]}'# -> {"id":"cl_...","url":"..."}   the account owner opens the url
curl https://socialsforai.com/v1/accounts -H "$AUTH"
curl -X POST https://socialsforai.com/v1/posts -H "$AUTH" -H "Idempotency-Key: first-post" \  -d '{"accounts":["acc_..."],"text":"Hello from my agent","wait":true}'

With an agent, after adding the MCP server or the skill:

Connect my LinkedIn and Bluesky accounts with SocialsForAI, then show me a dry run of a post announcing our launch before publishing anything.

Human approval

Add "approval": "required" to a post (CLI: --approval). Nothing is published; the response carries an approval.url. The person opens it, sees the preview for each network, and approves or rejects with a note. The agent waits with GET /v1/posts/{id}?wait=45 (CLI: socials get <post_id> --wait) and reads the note if it was rejected.

Scoped keys

Give an automation a key that can only do what it should:

socials keys create --name "drafting agent" --scopes posts:write --account-ids acc_123 --require-approval --daily-post-limit 5

Scopes are posts:read, posts:write, accounts:read, accounts:write and admin.

What is in this repository

Pricing

Billed per account that posted in the month; connected accounts that stay idle cost nothing. There is a free plan. Current plans: https://socialsforai.com/pricing

Privacy and terms

Privacy · Terms

License

MIT. See LICENSE.