- Works in: Cascade in Windsurf.
- Connection: A Moonya API key, sent as an Authorization header (up to 10 keys per workspace).
- Server address:
https://moonya.ai/mcp - Files from your computer: Yes, when the agent can run terminal commands.
- Nothing is published without your approval, and anything that costs credits asks first.
Why use Moonya from Windsurf
Cascade already understands your project. That makes it a natural place to write the post about the feature you just finished, or to turn a docs page into a short educational carousel for your audience.
Moonya keeps the social side safe: it designs in your brand style, keeps everything as drafts and spaces out posts on the same network so your accounts are not flooded.
Moonya is a social media autopilot for small businesses and agencies. It learns your brand from your website, creates carousels, single image posts, Stories and short videos in your brand colors and fonts, and publishes them to Instagram, Facebook, LinkedIn, TikTok, Threads, YouTube, Pinterest and Google Business, plus X as a paid add-on.
What you can do from Windsurf
These are the things the Moonya connector actually exposes to Windsurf. Every tool is listed in plain language in the MCP documentation.
- Brand Brain. Read and update what Moonya knows about your brand, analyse your website, add a PDF or DOCX brand document and save rules every future post follows.
- Posts and drafts. Get topic ideas, then create carousels, single image posts and Stories from a topic or from your own text. The slides come back as images.
- Review and schedule. Edit captions, hashtags and slide text, rewrite a draft from a plain instruction, change a slide photo, then approve, schedule, skip or move posts, up to 30 at once.
- Your own photos and videos. Use your Gallery, schedule up to 10 of your own photos at once and invite up to 3 Instagram collaborators on a feed post, carousel or Reel.
- Automations. Recurring post automations that create drafts on a schedule, plus comment-to-DM automations for Instagram and Facebook with results.
- Inbox and analytics. Read messages, comments and reviews, reply as the brand after you approve the exact text, and see reach, engagement, best time and top posts.
- Video. Reels from your clips or photos with a voiceover, a talking AI presenter and animated explainers: you see the script and the credit price before anything renders. Video tools appear when video is enabled for your workspace.
- Agencies. On the Agency plan one connection can cover all client brands. Say which brand you mean and Moonya switches, keeping brands strictly separate.
Connect Moonya to Windsurf in 3 steps
Before you start
- A Moonya account with an active plan or the 7-day trial for $1. Every plan includes the AI assistant connector.
- A Moonya API key. In Moonya open Settings, AI assistants (MCP), click Create key, give it a name and pick Windsurf as the tool. The key is shown once, and Moonya shows the ready-made setting for Windsurf with the key already filled in. Only the workspace owner can create keys.
- To publish, at least one social network connected in Moonya. Drafts work without one.
Windsurf
- Cascade → MCP servers → "View raw config" (the mcp_config.json file)
- Paste the JSON below
- Save and click "Refresh" – Moonya shows up among the tools
Configuration (replace <KEY> with your key):
{
"mcpServers": {
"moonya": {
"serverUrl": "https://moonya.ai/mcp",
"headers": {
"Authorization": "Bearer <KEY>"
}
}
}
}To check that it works, ask: “What do you know about my brand?” Windsurf should answer with what Moonya has in your Brand Brain. Moonya's tools load when a session starts, so new features show up in a new session.
Things to ask in Windsurf
Write in your own words, in English or Serbian. Here is what happens behind each request.
“Read docs/getting-started.md and make a 5-slide educational carousel for Instagram.”
Moonya confirms the cost and creates the carousel from that text, using only facts it contains.
“What is waiting for my approval in Moonya? Rewrite the first draft with shorter headlines.”
Moonya lists the drafts and rewrites the first one from your instruction.
“Upload the images in ./marketing to my Moonya Gallery.”
If Cascade can run terminal commands, it uploads them through one-time links.
“Schedule the approved drafts for the next two weeks, three per week.”
Moonya places them in the calendar and keeps safe spacing on each network.
Your photos and videos
When Cascade can run terminal commands, it can upload local photos and videos through a one-time Moonya upload link (15 minutes, up to 95 MB). Otherwise drag the files into the Moonya Gallery and ask Cascade to use them.
Good to know
- Nothing is published without your approval. New posts and videos are drafts. They go out only after you approve or schedule them, in Windsurf or in the Moonya app.
- Credits are confirmed first. Tools that cost credits tell you the exact cost and wait for your yes. A repeated request never charges twice. Drafts take 2 to 4 minutes, and Windsurf checks back until the draft is ready.
- Irreversible actions ask first. Publishing right now, deleting and replying to a message, comment or review need your confirmation.
- Posting limits protect your accounts. Moonya spaces out posts on the same network and moves a post to the nearest safe time when needed, and tells you why.
- Plans. The connector is included in Starter ($29), Pro ($79) and Agency ($199) per month, each with a 7-day trial for $1. Some video formats unlock once the trial ends and the plan is paid. See pricing.
- You stay in control of access. Revoke a key at any time in Moonya under Settings, AI assistants (MCP); it stops working immediately. Moonya does not read your chat history.
Troubleshooting
- Moonya does not appear among the tools. Open Cascade, MCP servers, View raw config, check the JSON and that <KEY> is replaced, save and click Refresh.
- Cascade ignores Moonya. Name it in the prompt, for example "with Moonya, create...".
- A tool returns an error. Moonya explains the fix in plain words and gives a link when the fix needs the browser, for example connecting a network or billing.
FAQ
Where is the Windsurf MCP configuration?
In Cascade, open MCP servers and click View raw config. That opens the mcp_config.json file where the Moonya block goes.
Do I need an API key?
Yes. Create one in Moonya under Settings, AI assistants (MCP); the ready-made Windsurf JSON there already contains it.
Can Cascade post to Instagram directly?
Cascade asks Moonya, and Moonya publishes to the networks you connected, but only after you approve or schedule a post.
Does it work for client brands?
Yes. On the Agency plan one key can cover all your brands, and you say which brand you mean in the prompt.
Other AI tools
See all AI assistant integrations, the full tool list in the MCP documentation, or the guide how to manage your Instagram and Facebook from ChatGPT or Claude.
Windsurf is a trademark of its owner and is named here only to describe compatibility. Moonya is an independent product and is not affiliated with the maker of Windsurf.