
Gruvi
Publish, schedule and track social videos and photo carousels from an AI agent
- Pricing
- Free trial
- Platforms
- CLI, API
- Runs
- Locally
- Version
- 2.1.0
- Listing updated
- 2 days ago
About Gruvi
Gruvi is an MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.
Gruvi turns a local stdio MCP server into a distribution desk for an agent. It uploads a finished video or 2 to 10 images from disk, then publishes now or schedules for a future time to connected accounts on platforms such as Instagram and X, with carousels also going to TikTok and Facebook Pages. Bulk scheduling handles up to 20 videos at once.
The docs stress careful agent behaviour: check existing media and scheduled posts before repeating an upload, publish only on the user's instruction covering content and destination, and verify delivery status after a timeout instead of retrying blindly. TikTok posts default to creator-inbox review. Stable request IDs make retries safe.
Setup and media preparation are free; submitting a post returns PUBLISHING_PLAN_REQUIRED until a plan exists. The agent can fetch plans and request a Stripe-hosted checkout link, but the account owner pays; nothing is charged to a saved card automatically. Analytics cover TikTok and YouTube, with Instagram and Facebook insights when authorised and X engagement in beta. The server needs Node.js 20 and an agent key; there is no hosted HTTP endpoint, so ChatGPT web connectors are not supported.
Install
Run in a terminal
claude mcp add gruvi --env GRUVI_API_KEY='<GRUVI_API_KEY>' -- npx -y @agent-gruvi/gruvi-mcp-serverAdd to claude_desktop_config.json
{
"mcpServers": {
"gruvi": {
"command": "npx",
"args": [
"-y",
"@agent-gruvi/gruvi-mcp-server"
],
"env": {
"GRUVI_API_KEY": "<GRUVI_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"gruvi": {
"command": "npx",
"args": [
"-y",
"@agent-gruvi/gruvi-mcp-server"
],
"env": {
"GRUVI_API_KEY": "<GRUVI_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"gruvi": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@agent-gruvi/gruvi-mcp-server"
],
"env": {
"GRUVI_API_KEY": "<GRUVI_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"gruvi": {
"command": "npx",
"args": [
"-y",
"@agent-gruvi/gruvi-mcp-server"
],
"env": {
"GRUVI_API_KEY": "<GRUVI_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"gruvi": {
"command": "npx",
"args": [
"-y",
"@agent-gruvi/gruvi-mcp-server"
],
"env": {
"GRUVI_API_KEY": "<GRUVI_API_KEY>"
}
}
}
}Configuration
GRUVI_API_KEYAgent key created in the Gruvi dashboard at https://agentgruvi.com/agents.Required
Tools this server provides (14)
Taken from the project documentation; the running server may differ.
- gruvi_get_user_info
- Return the authenticated account.
- gruvi_get_social_accounts
- List connected social accounts.
- gruvi_upload_video
- Upload a local video and return a video ID.
- gruvi_schedule_post
- Schedule a video post for a future time.
- gruvi_get_scheduled_post
- Inspect a scheduled post by ID.
- gruvi_publish_post
- Publish a post immediately.
- gruvi_get_post_status
- Check delivery status of a post.
- gruvi_bulk_schedule_videos
- Schedule up to 20 videos.
- gruvi_upload_carousel
- Upload 2 to 10 local images as a carousel.
- gruvi_publish_carousel
- Publish a carousel now.
- gruvi_schedule_carousel
- Schedule a carousel.
- gruvi_get_plans
- List subscription plans.
- gruvi_create_checkout
- Create a Stripe-hosted checkout link for a plan.
- gruvi_get_billing_status
- Check the subscription status.
What it does
- Video and carousel posting
- Upload videos or 2 to 10 images and publish immediately or on a schedule.
- Bulk scheduling
- Queue up to 20 videos with timing and caption for each.
- Delivery checks
- Status tools confirm a post before any retry.
- Agent-driven checkout
- The agent requests a hosted checkout link for the owner to pay.
- Cross-platform analytics
- TikTok and YouTube analytics plus Instagram and Facebook insights when authorised.
- Agent keys
- Named keys created in the dashboard and supplied through the environment.
Good for
- Schedule a week of short videos across social accounts
- Post an image carousel to Instagram and TikTok
- Check how a published video performed
- Let an agent set up a subscription for the account owner to approve
Pricing
Free trial, from $10 a month
Starter $10, Scale $25, Pro $50 per month; one 3-day trial for eligible accounts
Prices change. Check agentgruvi.com before you buy.
Gruvi FAQ
Does it work with ChatGPT web connectors?
No. It is a local stdio server and ChatGPT web connectors require a remote transport.
Do I need a paid plan to start?
Setup and media preparation are free; publishing needs a plan.
Is there a trial?
Eligible verified accounts can start one three-day trial through Stripe checkout, with a payment method required.
What does it require locally?
Node.js 20 or newer and a Gruvi agent key.
Is Gruvi free?
Gruvi is a paid product with a free trial. Paid plans start at $10 a month.
How do I add Gruvi to Claude Code?
Run this command in your terminal: claude mcp add gruvi --env GRUVI_API_KEY='<GRUVI_API_KEY>' -- npx -y @agent-gruvi/gruvi-mcp-server
What are the best alternatives to Gruvi?
The closest alternatives to Gruvi are HyperFrames by HeyGen, ffmpeg-skill, Google Ads + Meta Ads + SEO/GEO MCP, Calven and AvatarSay — Fictional Character & Talking Video MCP.
Alternatives to Gruvi

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat
- 8 tools
- Remote
- Freemium
- 8.1K GitHub stars
- Marketing and SEO

Calven
MCP serverProduct marketing context from Calven delivered into Claude, ChatGPT and other AI tools
Not checked yet- Remote
- Free trial
- 3 GitHub stars
- Marketing and SEO

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

MCP
MCP serverMCP server for planning, scheduling and measuring social and ad campaigns with approvals
- Remote
- Freemium
- Marketing and SEO