Skip to main content
Glama
Sign In
yzturkey-mcp

yzturkey-mcp

by emreturkmencom
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

🎬 YZTurkey MCP Server

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

License: MIT Python 3.11+ MCP

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:

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)

Related MCP server: klaket-mcp

🛠️ 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):

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

2. Claude Code

Run in your terminal:

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:

{
  "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:

{
  "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

Available Tools

14 tools
check_duplicate_ideaA

Check if a video idea or concept has already been produced in this channel.

Uses 768-dimensional semantic embeddings (cosine similarity) to compare your idea against the channel's entire past archive. Returns matching past videos and whether it exceeds the duplicate threshold (>0.78).

Args: channel_id: Channel UUID or slug. concept_text: The proposed headline or core concept to test for uniqueness.

Inputs: channel_id (required), concept_text (required). Returns: result

create_channelA

Create a new channel (workspace) in yzturkey.com.

Args: name: Name of the channel (e.g. 'Tarih Meraklısı' or 'Daily Tech Shorts'). channel_context: Channel DNA instruction defining the tone, style, niche, and content rules. visual_style_id: Optional ID of the visual style preset to use for this channel. aspect_ratio: Video aspect ratio, typically '9:16' (Shorts/Reels/TikTok) or '16:9' (YouTube). language: Primary language code ('tr' for Turkish, 'en' for English). description: Brief description of the channel.

Inputs: name (required), language, description, aspect_ratio, +2 more. Returns: result

create_seriesA

Create a new video series (batch) in a channel.

Args: channel_id: Channel UUID or slug. name: Name of the series (e.g. 'Gizemli Olaylar Sezon 1'). production_mode: Video engine mode: 'faceless' (image + audio + effects), 'veo' (Google Veo / Omni video generation), 'quiz', 'map', etc. video_model: Model wireKey if using veo mode (e.g. 'veo_3_1_t2v_fast_4s', 'abra_t2v_4s'). force_external_tts: If True, uses external Gemini TTS voiceover even when video model has embedded audio. duration_min_sec: Minimum target video length in seconds. duration_max_sec: Maximum target video length in seconds. labels: Comma-separated labels or tags. settings: Key-value dictionary of series override settings.

Inputs: name (required), channel_id (required), labels, settings, +5 more. Returns: result

generate_video_batchA

Generate a batch of videos in yzturkey.com for a list of topics or titles.

Creates the batch and themes, queues them for video production and scene generation.

Args: channel_id: Channel UUID or slug. topics: List of video topics or headlines (e.g. ['Dünyanın En Derin Çukuru', 'Mariana Çukurundaki Gizemler']). batch_id: Optional existing series/batch UUID to append these videos to. batch_name: Name for the batch if creating a new one (e.g. 'Derin Denizler #1'). module_type: Video engine: 'veo', 'faceless', 'quiz', 'map'. Default is 'veo'. production_mode: Optional production mode override.

Inputs: topics (required), channel_id (required), batch_id, batch_name, +2 more. Returns: result

get_account_balanceA

Get your user account balance, remaining YZC credits, active subscription plan, and agent message quotas.

Inputs: no named parameters. Returns: result

get_channel_detailsA

Get detailed information about a specific channel, including settings, characters, styles, and publish slots.

Args: channel_id: Channel UUID or slug.

Inputs: channel_id (required). Returns: result

get_channel_statsA

Get channel performance statistics, KPI summaries, and total video counts.

Args: channel_id: Optional channel UUID or slug.

Inputs: channel_id. Returns: result

get_queue_statusA

Inspect active rendering and processing jobs in the yzturkey video pipeline.

Returns the list of videos currently being rendered, scene completion counts, and progress percentages.

Args: channel_id: Optional channel UUID or slug to filter by.

Inputs: channel_id. Returns: result

get_series_detailsA

Get details of a specific series, including all themes/videos inside it and their statuses.

Args: series_id: Series/Batch UUID.

Inputs: series_id (required). Returns: result

list_channelsA

List all social media channels (workspaces) belonging to your yzturkey account.

Returns channel names, IDs, slugs, Channel DNA (channelContext), visual styles, aspect ratios, and total batch/video counts.

Inputs: no named parameters. Returns: result

list_seriesA

List all video series (batches) inside a specific channel.

Args: channel_id: Channel UUID or slug.

Inputs: channel_id (required). Returns: result

search_video_archiveA

Search past produced videos across your channel archive.

Args: channel_id: Optional channel UUID or slug to filter by. query: Search term (keyword, title, or concept). module_type: Filter by module: 'veo', 'faceless', 'quiz', 'map', 'photo_post'. status: Filter by status: 'published', 'completed', 'pending', 'queued', 'failed'. limit: Max results to return (1-50, default 10).

Inputs: limit, query, status, channel_id, +1 more. Returns: result

update_channel_settingsA

Update channel settings or Channel DNA (channelContext).

Whenever you research new content or adjust the channel's creative direction, update the channelContext here to keep all future videos aligned with the channel DNA.

Args: channel_id: Channel UUID or slug. channel_context: Updated Channel DNA instruction. name: Updated channel name. description: Updated channel description. aspect_ratio: '9:16' or '16:9'. language: 'tr' or 'en'. visual_style_id: Preset visual style UUID.

Inputs: channel_id (required), name, language, description, +3 more. Returns: result

update_series_settingsA

Update series (batch) settings, production parameters, and override options.

Args: series_id: Series/Batch UUID. name: New name for the series. production_mode: 'faceless', 'veo', 'quiz', etc. video_model: Model wireKey. force_external_tts: Boolean override for TTS. duration_min_sec: Minimum duration in seconds. duration_max_sec: Maximum duration in seconds. labels: Comma-separated tags. settings: Key-value dictionary of override settings.

Inputs: series_id (required), name, labels, settings, +5 more. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4.1/5.0

    Scored across 14 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes, with list/get/create/update pairs cleanly separated for channels and series. create_series and generate_video_batch have some conceptual overlap, but their descriptions make clear that one sets up series metadata while the other queues actual video production.

    Naming Consistency5/5

    All tool names follow lowercase snake_case with a predictable verb_noun structure: list_*, create_*, get_*_details, update_*_settings, plus a few additional action verbs like generate_, search_, and check_. This makes the set highly consistent and easy to navigate.

    Tool Count5/5

    14 tools is well-scoped for the domain, which spans account info, channel management, series management, video generation, archive search, duplicate detection, and queue monitoring. Each tool addresses a distinct workflow step without feeling padded.

    Completeness4/5

    The suite covers channel and series lifecycle operations well, with create/read/update coverage, plus video generation, search, duplicate checking, and monitoring. Missing delete endpoints for channels/series and lack of cancel/retry for queued jobs are notable but workable gaps.

    Maintenance

    ActivitySlowing
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    Related MCP Servers

    • klaket-mcp

      huseyinstif
      A
      license
      A
      quality
      C
      maintenance
      Let AI agents watch videos: local transcripts, speaker labels, scenes, chapters and exact-moment search from any video URL or file. Fully local, no API keys.
      4
      3
      AGPL 3.0

    • YouTube Studio MCP

      hygef-v4
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to manage YouTube channels directly, including video publishing, SEO optimization, playlist curation, community interaction, and traffic analytics, all through local OAuth.
      2
      MIT