SocialCannonSocial media publishing API
for developers and AI agents
Schedule and publish to Twitter/X, Facebook, Instagram, LinkedIn, TikTok, and YouTube from a single REST API, MCP server, or AI agent. OpenClaw & Hermes ready.
Free tier: 2 connected accounts · 10 posts per month · No credit card required
Connected accounts
Scheduled queue
Launch day: our new API is live
Today · 14:00
How we cut release time by 60%
Wed · 09:00
Changelog v2.4 — thread
Fri · 17:30
See it in action
One request publishes everywhere. Every response follows the same predictable { success, data } shape.
curl -X POST https://socialcannon.app/api/v1/posts \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"accountId": "b3f1a942-…",
"content": "Hello from SocialCannon!"
}'Add scheduledAt to schedule instead of publishing immediately.
{
"success": true,
"data": {
"id": "8f3a1c2e-…",
"accountId": "b3f1a942-…",
"platform": "twitter",
"status": "published",
"platformPostId": "1782345678901234567",
"platformPostUrl": "https://x.com/acme/status/1782…",
"publishedAt": "2026-04-15T10:00:03Z"
}
}Everything you need to publish everywhere
Publishing is just the start — repurposing, threads, and engagement tracking all through one API.
Instant & Scheduled Publishing
Publish immediately or schedule posts for the perfect time. Built-in scheduler with automatic retries and 5-minute backoff.
AI Content Repurposing
Write once, publish everywhere. AI adapts your content for each platform’s format, tone, and character limits automatically.
Threads & Carousels
Create Twitter threads and Instagram carousels. Up to 25 items per thread on Pro.
Engagement Inbox
Monitor comments, replies, and mentions from all platforms in one place. Mark as read, filter by post, and reply directly.
Built for AI agents
23 MCP tools, a drop-in OpenClaw skill, and a clean REST API. Let your AI assistant manage your social media end to end.
MCP Server
23 tools over stdio transport. Works with Claude, ChatGPT, Cursor, and any MCP-compatible client. Auto-refreshing JWT auth.
OpenClaw Ready
Drop-in SKILL.md for OpenClaw agents. Install from ClawHub in one command. Your AI assistant can publish, schedule, and analyze.
Hermes Agent
A first-class MCP client from Nous Research. Add one block to ~/.hermes/config.yaml and Hermes gets all 23 tools over npx.
REST API
Standard OAuth2 client_credentials flow. JWT Bearer auth, cursor-based pagination, Zod-validated JSON. Works with any HTTP client.
Add SocialCannon to OpenClaw in seconds
Install from ClawHub or drop the skill file into your OpenClaw workspace.
Install from ClawHub
openclaw skills install socialcannonThen add your credentials to openclaw.json:
{
"skills": {
"entries": {
"socialcannon": {
"enabled": true,
"env": {
"SOCIALCANNON_CLIENT_ID": "your-client-id",
"SOCIALCANNON_CLIENT_SECRET": "your-secret"
}
}
}
}
}Or use the SKILL.md directly
Drop this into ~/.openclaw/workspace/skills/socialcannon/SKILL.md
---
name: socialcannon
description: >
Publish, schedule, and manage social
media posts across Twitter/X, Facebook,
Instagram, LinkedIn, TikTok, and YouTube.
version: 1.0.0
metadata:
openclaw:
requires:
env:
- SOCIALCANNON_CLIENT_ID
- SOCIALCANNON_CLIENT_SECRET
bins:
- curl
primaryEnv: SOCIALCANNON_CLIENT_ID
emoji: "\U0001F4E3"
homepage: https://socialcannon.app
---Full skill file with all API instructions available in the API docs.
Connect SocialCannon to Hermes Agent
Hermes from Nous Research ships a first-class MCP client. Add one block to your config and all 23 tools load over npx.
Add to ~/.hermes/config.yaml
mcp_servers:
socialcannon:
command: "npx"
args: ["-y", "@socialcannon/mcp"]
env:
SOCIALCANNON_CLIENT_ID: "your-client-id"
SOCIALCANNON_CLIENT_SECRET: "your-client-secret"Run /reload-mcp in your Hermes session and all 23 SocialCannon tools load automatically.
Powered by the published package
The config runs npx -y @socialcannon/mcp — the same server published to npm. Supply the SOCIALCANNON_CLIENT_ID and SOCIALCANNON_CLIENT_SECRET from your dashboard Settings page.
Any MCP host can run the same npx command. Full setup lives in the API docs.
Secure by design
AES-256-GCM encrypted tokens at rest, bcrypt-hashed client secrets, JWT auth with scoped permissions, tiered rate limiting, and per-client tenant isolation. Your social tokens never leave the server unencrypted.
Ready to ship content faster?
Connect your accounts and start publishing in minutes. Free tier included.