Wavegrain MCP server
Commit Nov 13, 2026Lets an AI client plan, create, and schedule TikTok slideshows and Instagram carousels for your brand.
Also known as wavegrain/wavegrain-mcp, mcp
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.4.1
- Last commit
- Nov 13, 2026
- License
- MIT
What is Wavegrain MCP?
Wavegrain lets an AI client plan, create, and schedule TikTok slideshows and Instagram carousels for your brand.
Summary generated from the project's README
About Wavegrain MCP server
Managing social media content for brands becomes automated when you use Wavegrain to plan, create, and schedule TikTok slideshows and Instagram carousels directly from an AI assistant. This hosted server connects your existing Wavegrain account to various MCP clients including Claude, ChatGPT, Cursor, and Claude Code. Users can manage their social presence by interacting with their brand briefs, image collections, and content calendars through natural language commands.
Setup varies depending on your chosen client. For Claude and ChatGPT, you use OAuth 2.1 to sign in and set daily credit limits. For developer tools like Cursor, VS Code, or Codex, you provide an access key via the WAVEGRAIN_MCP_TOKEN environment variable. The server supports different permission levels, allowing you to read brand data for free, write changes to slide text or captions without spending credits, and use credits specifically for generating new slideshows and images.
What you can do with it
- 1Generate new social contentCreate a specific number of slides for a brand topic while staying within a set credit budget.
- 2Automate content schedulingOrganize a series of upcoming social media posts by adding them to a brand calendar.
- 3Edit existing slideshowsModify specific elements of a previously created post such as headlines or slide order.
- 4Replicate successful contentUse a specific link to duplicate and adapt an existing slideshow for a brand.
Written from the project's README. Every use case is checked against a quote from it.
How to install Wavegrain MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Wavegrain MCP in Claude Code
$ claude mcp add --transport http mcp https://wavegrain.com/api/mcpInstall Wavegrain MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://wavegrain.com/api/mcp"
}
}
}Install Wavegrain MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://wavegrain.com/api/mcp"
}
}
}Install Wavegrain MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"http","url":"https://wavegrain.com/api/mcp"}'Install Wavegrain MCP in Codex
$ codex mcp add mcp --url https://wavegrain.com/api/mcpInstall Wavegrain MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] url = "https://wavegrain.com/api/mcp"
Install Wavegrain MCP in Gemini CLI
$ gemini mcp add -s user --transport http mcp https://wavegrain.com/api/mcpInstall Wavegrain MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"url": "https://wavegrain.com/api/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablewavegrain/wavegrain-mcp is public and reachablegithub.com/wavegrain/wavegrain-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-13github.com/wavegrain/wavegrain-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubWavegrain MCP server
Curated TikTok slideshows and Instagram carousels for your brand on autopilot, made and scheduled from your AI assistant.
Wavegrain makes curated TikTok slideshows and Instagram carousels for your brand on autopilot. Its MCP server lets Claude, ChatGPT, Claude Code, Codex, Cursor and any other MCP client work in your Wavegrain account: plan posts for a brand, make slideshows, change slide text, put posts on your Calendar and export them.
Full docs, the tool list and limits: https://wavegrain.com/mcp
This repo holds the setup files, a plugin for Claude Code and an agent skill. The server itself is hosted by Wavegrain; there is nothing to install or run.
Server
| Address | https://wavegrain.com/api/mcp |
| Transport | Streamable HTTP |
| Sign-in | OAuth 2.1 for claude.ai, the Claude app and ChatGPT; an access key for everything else |
| Registry name | com.wavegrain/mcp (server.json) |
You need a Wavegrain account. Sign up.
Connect
Claude (claude.ai, desktop and phone)
- In Claude on the web or the desktop app, open Customize, then Connectors. Choose Add, then Add custom connector.
- Name it Wavegrain and paste
https://wavegrain.com/api/mcp. - Sign in to Wavegrain in the window that opens, then choose the permissions and the daily credit limit.
A connector you add on claude.ai also works in the Claude app on your phone. More: Wavegrain for Claude.
ChatGPT
- In ChatGPT, open Plugins, press the plus button, then choose Add custom MCP server.
- Name it Wavegrain, paste
https://wavegrain.com/api/mcp, and choose OAuth to sign in. - Sign in to Wavegrain in the window that opens, then choose the permissions and the daily credit limit.
Your ChatGPT plan or workspace must allow custom MCP servers. More: Wavegrain for ChatGPT.
Tools that use an access key
Make a key in Wavegrain under Settings, AI agents, and give it only the permissions it needs.
Save it in the WAVEGRAIN_MCP_TOKEN environment variable, so the key is not written into a config file you might share or commit.
Claude Code, as a plugin (adds the server and the Wavegrain skill):
/plugin marketplace add wavegrain/wavegrain-mcp
/plugin install wavegrain@wavegrain
Claude Code, server only:
claude mcp add --transport http --scope user wavegrain https://wavegrain.com/api/mcp --header "Authorization: Bearer $WAVEGRAIN_MCP_TOKEN"
Codex:
codex mcp add wavegrain --url https://wavegrain.com/api/mcp --bearer-token-env-var WAVEGRAIN_MCP_TOKEN
Cursor, in ~/.cursor/mcp.json (keep any servers already in it):
{
"mcpServers": {
"wavegrain": {
"url": "https://wavegrain.com/api/mcp",
"headers": { "Authorization": "Bearer ${env:WAVEGRAIN_MCP_TOKEN}" }
}
}
}
More: Wavegrain for Cursor.
VS Code:
code --add-mcp '{"name":"wavegrain","type":"http","url":"https://wavegrain.com/api/mcp","headers":{"Authorization":"Bearer ${env:WAVEGRAIN_MCP_TOKEN}"}}'
Any other MCP tool: use the address https://wavegrain.com/api/mcp, the Streamable HTTP transport and the header Authorization: Bearer <your access key>.
If the tool can sign in with OAuth, give it only the address.
Skill
skills/wavegrain/SKILL.md tells an agent when to use Wavegrain and which tools to call for the common jobs.
Install it with any tool that reads agent skills, for example:
npx skills add wavegrain/wavegrain-mcp
What it can do
Each key or connected app has its own permissions:
- read: your brands and each brand's brief, formats, slideshows, Calendar, image collections, credits and where each post stands. Reading is free.
- write: change saved work without spending credits: slide text, photos and order, captions, Calendar slots, brand settings and exports.
- generate: spend your normal credits to make brands, slideshows and images, within the limit each call names and the key's daily limit.
- post: post a slideshow to your connected accounts, after you confirm a summary of what goes where. Never on by default.
- approve: approve finished slideshows for posting. Off until you turn it on for that key or app in Settings.
The full list of tools is on wavegrain.com/mcp.
Example prompts
- "Copy and create this slideshow for my brand: "
- "Make a 6-slide carousel about morning routines for my active brand. Spend at most 10 credits."
- "Plan a week of posts for my brand and put them on my Wavegrain Calendar."
- "Change the headline on slide 2 of my latest slideshow, then export it."
Files
| File | For |
|---|---|
server.json |
The entry in the official MCP Registry |
.mcp.json |
The server for the Claude Code plugin (reads WAVEGRAIN_MCP_TOKEN) |
.claude-plugin/plugin.json |
The Claude Code plugin |
.claude-plugin/marketplace.json |
Lets /plugin marketplace add wavegrain/wavegrain-mcp find the plugin |
skills/wavegrain/SKILL.md |
The agent skill |
Links
- Website: https://wavegrain.com
- MCP docs: https://wavegrain.com/mcp
- Developer docs: https://wavegrain.com/developers
- Privacy: https://wavegrain.com/privacy
- Support: support@wavegrain.com
The files in this repo are under the MIT license. The Wavegrain name and logo are not.
Wavegrain MCP questions
How do I add Wavegrain MCP to Claude Code?
Run claude mcp add --transport http mcp https://wavegrain.com/api/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Wavegrain MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What authentication methods are supported?
The server supports OAuth 2.1 for Claude and ChatGPT, and access keys for other tools.
Do I need to install anything to use the server?
No, the server is hosted by Wavegrain and there is nothing to install or run.