# SocialKit

> SocialKit is the AI engine for social. It scores, generates, rewrites, and plans social posts, and it renders finished visual posts and carousel decks: brand-kit-locked images composed deterministically, graded by a design judge, revisable by freeform feedback. Text intelligence is graded against per-platform 2026 ranking rubrics by an LLM judge. LinkedIn and X are live; Instagram, Facebook, and TikTok are coming soon.

SocialKit is built for agents and developers. Every capability is exposed three ways: a JSON REST API, an MCP server, and a logged-in dashboard, all over the same core. Authenticate with a bearer key (sk_live_...). Signup is open with no waitlist: POST https://api.socialkit.sh/v1/account with a JSON body of { "email": "you@example.com" } returns an account and a key.

## API

- [OpenAPI spec (JSON)](https://api.socialkit.sh/openapi.json): the complete, authoritative REST surface. Generate a client from this.
- [OpenAPI spec (YAML)](https://api.socialkit.sh/openapi.yaml): the same spec in YAML.
- [API docs](https://socialkit.sh/docs): quickstart, authentication, errors, conventions (idempotency, pagination), and webhooks.
- Base URL: https://api.socialkit.sh/v1
- Auth: send `Authorization: Bearer sk_live_...` on every request.
- Every response carries an `x-request-id` header; errors repeat it as `error.requestId`.

## MCP

- MCP server: https://mcp.socialkit.sh (Streamable HTTP, JSON-RPC). The same capabilities as the API, exposed as tools and resources for any MCP client.
- [MCP guide](https://socialkit.sh/docs#mcp): how to connect from Claude, Cursor, or any MCP client with one bearer key.

## Capabilities

- score: grade a post 0-100 against the selected platform's 2026 ranking rubric, with a per-dimension breakdown and ranked signals. POST /v1/score.
- validate: preflight a draft against a platform's caps and media rules before you spend a score. POST /v1/posts/validate.
- generate: write platform-native drafts, each auto-graded and returned best-first. POST /v1/generate.
- rewrite: sharpen an existing post, with an honest before/after score. POST /v1/rewrite.
- plan: build a multi-day content calendar for a platform. POST /v1/plan.
- visual: generate a finished post with rendered image masters, the design judge's score, and a revisable spec. POST /v1/generate-visual-v2; refine with POST /v1/revise-visual-v2. Also MCP tools generate_visual and revise_visual. Slow calls (tens of seconds to minutes); always send an Idempotency-Key.
- carousel: generate a full swipe deck in one frame family with per-slide roles. POST /v1/generate-carousel-v2; refine with POST /v1/revise-carousel-v2.
- posts: draft, schedule, publish, and list posts, with engagement metrics on published ones. /v1/posts.
- memory: reusable brands and voices that condition generation, created once and referenced by id. /v1/brands and /v1/voices.

## Artifacts

- [Image posts](https://socialkit.sh/image): finished, judged, editable masters in 4:5 and 9:16. Public API + MCP.
- [Carousels](https://socialkit.sh/carousel): whole decks planned as an arc, one frame family, per-slide roles, judged as a set. Public API + MCP.
- [Video](https://socialkit.sh/video): reels with narrative beats, real-photo-first motion, word-timed voiceover captions, and a motion QC gate. Runs Taka's reels in production; NOT on the public API yet.

## More

- [How it works](https://socialkit.sh/engine): the honest tour of the v2 engine: pipeline, judge gates and dimensions, layout archetypes, typography voices, and the determinism guarantees.
- [Pricing](https://socialkit.sh/pricing): the free plan starts at 100 credits a month with no card. A credit is one successful model-backed call, visual and carousel calls included.
- [Dashboard](https://app.socialkit.sh): sign in with a magic link or with Google to manage keys, brands, voices, posts, and billing.
- [PostScore](https://socialkit.sh/postscore): a free, no-signup grader for a single post.
- [Changelog](https://socialkit.sh/changelog): what shipped, newest first.