Post to Instagram from Cursor

Cursor is an AI code editor with a built-in agent, plus a command line agent. Developers use it to write code, and its agent can call MCP tools such as Kreatix. A video from your Kreatix library or a public link, posted as a Reel; Instagram takes no text-only post.

Updated November 2026

Connect Cursor to Kreatix

Sign in with Kreatix

No key to copy: paste the address, sign in to Kreatix and press Allow.

Open ~/.cursor/mcp.json (create the file if it isn't there) and add Kreatix with only its url, as in the snippet.
Save the file and restart Cursor.
Follow Cursor's sign-in prompt for kreatix, or run agent mcp login kreatix with the Cursor CLI. Sign in to Kreatix and press Allow.
Open Customize > MCPs in the sidebar and check that kreatix is on.

{
  "mcpServers": {
    "kreatix": {
      "url": "https://api.kreatix.cc/mcp"
    }
  }
}

With a key

For setups without sign-in. The key works like a password, so keep it to yourself.

In Kreatix, open Settings > AI agent and create a key. It is shown once.
Add Kreatix with its url and an Authorization header to ~/.cursor/mcp.json (create the file if it isn't there), as in the snippet.
Save the file and restart Cursor.
Open Customize > MCPs in the sidebar and check that kreatix is on.

{
  "mcpServers": {
    "kreatix": {
      "url": "https://api.kreatix.cc/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      }
    }
  }
}

What Cursor can do on Instagram

A video from your Kreatix library or a public link, posted as a Reel; Instagram takes no text-only post.

Setting	Values	Needed	What it does
`media_url`	URL	Yes	One video: a link from your Kreatix library (list_posts shows it) or a public YouTube, TikTok, Instagram or Facebook post, which Kreatix imports first. Pictures and carousels are not scheduled.
`caption`	string (max 5000)	No	The Reel's caption. At most 30 hashtags and 20 @mentions, or schedule_post refuses the post.
`cover_url`	URL	No	The Reel's cover: a picture stored in Kreatix, such as a thumbnail_url from list_posts. With an imported link and no cover, the link's own thumbnail is used.

Ask in plain words

Ask in Cursor's agent chat, for example "Use Kreatix to move tonight's posts on my brand group to 21:00." From a terminal, the Cursor CLI takes one-off prompts: agent -p "Which of my Kreatix pages got the most views this week?"

Post this TikTok link as a Reel on all my Instagram pages tomorrow at 18:00.
Schedule yesterday's video on my brand's Instagram for Friday 20:00 with the same cover.
Do any of my Instagram pages have an alarm or need reconnecting?

Instagram rules to know

Every Instagram post needs a video, and it goes out as a Reel.
A caption with more than 30 hashtags or 20 @mentions is refused before anything is scheduled.
Instagram processes the video first; if it is not ready within 30 minutes, the post fails with Instagram's reason.
Kreatix connects only professional Instagram accounts (Business or Creator).
If Instagram locks an account, it wants the owner to finish a check on instagram.com; reconnecting does not help.

Tips for Cursor

Put Kreatix in ~/.cursor/mcp.json, not in a project's .cursor/mcp.json: project files are meant to be committed and shared with your team.
To keep the key out of the file, write "Authorization": "Bearer ${env:KREATIX_API_KEY}". Cursor fills in ${env:NAME} in url and headers.
Cursor asks before each MCP tool call. Click the arrow next to the tool name to check the pages, caption and time before you approve.
The agent checks the pages, caption and time with you before it posts. It cannot delete pages, read messages or change your account, and you can remove it any time in Settings > AI agent.

Questions

How do I post to Instagram from Cursor?

Connect Cursor to Kreatix once, as shown above. Then ask it to post: name your Instagram pages or a page group, the video or text and the time. Cursor shows you the plan and posts after you say yes.

Can my agent post photos or carousels to Instagram?

No. Through the agent, Kreatix schedules a video or a text post, and Instagram takes no text-only post. Photos and carousels go out from Kreatix with Publish now.

Why did the agent refuse my caption?

Instagram takes at most 30 hashtags and 20 @mentions in a caption. Kreatix counts them before scheduling, so the post is stopped up front instead of failing on Instagram later.

What if Instagram is slow to process my Reel?

Kreatix keeps checking for up to 30 minutes, and your other posts keep going out meanwhile. If Instagram still has not finished, the post fails with Instagram's own reason.

Will my agent know if an Instagram page is in trouble?

Yes. list_channels shows Kreatix's page alarm when several of the page's newest videos in a row stay under 50 views, and marks a page Instagram has locked or closed. Kreatix tells the agent to raise these with you before planning posts there.

How do I know Kreatix connected?

Open Customize > MCPs in the sidebar and look for kreatix with its toggle on. If it is missing, open the Output panel (Cmd+Shift+U on Mac), choose MCP Logs and look for an error.

Does the Cursor CLI need its own setup?

No. The CLI reads the same mcp.json as the editor. Run agent mcp list to see kreatix.

Kreatix schedules one video to every page you run, each with its own platform settings.

Start free, then connect Cursor