How to Use the ContentGroove MCP in Claude Code

Q: How do I add ContentGroove to Claude Code?

Run claude mcp add --transport http contentgroove-mcp -- in your terminal to register the ContentGroove server.

Q: How does Claude Code export clip data from ContentGroove?

Claude Code calls listallclips to fetch your highlights from ContentGroove and formats the output as a JSON stream that you can pipe into other CLI tools.

Q: Does Claude Code require a browser to upload videos?

No, Claude Code gets a signed URL using createdirectupload and uses curl or a similar terminal utility to upload the file to ContentGroove.

Pipe video URLs to Claude Code and generate ContentGroove social clips straight from your terminal.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect ContentGroove MCP to Claude Code

Create your Vinkius account to connect ContentGroove to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup ContentGroove with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Terminal-driven video pipelines

Run Claude Code to process raw footage directly from your shell into ContentGroove. The terminal agent triggers `create_media_from_url` with a piped video URL and lets you know when the ContentGroove import starts. You can pipe the output of `get_media_status` to other terminal utilities to monitor the ContentGroove rendering process. It turns Claude Code into a powerful command-line interface for ContentGroove.

Command-line clip exporting via MCP Server

Extract social-ready highlights by telling Claude Code to fetch clips using `get_media_clips`. Claude Code lists the ContentGroove timestamps and outputs them as clean markdown or JSON directly to stdout. If you need details on a specific segment, Claude Code calls `get_clip_details` to return the precise start and end times. It makes scripting ContentGroove video cut sheets incredibly simple in your terminal.

Headless video project management

Manage your entire ContentGroove video catalog without leaving Claude Code. Claude Code uses `list_media` to scan your active ContentGroove projects and filters them based on your terminal queries. For local files, Claude Code uses `create_direct_upload` to get an upload link and pipes your local binary video directly to ContentGroove. It is a completely headless way to index and store raw footage using Claude Code.

Setup guide

Set up ContentGroove MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see contentgroove-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest ContentGroove transactions." It will automatically discover and invoke the available ContentGroove tools.

Terminal

claude mcp add --transport http contentgroove-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the ContentGroove MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "contentgroove-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by ContentGroove. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect ContentGroove now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about ContentGroove MCP in Claude Code

Run `claude mcp add --transport http contentgroove-mcp -- ` in your terminal to register the ContentGroove server.

Yes, you can run Claude Code headlessly in your CI/CD pipelines to trigger ContentGroove video processing with `create_media_from_url` on every new release.

Claude Code calls `list_all_clips` to fetch your highlights from ContentGroove and formats the output as a JSON stream that you can pipe into other CLI tools.

No, Claude Code gets a signed URL using `create_direct_upload` and uses curl or a similar terminal utility to upload the file to ContentGroove.

All video URLs and upload payloads bypass third-party logging entirely. Claude Code communicates directly with the ContentGroove API, and the MCP connection runs in a sandboxed shell that wipes temporary video clips immediately after your script exits.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript