MCP quickstart
Connect Claude Desktop, Claude Code, ChatGPT, Cursor or n8n to the IMMA AI MCP server and post your first draft.
Preview
Preview: the API and MCP server are in private beta; details may change. Join the waitlist for access.
The IMMA AI MCP server is a thin wrapper over the same REST API described in Quickstart, so it follows the same rules: no TikTok privacy level is ever chosen for you, and IMMA AI never generates images or video, it only stores and publishes what your agent's own AI produces.
- Endpoint:
https://api.getimma.com/mcp(Streamable HTTP) - Auth: two methods, depending on your client, see the table below.
Which client uses which auth
| Client | Auth method | Notes |
|---|---|---|
| ChatGPT (Developer mode app) | OAuth 2.1 login | Needs Developer mode (Pro, Plus, Business, Enterprise or Education). Custom connectors cannot accept a static key. |
| Claude.ai / Claude Desktop (Customize > Connectors) | OAuth 2.1 login | Works on Free, Pro, Max, Team and Enterprise (Free: one custom connector). Click Connect, log in, no key copying. |
| Claude Desktop (mcp-remote bridge) | Bearer API key | Advanced/alternative fallback for machines that cannot complete an interactive login. |
| Claude Code | Bearer API key | claude mcp add with an Authorization header. |
| Cursor | Bearer API key | mcp.json with an Authorization header. |
| n8n / scripts | Bearer API key | Header Auth node, or any HTTP client. |
Connect your client
Primary path: Customize > Connectors, click +, then Add custom connector, with URL https://api.getimma.com/mcp. Click Add, then Connect and log in on IMMA AI's OAuth consent screen. Team/Enterprise workspaces add the connector once via Organization settings > Connectors instead. See Connect Claude Desktop for the full walkthrough and the mcp-remote Bearer key alternative.
Try it
Ask your agent something like:
Post this video to TikTok and Instagram tomorrow at 18:30, and ask the owner to approve it first.
A well behaved agent will:
- Call
list_accountsto find the TikTok and Instagram account IDs. - Call
upload_mediawith the video (a URL; inline base64 upload only works for images). - Call
validate_postto catch problems before creating anything. - Call
create_postwithapproval: { mode: "link" }, which is the default and the only mode that lets someone other than the agent choose TikTok's privacy setting. - Reply with the approval link to send to the account owner.
See the MCP reference for the full tool list, and Concepts for what a profile, account, post and approval mean.