IMMA AI Docs
Documentation for the IMMA AI social media API and MCP server, currently in private beta.
Private beta
IMMA AI is in private beta. The API and MCP server described in these docs are not publicly available yet, and details may still change before general availability. Join the waitlist to get access.
IMMA AI is a unified social media API and MCP server for AI agents, developers, agencies and small businesses (UMKM). One integration publishes posts to TikTok, Instagram, Facebook Pages and Threads, with built in human approval for TikTok, webhooks for every post event, and cross platform analytics.
Two ways in
- Developers: call the REST API directly, or wire it into your own backend. Start with Quickstart.
- AI agents: connect through the MCP server so Claude, ChatGPT, Cursor or an n8n workflow can post and check status in plain language. Start with MCP quickstart.
What is in these docs
| Section | What it covers |
|---|---|
| Getting started | First API call, MCP setup, core concepts, authentication |
| API reference | Every REST endpoint, with request and response examples |
| MCP reference | Every MCP tool, and setup for each client |
| Platform rules | TikTok consent, Meta and TikTok posting limits |
| Errors | Every error code with what caused it and how to fix it |
| Webhooks | Event types, payload shape, signature verification |
| Rate limits | Request limits per API key and per platform |
| Bahasa Indonesia | Panduan dalam Bahasa Indonesia untuk pemilik UMKM |
Core idea
IMMA AI never chooses a TikTok privacy setting on your behalf, and it never generates images or video itself. An agent (or a person) drafts the content and IMMA AI's job is to store it correctly, check each platform's limits, get a human to approve anything going to TikTok, and publish it reliably. See Platform rules for exactly how TikTok consent works.