Windsurf + Instagram
Post to Instagram from Windsurf
Ask Windsurf to write and schedule your Instagram posts. BrokenPost connects the two, follows Instagram's rules and posts at the time you pick.
How to connect Windsurf to Instagram
- 1
Connect Instagram in BrokenPost. Connect an Instagram business or creator account, either through its Facebook Page or with Instagram login.
- 2
In BrokenPost, open Plugins and copy your MCP URL.
- 3
Add the config below to ~/.codeium/windsurf/mcp_config.json.
- 4
Sign in to BrokenPost when asked and allow access.
- 5
Ask the agent to schedule a post.
{
"mcpServers": {
"brokenpost": { "serverUrl": "<MCP_URL>" }
}
}What to ask Windsurf
Type these in Windsurf. Change the details to fit your posts.
- “Post these 5 photos as an Instagram carousel on Friday at 6pm with a short caption.”
- “Schedule this video as an Instagram Reel tomorrow at 7pm and tag @partnerbrand as a collaborator.”
- “Share this picture to my Instagram story on Saturday morning.”
- “Read the commits since the last tag and turn them into a short Instagram post. Schedule it for 10am tomorrow.”
- “What Instagram posts do I have scheduled for next week?”
What happens next
- 1
You ask in Windsurf, in plain words.
- 2
Windsurf lists the channels you connected in BrokenPost and picks your Instagram account.
- 3
It reads Instagram's rules and settings from BrokenPost, so the post fits Instagram's limits before it is written.
- 4
If you shared a picture, a video or a link to one, it uploads it to your media library.
- 5
It creates the post as scheduled, as a draft, or to go out now, and gives you a preview link.
- 6
At the set time BrokenPost publishes it to Instagram and it shows on your calendar.
Instagram limits Windsurf follows
Windsurf reads these rules from BrokenPost before it writes, so the post fits the first time.
| Characters | 2,200 characters |
|---|---|
| Media | At least 1 picture or video, up to 10 in a carousel |
| Carousel | Up to 10 pictures or videos |
| Stories | Pictures or videos, each one becomes its own story |
| Trial Reels | 1 video only |
| Text-only posts | Not allowed |
Instagram settings you can ask for
Say them in plain words, like "post or story", and Windsurf sets them on the post.
- Post or story
- Collaborators to tag
- Trial Reel and how it graduates
- Music for a single video Reel
If Instagram rejects a post
Windsurf sees the same message and can fix the post for you.
| What you see | How to fix it |
|---|---|
| Aspect ratio not supported, must be between 4:5 to 1.91:1 | Crop the picture to a size between portrait 4:5 and landscape 1.91:1. Square always works. |
| Instagram carousel should have between 2 and 10 media attachments | A carousel needs 2 to 10 items. Remove extras or post them as a second carousel. |
| Collaborators are not allowed for carousel | Instagram only takes collaborators on single posts and Reels. Remove them or post one item. |
| Caption is too long | Instagram allows 2,200 characters. Shorten the caption or move details to the first comment. |
| Image is too large | Export the picture at a smaller size and upload it again. |
| Should have at least one media | Instagram never takes text-only posts. Add a picture or video. |
Good to know
- Every Instagram post needs at least one picture or video.
- A carousel can hold up to 10 items.
- Music can only be added to a single video Reel, not to Stories.
- Windsurf only posts when you ask. Ask for a draft to check the post in BrokenPost first.
Questions people ask
Can Windsurf post to Instagram directly?
Yes, through BrokenPost. Connect Instagram in BrokenPost, connect BrokenPost to Windsurf, and Windsurf can schedule, draft or publish Instagram posts.
Does Windsurf know the Instagram limits?
Yes. Windsurf reads Instagram's rules from BrokenPost before it writes: 2,200 characters and at least 1 picture or video, up to 10 in a carousel. BrokenPost checks again before it posts.
Can Windsurf schedule Instagram posts for later?
Yes. Give a day and time, like "Friday at 6pm", and the post goes out then. Ask for a draft if you want to check it first.
Is it free?
Windsurf with BrokenPost works on every plan. The Free plan includes 1 account on every app and 20 posts a month. Paid plans start at $19 a month with unlimited posts.
What if I don't have a picture or video?
Instagram needs media on every post. Windsurf can upload one from a link, use your media library, or make a new picture or video for you.
Which Instagram settings can Windsurf set?
Post or story; Collaborators to tag; Trial Reel and how it graduates; Music for a single video Reel.
Can Windsurf post an Instagram thread or comments?
Yes. Ask for a thread or a first comment and BrokenPost posts each part as a reply, right after the first one.
Do I need an Instagram business account?
You need a business or creator account. You can connect it through a Facebook Page or straight with Instagram login.
Can I schedule Instagram Stories?
Yes. Set the post type to story. Each picture or video you add is posted as its own story.
More apps with Windsurf
Post to Instagram with other AI
Write once. Post everywhere.
Start free with BrokenPost. Connect your apps and your AI in a few minutes.