# Turboyap

> Turboyap is the social media API and MCP server for AI agents, in early access. Agents (Claude Code, Cursor, or your own code) upload media, preview each platform's version with a dry run, and schedule or publish posts through one REST API, the @turboyap/sdk TypeScript SDK, or the @turboyap/mcp server. A per-account autonomy dial decides whether agent posts wait for human approval (level 1) or publish on autopilot with a kill switch (level 3).

Status: Turboyap is in early access. Early access means it's built and being tested. Each platform opens to early-access users as it approves Turboyap. Instagram needs Meta App Review, and public TikTok posting needs TikTok's audit. Beta means early-access users can connect an account and post to it through the API today; it just hasn't been proven with a real production post yet. The npm packages (@turboyap/sdk and @turboyap/mcp) aren't published yet.

Early access: TikTok and Instagram publishing (TikTok photo posts and slideshows in inbox or direct mode; Instagram images and carousels), autonomy levels 1 and 3, the REST API, the TypeScript SDK, a local MCP server for Claude Code and Cursor, webhooks, scoped API keys, and test mode with simulated accounts.

Beta: Bluesky, Telegram and Discord publishing: text posts with link cards or previews, single images, and multi-image posts. Each platform's API guide says how to connect it.

Coming soon: Facebook, Threads, X, LinkedIn, YouTube, Pinterest; remote MCP for claude.ai and ChatGPT; a CLI; autonomy level 2 guardrails; a dashboard with a calendar and approval queue.

All docs in one file: https://turboyap.com/llms-full.txt

## Docs

- [Docs](https://turboyap.com/docs): Index of Turboyap documentation.
- [MCP quickstart: schedule social posts from Claude Code](https://turboyap.com/docs/mcp-quickstart.md): Connect the Turboyap MCP server to Claude Code or Cursor and let your agent upload slides, preview each platform's version, and schedule posts to TikTok and Instagram. Start with a test key.
- [Test mode: try the whole API in 5 minutes](https://turboyap.com/docs/test-mode.md): Use ty_agent_test_ and ty_human_test_ keys to create simulated TikTok and Instagram accounts, then upload, approve and publish a post without a real account or any platform approval.
- [Post one slideshow to TikTok and Instagram](https://turboyap.com/docs/slideshows.md): How Turboyap turns one set of slides into a TikTok photo post and an Instagram carousel: slide limits, 9:16 vs 4:5, JPEG conversion, and TikTok inbox mode.
- [The autonomy dial](https://turboyap.com/docs/autonomy-dial.md): Choose how much leash your AI agent gets on each account, from reviewing every post to full autopilot with a kill switch, plus which keys and scopes can do what.
- [Platform rules](https://turboyap.com/docs/platform-rules.md): The slide limits, formats, aspect ratios, caption limits and link cards Turboyap enforces on each platform, generated from its source code.
- [REST API reference](https://turboyap.com/docs/api.md): Endpoints, authentication, scopes, objects, statuses and error format for the Turboyap API. The MCP server and the SDK use this same API, and so will the dashboard.
- [Webhooks: signed post and account events](https://turboyap.com/docs/webhooks.md): Get post.pending_approval, post.published, post.partial, post.failed and account.reauth_required events, signed with Standard Webhooks, with the retry schedule and verification code for the SDK and plain Node.

## Platform API guides

- [Social media API guides](https://turboyap.com/api.md): How to publish each post type on each platform through Turboyap's REST API, SDK and MCP server: limits with sources, example requests, modes, and every error with its fix.
- [TikTok photo post API](https://turboyap.com/api/tiktok/photo-post.md): Publish a single-image TikTok photo post through an API or MCP server: limits, inbox vs direct mode, curl, SDK and Claude Code examples, and errors with fixes.
- [TikTok slideshow API](https://turboyap.com/api/tiktok/slideshow.md): Post TikTok slideshows (photo carousels) through an API or MCP server: the 35-image limit, formats, inbox vs direct mode, example requests, and every error with its fix.
- [Instagram image post API](https://turboyap.com/api/instagram/image-post.md): Publish single-image Instagram posts through an API or MCP server: JPEG, size and aspect ratio limits, caption limits, example requests, and errors with fixes.
- [Instagram carousel API](https://turboyap.com/api/instagram/carousel.md): Publish Instagram carousels through an API or MCP server: the 10-item limit, the 4:5 to 1.91:1 aspect rule, example requests, daily limits, and every error with its fix.
- [Bluesky text post API](https://turboyap.com/api/bluesky/text-post.md): Post to Bluesky through an API or MCP server: the 300-grapheme limit, link cards, clickable links and mentions, connecting with an app password, example requests, and errors with fixes.
- [Bluesky image post API](https://turboyap.com/api/bluesky/image-post.md): Publish a single-image Bluesky post through an API or MCP server: the 1 MB image limit, alt text, the 300-grapheme caption, example requests, and errors with fixes.
- [Bluesky multi-image post API](https://turboyap.com/api/bluesky/multi-image-post.md): Publish Bluesky posts with 2 to 4 images through an API or MCP server: image limits, alt text, example requests, and errors with fixes.
- [Telegram text message API](https://turboyap.com/api/telegram/text-message.md): Send text posts to a Telegram channel or group through an API or MCP server: the 4,096-character limit, link previews, connecting Turboyap's bot, example requests, and errors with fixes.
- [Telegram photo post API](https://turboyap.com/api/telegram/photo.md): Post a photo with a caption to a Telegram channel or group through an API or MCP server: the 5 MB and 1,024-character limits, example requests, and errors with fixes.
- [Telegram album API](https://turboyap.com/api/telegram/album.md): Send 2 to 10 photos as one Telegram album to a channel or group through an API or MCP server: limits, the album caption, example requests, and errors with fixes.
- [Discord message API](https://turboyap.com/api/discord/message.md): Post messages to a Discord channel through an API or MCP server: the 2,000-character limit, link embeds, connecting with a webhook and no bot, example requests, and errors with fixes.
- [Discord image message API](https://turboyap.com/api/discord/image-message.md): Post an image to a Discord channel through an API or MCP server: attachment size and formats, alt text, link embeds, example requests, and errors with fixes.
- [Discord multi-image message API](https://turboyap.com/api/discord/multi-image-message.md): Post 2 to 10 images in one Discord message through an API or MCP server: attachment limits, alt text, example requests, and errors with fixes.

## Tools

- [Tools](https://turboyap.com/tools): Free reference tools for developers and agents that post to social media through APIs.
- [Social media API limits](https://turboyap.com/tools/social-api-limits.md): Posting limits, rate limits, media specs and API access requirements for every major social media API, with a source link on every value and the date each platform was last verified.
- [Social media API limits (JSON)](https://turboyap.com/tools/social-api-limits.json): the tracker's raw data with a source URL on every value

## Optional

- [Homepage](https://turboyap.com/): product overview, platforms, autonomy dial and FAQ
- [Privacy policy](https://turboyap.com/privacy): What data Turboyap collects from you and the platforms you connect, how it's used, and how to delete it.
- [Terms of service](https://turboyap.com/terms): The terms that govern use of Turboyap.
- [Data deletion](https://turboyap.com/data-deletion): How to delete your Turboyap data and remove Turboyap from each platform.
