MCP (AI Agents)

What is MCP?

MCP (Model Context Protocol) allows AI assistants to interact with APIs directly. Instead of writing curl commands, you can tell your AI: "Post this video to YouTube and TikTok via CodivUpload" — and it will make the API calls for you.

Think of MCP as a translator between your AI assistant and the CodivUpload API. When you say "upload this video to YouTube", the AI uses MCP to figure out the right API endpoint, build the correct request body, authenticate with your key, and make the actual call — all without you writing a single line of code.

Without MCP, you'd need to look up the API docs, construct the curl command, and run it yourself. With MCP, the AI handles all of that. You describe intent; MCP handles execution.

Installation

The codivupload-mcp package runs locally on your machine. It connects to the CodivUpload API using your API key — your key never leaves your local environment.

npm install -g codivupload-mcp
# or use npx (no install needed):
npx -y codivupload-mcp

Quick Setup

1. Get Your API Key

Go to Dashboard → Settings → API Keys and create a new key. It starts with cdv_.

2. Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "codivupload": {
      "command": "npx",
      "args": ["-y", "codivupload-mcp"],
      "env": {
        "CODIVUPLOAD_API_KEY": "cdv_your_api_key"
      }
    }
  }
}

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

3. Claude Code (CLI)

claude mcp add codivupload \
  --command "npx -y codivupload-mcp" \
  --env CODIVUPLOAD_API_KEY=cdv_your_api_key

4. Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "codivupload": {
      "command": "npx",
      "args": ["-y", "codivupload-mcp"],
      "env": {
        "CODIVUPLOAD_API_KEY": "cdv_your_api_key"
      }
    }
  }
}

5. Any MCP Client

Use npx -y codivupload-mcp as the command. Set CODIVUPLOAD_API_KEY as environment variable. The server uses stdio transport.

Authentication

Your API key is stored in your local MCP config file as an environment variable. When the MCP server starts, it reads the key and uses it to authenticate all requests to api.codivupload.com.

• Your key never leaves your machine — it's not sent to Claude, Anthropic, or any third party.
• The MCP server process runs locally and makes direct HTTPS calls to the CodivUpload API.
• Your key is scoped to your workspace — MCP can only access profiles and posts in your account.
• To revoke access, delete the API key from Dashboard → Settings → API Keys.

Available Tools

Once connected, your AI assistant can use these tools:

Platform-Specific Overrides

The publish_post and schedule_post tools accept platform-specific parameters:

Example Prompts

After connecting, try asking your AI:

• "Upload this video to YouTube and TikTok for my_brand profile"
• "Schedule a post to all platforms for tomorrow 9am EST"
• "Show me all scheduled posts for this week"
• "Create an Instagram Reel with this video URL"
• "List my connected profiles and their platform accounts"
• "Start a 24/7 YouTube live stream with this video"
• "What's the status of my last post?"
• "Publish this announcement to LinkedIn and X with different captions"

Environment Variables

Troubleshooting