Zype MCP Client

Connect Claude Desktop and other MCP clients to Zype's video platform via mcp.zype.com.

Quick Start

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "zype": {
      "command": "npx",
      "args": ["-y", "@zype-com/mcp"],
      "env": {
        "ZYPE_API_KEY": "your_admin_api_key",
        "ZYPE_MCP_MODE": "safe"
      }
    }
  }
}

Cursor IDE

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

{
  "mcpServers": {
    "zype": {
      "command": "npx",
      "args": ["-y", "@zype-com/mcp"],
      "env": {
        "ZYPE_API_KEY": "your_admin_api_key",
        "ZYPE_MCP_MODE": "safe"
      }
    }
  }
}

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | ZYPE_API_KEY | Yes | - | Your Zype Admin API key | | ZYPE_MCP_MODE | No | safe | Access mode: readonly, safe, or full | | ZYPE_MCP_URL | No | https://mcp.zype.com/mcp | Override MCP endpoint | | ZYPE_MCP_DEBUG | No | false | Enable debug logging |

Access Modes

We strongly recommend using safe mode (the default):

| Mode | Description | |------|-------------| | readonly | Only read operations allowed. Write/delete tools are not exposed. | | safe | Read + write allowed. Destructive operations require confirmation. | | full | All operations allowed without confirmation. Use with caution. |

Safe Mode Example

In safe mode, destructive operations require explicit confirmation:

User: "Delete video abc123"
Claude: This will permanently delete the video. I'll need you to confirm.
        delete_video(video_id: "abc123") → requires_confirmation: true

User: "Yes, delete it"  
Claude: delete_video(video_id: "abc123", confirm: true) → success

Getting Your API Key

1. Log in to your Zype account
2. Navigate to Settings → API Keys
3. Copy your Admin API Key (not Player or Read-Only)

For detailed instructions, see Zype API Keys Documentation.

How It Works

This package is a lightweight proxy that:

1. Reads MCP messages from stdin (what Claude Desktop sends)
2. Forwards them to mcp.zype.com via HTTPS
3. Returns responses to stdout (what Claude Desktop reads)

All video platform logic runs on Zype's servers, so you always get the latest features without updating the client.

Available Tools

Once connected, you'll have access to 58+ tools for:

• Videos: List, create, update, delete, download
• Transcriptions: AI-powered transcription and translation
• Playlists: Full CRUD and video management
• Categories: Organize content
• Subtitles: Manage captions
• Analytics: Plays, viewers, watch time, revenue
• Monetization: Subscriptions, plans, transactions

See the full Tool Reference for details.

Troubleshooting

"ZYPE_API_KEY environment variable is required"

Make sure you've added the env block to your MCP config:

"env": {
  "ZYPE_API_KEY": "your_actual_api_key_here",
  "ZYPE_MCP_MODE": "safe"
}

"Authentication failed"

• Verify your API key is correct
• Ensure you're using an Admin API key (not Player or Read-Only)
• Check the key hasn't been revoked

"Rate limit exceeded"

The server limits requests per API key. Wait a moment and try again, or contact Zype support if you need higher limits.

Debug Mode

Enable debug logging to see what's happening:

"env": {
  "ZYPE_API_KEY": "your_api_key",
  "ZYPE_MCP_MODE": "safe",
  "ZYPE_MCP_DEBUG": "true"
}

Debug output goes to stderr and won't interfere with MCP protocol.

Support

• Documentation: mcp.zype.com
• Tool Reference: mcp.zype.com/docs
• Zype Support: support.zype.com
• API Docs: docs.zype.com

License

MIT