Instagram posts with Windsurf and Bolta
Draft and schedule social posts from Windsurf's chat. For Instagram, Bolta saves a draft, you read the exact text, and nothing goes live until you say yes.
Checked 2026-11-21
Bolta has no one-click install for Windsurf. You add the server URL and an API key by hand.
Read the top entry in CHANGELOG.md and draft an Instagram caption for the launch image I attach
Illustration of the reply: Bolta returns a draft showing the connected account and the scheduled time, with Approve, Edit and Reject actions.
What Bolta does on Instagram
Instagram will not take text alone. Bolta needs an image or video before it will approve the post, so the draft starts with the media you want to use.
- Feed posts, Reels and Stories. A post is a feed post unless you set Reels or Story.
- An image or video is required for every Instagram post.
Instagram limits and format rules
Network rules last checked 2026-07-28. Bolta's posting rules for your workspace (get-posting-rules) win if they differ from this page.
Not promised for Instagram from Windsurf: Replies to Instagram comments and a search for Instagram conversations. Bolta's reply tools are not wired for Instagram, so this page does not promise either. Collab posts, Close Friends and direct messages.
| What to know | Instagram's own rule | What Bolta does |
|---|---|---|
| Caption length | Not stated on this page. | 2,200 characters. Longer text is trimmed back to the last whole sentence or word that fits. That applies to the caption Bolta builds from your text. A caption you set yourself is sent as written, with no length check. |
| Reel length | Reels can be up to 20 minutes long, with 3 minutes the recommendation cutoff. | Bolta does not check video length or file size, so Instagram makes that call. |
| Carousels | One post can hold up to 20 photos and videos as a swipeable carousel. | A carousel in Bolta takes 2 to 10 files. |
| Image size | Instagram caps shared photos at 1080 pixels wide, sizing larger uploads down. | Feed images should sit between 4:5 and 1.91:1, and Story images between 9:16 and 1.91:1. |
| Story video | A story video up to 60 seconds stays one clip. Longer footage is broken into several clips. | Bolta does not check video length. A Story cannot be a carousel. |
Windsurf jobs for Instagram, and how to write them
- Ask how a recent post performed on one of your accounts
- Start with the media. Instagram needs an image or video, so attach it before you ask for the caption.
Example prompts for Instagram
Things to type in Windsurf. Each one asks for a draft and shows you the text first.
Read the top entry in CHANGELOG.md and draft an Instagram caption for the launch image I attach
Which of my posts did best this month?
Draft an Instagram caption from the README tagline and tell me which image or video the post still needs
Set up a weekly routine that drafts a product update for me to approve.
Bolta saves a draft, you read the exact text, you say yes
- 01
Bolta saves a draft
Windsurf asks Bolta for the Instagram post in your brand voice (save-post). A saved draft is never public.
- 02
You read the exact text
On Instagram the exact text includes the caption and the media it sits on, and whether it is a feed post, a Reel or a Story.
- 03
You say yes
Only then does Bolta schedule or publish (publish-post), in your workspace's timezone. Safe Mode, client sign-off and brand approval rules still apply.
Using Windsurf for Instagram
For Instagram, Windsurf reaches Bolta through an MCP server you add by hand, with the Bolta address and an API key. The Instagram account itself is connected inside Bolta, not in Windsurf.
Windsurf has no one-click install for Bolta. You add the server address and a Bolta API key by hand, then ask for Instagram drafts in its chat.
This connection uses a Bolta API key, which acts as you. Safe Mode and client sign-off still apply to every Instagram post it saves, so keep them on.
An illustration from the Windsurf guide, not real output. You ask: How did my posts do this month? Name the best and the weakest. The reply goes along these lines: I pulled this month's results for the account and named one strong post and one weak one, with a single change to try next week. Read only. Nothing changed.
If you edited a file and nothing changed, you likely edited the other one. Open the file through the menu, save, then press refresh in the MCP list.
If Bolta is blocked, ask your admin to add a server with the ID bolta in the team's MCP settings at windsurf.com.
- Turn code changes into drafts. Paste a changelog entry or point Cascade at a release note and ask for a post in your voice. It saves a draft, never a live post.
- Batch a week of posts. Ask for a week of posts in one go. Cascade should first ask which accounts and what the posts are about, and each post follows the same approval rules as a single one.
- It reads your voice. Before writing, it pulls your voice and brand facts so a changelog line reads like you, not like release notes.
- It saves a draft and shows you the text. The post is saved as a draft, nothing more. You read the exact words in the chat.
- Setup: Add Bolta as an MCP server in Windsurf. In Windsurf's MCP settings, add a server with the URL https://mcp.bolta.ai/mcp and the header Authorization: Bearer plus your key. The exact JSON is on the Bolta MCP docs page.
- OAuth sign-in for the remote server. Windsurf's docs say Cascade supports OAuth for remote servers. We have not tested it with Bolta, so we give no steps.
- Drafting new posts, editing a draft and approving one need Cascade open or the Bolta app.
Connect Windsurf to Bolta
Bolta has no one-click install for Windsurf. You add the server URL and an API key by hand.
Instagram questions, answered for Windsurf
- Can Windsurf post text to Instagram without an image?
- No. Bolta will not approve an Instagram post without an image or video, so attach the media first. A post is a normal feed post unless you ask for a Reel or a Story.
- How long can an Instagram caption from Windsurf be?
- Bolta uses 2,200 characters and trims a longer caption back to the last whole sentence or word that fits. That applies to the caption Bolta builds from your text, so a caption you set yourself is sent as written, unchecked.
- Does Windsurf support MCP servers?
- Yes, Windsurf can connect to MCP servers. Bolta's server is at https://mcp.bolta.ai/mcp and uses Streamable HTTP. Check Windsurf's own docs for where its MCP settings live in your version.
- How do I sign in from Windsurf?
- Use a Bolta API key as a Bearer token. Create one in Settings, API Keys. Bolta also supports OAuth sign-in for apps that offer a connect button, so if your Windsurf version supports it you can use that instead.
- Can Windsurf publish a post on its own?
- Not without your yes. Windsurf should show you the exact text and act only when you confirm. With OAuth, Bolta refuses to schedule or publish an unapproved post. An API key you create acts as you, so the approval step is up to the app.
- What can it not do?
- It cannot bypass roles or Safe Mode. Owners and admins can approve any post, creators can approve Bolta's drafts and posts they review, and viewers cannot approve or publish. It also cannot post to an account you have not connected.
- Does Windsurf publish Instagram posts without my yes?
- No. Nothing is approved, scheduled or published until you say yes to that Instagram post.
More from Windsurf
Windsurf can work with the other networks Bolta publishes to. Each page has its own limits and review notes.
Instagram from other AI agents
The same Instagram limits apply whichever agent asks. The connection and the setup are what change.
Try an Instagram draft from Windsurf
Connect Windsurf, ask for an Instagram draft and read the exact text. Nothing goes live until you say yes.