# Gruvi

> Gruvi is an MCP server for marketing and seo. Publish, schedule and track social videos and photo carousels from an AI agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Starting price:** $10 a month
- **Platforms:** CLI, API
- **Website:** https://agentgruvi.com/docs/agent-integration
- **MCP Registry name:** com.agentgruvi/gruvi
- **Categories:** marketing and SEO, design and media
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add gruvi --env GRUVI_API_KEY='<GRUVI_API_KEY>' -- npx -y @agent-gruvi/gruvi-mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "gruvi": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-gruvi/gruvi-mcp-server"
      ],
      "env": {
        "GRUVI_API_KEY": "<GRUVI_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "gruvi": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-gruvi/gruvi-mcp-server"
      ],
      "env": {
        "GRUVI_API_KEY": "<GRUVI_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "gruvi": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@agent-gruvi/gruvi-mcp-server"
      ],
      "env": {
        "GRUVI_API_KEY": "<GRUVI_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "gruvi": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-gruvi/gruvi-mcp-server"
      ],
      "env": {
        "GRUVI_API_KEY": "<GRUVI_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "gruvi": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-gruvi/gruvi-mcp-server"
      ],
      "env": {
        "GRUVI_API_KEY": "<GRUVI_API_KEY>"
      }
    }
  }
}
```

## Tools

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

## 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

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/gruvi
