Windsurf + WordPress

WordPress posts with Windsurf and Bolta

Draft and schedule social posts from Windsurf's chat. For WordPress, 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.

WindsurfBolta connected
You

Read the top entry in CHANGELOG.md and write a WordPress article about it as a draft for review

Illustration of the reply: Bolta returns a draft showing the connected account and the scheduled time, with Approve, Edit and Reject actions.

Illustration. Your drafts show your real text, account and time.
Bolta on WordPress

What Bolta does on WordPress

WordPress is a blog, not a social network, so Bolta has its own tool for it (create-wordpress-blog-post). It resolves the WordPress account, creates the draft and sets the article's settings in one call.

  • Articles saved as a draft, with a title, excerpt, categories, tags and SEO meta.
  • Featured and inline images, uploaded to the WordPress Media Library.
Limits and format

WordPress limits and format rules

Bolta's posting rules for your workspace (get-posting-rules) win if they differ from this page.

Not promised for WordPress from Windsurf: Pages and custom post types. This page does not confirm them. Rankings. Bolta prepares an article for search and never promises a position.

WordPress limits and format rules
What to knowThe destination's ruleWhat Bolta does
TitleNot stated on this page.The title you set. If you do not set one, Bolta uses the first line of the post text.
StatusNot stated on this page.WordPress has its own status field, which is separate. Bolta's own approval decides when the article goes out.
Several sitesNot stated on this page.With more than one WordPress account, Bolta returns a list and asks which one to use.
LengthNot stated on this page.No limit that Bolta checks.
FormattingNot stated on this page.Markdown is shown as formatting, so headings, lists and links work.
Best practices

Windsurf jobs for WordPress, and how to write them

  • Ask how a recent post performed on one of your accounts
  • Name the site if you have more than one. Bolta asks when you do not.
Prompts

Example prompts for WordPress

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 write a WordPress article about it as a draft for review

Which of my posts did best this month?

Turn docs/guide.md into a WordPress article with a title and meta description and show me the text

How did my posts do this month? Name the best and the weakest.

Review

Bolta saves a draft, you read the exact text, you say yes

  1. 01

    Bolta saves a draft

    Windsurf asks Bolta for the WordPress article in your brand voice (save-post). A saved draft is never public.

  2. 02

    You read the exact text

    On WordPress the exact text is the whole article, with its title, excerpt, tags, meta description and images, so read all of it.

  3. 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.

Windsurf and Bolta

Using Windsurf for WordPress

For WordPress, Windsurf reaches Bolta through an MCP server you add by hand, with the Bolta address and an API key. The WordPress 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 WordPress 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 WordPress article it saves, so keep them on.

An illustration from the Windsurf guide, not real output. You ask: What is waiting for review in Bolta? The reply goes along these lines: Two drafts are waiting. I will not approve either until you tell me which and I show you the exact text. Read only. Waits for your yes.

Windsurf's docs name two places for MCP settings. Cascade's Open MCP config file action opens ~/.config/devin/mcp_config.json on macOS and Linux, and the editor's own discovery reads a build-specific file, ~/.codeium/windsurf/mcp_config.json for the stable build.

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.

  • 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.
  • Read how posts did. Ask which post did best on an account and what to change next week.
  • Cascade sees Bolta's tools. After you save the config entry and refresh the MCP list, bolta appears with its tools. A fresh chat loads them.
  • You say yes, or you do not. Approving, scheduling and publishing wait for your yes to that exact text. Without it the draft just sits there.
  • 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.
  • Bolta skill via npx skills add. The skills README lists Windsurf as not tested. Run the command and pick Windsurf if it is offered, otherwise copy the skills/bolta folder to where your app reads skills.
  • A routine you confirmed keeps drafting on its schedule even when Windsurf is closed.
Connect

Connect Windsurf to Bolta

Bolta has no one-click install for Windsurf. You add the server URL and an API key by hand.

FAQ

WordPress questions, answered for Windsurf

Will Windsurf publish a WordPress article without asking me?
No. Bolta saves the article as a draft. It can submit for review, schedule or publish, but only after you have seen the exact text and said yes.
What does SERP-ready mean for an article from Windsurf?
It means Bolta prepared the article technically and editorially, with headings, a meta title and description, and the focus keyphrase placed sensibly. It does not promise a ranking.
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.
Is Bolta listed in a Windsurf marketplace?
We have not listed one. Setup is manual: add the server URL and your key in Windsurf's MCP settings.
Can I use OAuth instead of an API key in Windsurf?
Possibly. Windsurf's docs say Cascade supports OAuth for remote servers, but we have not tried it with Bolta, so we give no steps. The guide uses an API key because that is the path written down.
I have several brands. How do I make sure the draft lands in the right one?
Name the brand in your prompt, for example for Acme Coffee. The skill passes that brand's workspace_id on each call. If the brand is not reachable with your key, create a key for that brand in Bolta Settings and swap it in.
Does Windsurf publish WordPress articles without my yes?
No. Nothing is approved, scheduled or published until you say yes to that WordPress article.

More from Windsurf

Windsurf can work with the other networks Bolta publishes to. Each page has its own limits and review notes.

WordPress from other AI agents

The same WordPress limits apply whichever agent asks. The connection and the setup are what change.

Try a WordPress draft from Windsurf

Connect Windsurf, ask for a WordPress draft and read the exact text. Nothing goes live until you say yes.