Skip to content
MCP server

Gruvi

Publish, schedule and track social videos and photo carousels from an AI agent

Runs locallyStatus and history
Install
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-server

Add 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

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. Hosted 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
  4. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  5. MCP

    MCP server

    MCP server for planning, scheduling and measuring social and ad campaigns with approvals

    • Remote
    • Freemium
    • Marketing and SEO