# 🎬 YZTurkey MCP Server

> Official Model Context Protocol (MCP) Server for [yzturkey.com](https://yzturkey.com) — autonomous AI video production, channel management, and rendering pipelines for local agents.

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
[![MCP](https://img.shields.io/badge/protocol-MCP-purple.svg)](https://modelcontextprotocol.io/)

Turn **Google Antigravity**, **Claude Code**, **Cursor**, or **ChatGPT Codex** on your machine into an autonomous video production studio! 

While web agents are confined to sandboxes, your local agent has access to **web search, local brand assets, script archives, and terminal tools**. With `yzturkey-mcp`, your agent connects directly to yzturkey's video rendering engine to create channels, define Channel DNA, schedule series, generate AI videos, and monitor rendering pipelines.

---

## ⚡ Quick Start

No installation required! You can run the server directly using [`uvx`](https://docs.astral.sh/uv/):

```bash
export YZTURKEY_API_KEY="yzt_live_your_key_here"
uvx yzturkey-mcp
```

*(You can generate your personal API Key at `yzturkey.com/settings?tab=api`)*

---

## 🛠️ Tools Available to Your Agent

### 📺 Channels (Workspaces)
- `list_channels()`: List all channels with video counts, DNA, and visual styles.
- `create_channel(name, channel_context, ...)`: Create a new channel with specific tone, language, and aspect ratio.
- `get_channel_details(channel_id)`: Inspect channel configuration, active characters, and publish slots.
- `update_channel_settings(channel_id, ...)`: Update Channel DNA (`channelContext`) or visual presets.

### 🎞️ Series (Batches)
- `list_series(channel_id)`: List video series inside a channel.
- `create_series(channel_id, name, production_mode, ...)`: Create a new video series (Veo, Faceless, Quiz, Map, etc.).
- `get_series_details(series_id)`: Inspect themes/videos and production progress in a series.
- `update_series_settings(series_id, ...)`: Update series parameters and overrides.

### 🎥 Video Production & Archive
- `produce_custom_video(channel_id, title, concept, scenes, ...)`: Produce and queue a multi-scene AI video with custom storyboard prompts, dialogues, and lengths.
- `generate_video_batch(channel_id, topics, ...)`: Queue video topics or raw multi-scene script text for AI video and scene rendering.
- `search_video_archive(channel_id, query, ...)`: Search past generated videos by keyword or status.
- `check_duplicate_idea(channel_id, concept_text)`: 768-dimensional semantic cosine similarity test to prevent repeating past video ideas.

### 📊 Queue & Account
- `get_queue_status(channel_id)`: Real-time progress and active rendering scenes in the pipeline.
- `get_channel_stats(channel_id)`: Key performance indicators and publication counts.
- `get_account_balance()`: Remaining YZC credits, bonus credits, and active plan.

---

## 🔌 Agent Configurations

### 1. Google Antigravity
Add to your Antigravity MCP settings (e.g. `~/.gemini/antigravity/mcp_config.json`):

```json
{
  "mcpServers": {
    "yzturkey": {
      "command": "uvx",
      "args": ["yzturkey-mcp"],
      "env": {
        "YZTURKEY_API_KEY": "yzt_live_YOUR_API_KEY_HERE"
      }
    }
  }
}
```

### 2. Claude Code
Run in your terminal:

```bash
claude mcp add yzturkey uvx yzturkey-mcp --env YZTURKEY_API_KEY=yzt_live_YOUR_API_KEY_HERE
```

### 3. Claude Desktop
Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "yzturkey": {
      "command": "uvx",
      "args": ["yzturkey-mcp"],
      "env": {
        "YZTURKEY_API_KEY": "yzt_live_YOUR_API_KEY_HERE"
      }
    }
  }
}
```

### 4. Cursor / Windsurf
Add to `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "yzturkey": {
      "command": "uvx",
      "args": ["yzturkey-mcp"],
      "env": {
        "YZTURKEY_API_KEY": "yzt_live_YOUR_API_KEY_HERE"
      }
    }
  }
}
```

---

## 💡 Example Prompt for Your Agent

> *"Web'de son 24 saatte yapay zeka ve robotik alanında en çok konuşulan 3 haberi araştır. 'Teknoloji Günlüğü' kanalımda yeni bir seri aç. Kanal DNA'sına uygun 3 video fikri hazırla, daha önce bu konuları işleyip işlemediğimizi `check_duplicate_idea` ile kontrol et ve onaylarsam yzturkey video kuyruğuna ver."*

---

## 🔒 Security & Privacy

- **Zero Secrets**: This repository does not contain any API keys, credentials, or private tokens.
- **Client-Side Auth**: All authentication is handled dynamically via `YZTURKEY_API_KEY`.
- **Hashed Storage**: On `yzturkey.com`, all API keys are hashed with SHA-256 and only the prefix is visible after creation.

---

## 📄 License

MIT License © 2026 [yzturkey.com](https://yzturkey.com)