scroll-world
A skill that turn any brand into a scrollable 3D world landing page
Compliance-aware MCP server for YouTube publishing, analytics and creator insights.
Texto original del autor
Skills que enseñan a la IA este tipo de trabajo; funcionan junto a este
A skill that turn any brand into a scrollable 3D world landing page
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 0/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 3/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 3/100 |
Calidad: Pasó 2/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala tubekit. Sigue https://mcp.popnx.com/i/santiriera626-tubekit-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 2/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
1 ajuste(s) que rellenar (TUBEKIT_OAUTH_CLIENT_SECRETS_PATH) · Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server tubekit para Claude en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "tubekit": { "command": "uvx", "args": [ "tubekit-mcp" ], "env": { "TUBEKIT_OAUTH_CLIENT_SECRETS_PATH": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En TUBEKIT_OAUTH_CLIENT_SECRETS_PATH deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de tubekit aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
TUBEKIT_OAUTH_CLIENT_SECRETS_PATH Ruta a tu propio JSON de cliente OAuth de Google Cloud. Necesario para renovar los tokens de acceso. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
SettingsDeveloperEdit Config
{
"mcpServers": {
"tubekit": {
"command": "uvx",
"args": [
"tubekit-mcp"
],
"env": {
"TUBEKIT_OAUTH_CLIENT_SECRETS_PATH": "your-value"
}
}
}
}Usa tubekit y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando tubekit o muestra una herramienta de tubekit en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
TUBEKIT_MASTER_KEY_PATH Ruta a la clave Fernet que cifra los tokens OAuth almacenados. El servidor no se inicia sin ella. TUBEKIT_STATE_DB_PATH Archivo SQLite que guarda el registro de auditoría, el libro de cuotas y el estado de los canales. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar tubekit
tubekit se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar tubekit
B · Otros en Marketing y redes sociales que funcionan con ChatGPT
Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave
Funciona con Claude Code, pero hay que preparar algo antes
1 ajuste(s) que rellenar (TUBEKIT_OAUTH_CLIENT_SECRETS_PATH) · Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server tubekit para Claude Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user tubekit --env TUBEKIT_OAUTH_CLIENT_SECRETS_PATH=your-value -- uvx tubekit-mcp 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En TUBEKIT_OAUTH_CLIENT_SECRETS_PATH deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de tubekit aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
TUBEKIT_OAUTH_CLIENT_SECRETS_PATH Ruta a tu propio JSON de cliente OAuth de Google Cloud. Necesario para renovar los tokens de acceso. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user tubekit --env TUBEKIT_OAUTH_CLIENT_SECRETS_PATH=your-value -- uvx tubekit-mcpDeberías ver tubekit en la lista como conectado
Usa tubekit y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando tubekit o muestra una herramienta de tubekit en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
TUBEKIT_MASTER_KEY_PATH Ruta a la clave Fernet que cifra los tokens OAuth almacenados. El servidor no se inicia sin ella. TUBEKIT_STATE_DB_PATH Archivo SQLite que guarda el registro de auditoría, el libro de cuotas y el estado de los canales. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
1 ajuste(s) que rellenar (TUBEKIT_OAUTH_CLIENT_SECRETS_PATH) · Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server tubekit para Cursor en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "tubekit": { "command": "uvx", "args": [ "tubekit-mcp" ], "env": { "TUBEKIT_OAUTH_CLIENT_SECRETS_PATH": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En TUBEKIT_OAUTH_CLIENT_SECRETS_PATH deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de tubekit aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
TUBEKIT_OAUTH_CLIENT_SECRETS_PATH Ruta a tu propio JSON de cliente OAuth de Google Cloud. Necesario para renovar los tokens de acceso. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
En la configuración de tubekit, TUBEKIT_OAUTH_CLIENT_SECRETS_PATH está vacío; añade tu clave y guarda
Usa tubekit y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando tubekit o muestra una herramienta de tubekit en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
TUBEKIT_MASTER_KEY_PATH Ruta a la clave Fernet que cifra los tokens OAuth almacenados. El servidor no se inicia sin ella. TUBEKIT_STATE_DB_PATH Archivo SQLite que guarda el registro de auditoría, el libro de cuotas y el estado de los canales. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
1 ajuste(s) que rellenar (TUBEKIT_OAUTH_CLIENT_SECRETS_PATH) · Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server tubekit para VS Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "tubekit": { "type": "stdio", "command": "uvx", "args": [ "tubekit-mcp" ], "env": { "TUBEKIT_OAUTH_CLIENT_SECRETS_PATH": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En TUBEKIT_OAUTH_CLIENT_SECRETS_PATH deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de tubekit aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
TUBEKIT_OAUTH_CLIENT_SECRETS_PATH Ruta a tu propio JSON de cliente OAuth de Google Cloud. Necesario para renovar los tokens de acceso. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
En la configuración de tubekit, TUBEKIT_OAUTH_CLIENT_SECRETS_PATH está vacío; añade tu clave y guarda
Usa tubekit y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando tubekit o muestra una herramienta de tubekit en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
TUBEKIT_MASTER_KEY_PATH Ruta a la clave Fernet que cifra los tokens OAuth almacenados. El servidor no se inicia sin ella. TUBEKIT_STATE_DB_PATH Archivo SQLite que guarda el registro de auditoría, el libro de cuotas y el estado de los canales. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --scope user tubekit --env TUBEKIT_OAUTH_CLIENT_SECRETS_PATH=your-value -- uvx tubekit-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"tubekit": {
"command": "uvx",
"args": [
"tubekit-mcp"
],
"env": {
"TUBEKIT_OAUTH_CLIENT_SECRETS_PATH": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"tubekit": {
"command": "uvx",
"args": [
"tubekit-mcp"
],
"env": {
"TUBEKIT_OAUTH_CLIENT_SECRETS_PATH": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"tubekit": {
"type": "stdio",
"command": "uvx",
"args": [
"tubekit-mcp"
],
"env": {
"TUBEKIT_OAUTH_CLIENT_SECRETS_PATH": "your-value"
}
}
}
}TUBEKIT_MASTER_KEY_PATH envTUBEKIT_OAUTH_CLIENT_SECRETS_PATH obligatorio envTUBEKIT_STATE_DB_PATH envDescripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
pypi: tubekit-mcpSegún cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 20 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub santiriera626, dueña del repo
Último cambio de código: hace 3 meses
GitHub no pudo identificar el tipo de licencia; abre el archivo para comprobarlo
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Sin entradas en OSV.dev para tubekit-mcp@0.3.0
Solo revisa esta versión del paquete, no todas sus dependencias · revisado 16 nov 2026
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/santiriera626-tubekit-mcp)Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 2 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez hace 3 meses, y la última versión (0.3.0) llegó al registro hace 3 meses.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.
En la misma categoría: Relaticle, ChatbotX, X (Twitter) MCP Server by Xquik, Betterlytics, BibiGPT YouTube Video Summarizer
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Open-source CRM your AI agents can write to: companies, people, opportunities, tasks and notes.
Omnichannel customer messaging, CRM contacts, flows, sequences, broadcasts, and AI automation.
Xquik is the world's fastest and cheapest X (Twitter) data API with the most complete X data.
Query your Betterlytics web analytics from AI agents: traffic, funnels, journeys, errors, uptime.
AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.
| Este tubekit | Relaticle | ChatbotX | X (Twitter) MCP Server by Xquik | Betterlytics | BibiGPT YouTube Video Summarizer | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada |
| Necesita clave | No | No | No | No | Sí | No |
| Se añade con + en Claude | No | No | No | No | No | No |
| Revisiones básicas | 2/3 | 4/4 | 4/4 | 4/4 | 4/4 | 4/4 |
| Licencia | NOASSERTION | AGPL-3.0 | NOASSERTION | MIT | AGPL-3.0 | MIT |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
Compliance-aware Model Context Protocol server for YouTube publishing, analytics, and creator insights — every action gated, metered, and audited before it touches a channel.
tubekit-mcp is an MCP server: you connect it to an MCP client (Claude Desktop, Claude Code, …) and the assistant can then publish and manage videos on a YouTube channel on your behalf, with compliance checks, quota accounting, idempotent uploads and a tamper-evident audit log on every state-changing call. Licensed under FSL-1.1-MIT — run and self-host it freely, commercially or not; each release becomes plain MIT two years after publication.
A single tool call (e.g. upload_video) flows through a compliance gate, a quota / idempotency ledger, an OAuth refresh, the YouTube API, and a tamper-evident audit row — with the pure core kept free of protocol concerns, a boundary enforced in CI by an AST fitness test (tests/unit/services/test_no_fastmcp_imports.py).
flowchart LR
client["MCP client (Claude Desktop / Code)"] subgraph edge["Protocol edge"] transport["Transport stdio · HTTP + Bearer"] tool["Tool wrapper"] end subgraph core["Pure core — no protocol imports (CI-enforced)"] compliance{"Compliance gate"} ledger["Quota + idempotency ledger"] oauth["OAuth refresh (Fernet at rest)"] end upstream["YouTube Data / Analytics API"] audit[("Tamper-evident hash-chained audit log")]
client --> transport --> tool --> compliance compliance -->|pass| ledger --> oauth --> upstream compliance -->|fail| suggestion["Suggestion → agent retries"] tool -. audited .-> audit ledger -. audited .-> audit oauth -. audited .-> audit
Why this exists. Agents are starting to operate real YouTube channels —
and a channel is an asset you can lose. One bad call can publish a video
that violates policy, burn the day's API quota (an upload costs 1600 of the
default 10,000 daily units), or double-publish on a retry. Generic YouTube
wrappers hand the agent the raw API;
tubekitwraps every call in the
guardrails an unattended operator needs: a compliance gate *before* anything
goes live, quota accounted before it is spent, idempotent retries, OAuth
tokens encrypted at rest (fingerprint-only logging), and a tamper-evident
audit chain of everything the agent did. Full design rationale in
Before an assistant can act on a channel you need, once per channel:
get_analytics) enabled.client_secret.json.The OAuth grant is interactive and only happens here — tubekit stores the resulting refresh token Fernet-encrypted and never prints it. Never used Google Cloud Console? docs/runbooks/gcp-setup.md walks the whole thing from zero (project, APIs, consent screen, client type, and the two Google policies — token expiry in testing, private-locked uploads for unaudited projects — that surprise people later). The consent flows themselves are in docs/runbooks/oauth-bootstrap.md.
From PyPI:
uv tool install tubekit-mcp # installs the tubekit / tubekit-mcp-* commands
Use uv tool install, not uvx, for a real setup: the one-time steps below need the tubekit CLI to still be there afterwards. uvx tubekit-mcp runs the stdio server from a throwaway environment, which is what an MCP client's config points at once the setup is done.
The server will not start yet, and that is deliberate — it refuses to run without a master key rather than inventing one, since that key is what encrypts your OAuth tokens at rest. One-time setup below is the two commands that fix it.
Or from source, for development:
git clone https://github.com/santiriera626/tubekit-mcp.git tubekit-mcp && cd tubekit-mcp
uv sync --all-extras # installs the tubekit / tubekit-mcp-* entry points make db-upgrade # builds the state schema (wraps tubekit db upgrade;
tubekit db current prints the applied revision)
(uv itself installs with curl -LsSf https://astral.sh/uv/install.sh | sh.)
The compliance engine is pure-local, so you can watch the gate and its self-correction Suggestions work before touching Google Cloud:
cat > video.json <<'EOF'
{ "title": "Test Upload — Compliance Gate Demo", "description": "Demo description for the compliance gate.", "tags": ["demo", "test"], "ai_disclosure": false, "made_for_kids": null, "category_id": "10" } EOF uv run tubekit compliance test video.json
Compliance: PASSED (8 rules evaluated)
WARNING AI_DISCLOSURE_MISSING: AI disclosure flag is false; confirm this is the channel owner's intended policy for AI-generated content. suggestion: action=set field=metadata.ai_disclosure value=True WARNING KIDS_FLAG_NOT_SET: made_for_kids is unset; set it explicitly to true or false (this rule does not classify by content). suggestion: action=set field=metadata.made_for_kids value=False
An error-severity violation — say a 126-character title — fails the gate with exit 1 and a machine-applicable fix (suggestion: action=truncate field=metadata.title value=100). That is the same Suggestion an agent receives from a rejected upload_video and applies before retrying (ADR D8). tubekit compliance list prints the rule catalog; tubekit compliance manifest exports it for external auditors.
Rather not type the commands above yourself? Paste the block below into Claude Code (or any coding agent with shell access) and it will clone, install and register the server for you. It stops at the boundary above: no Google account, client_secret.json or OAuth consent is involved.
Install tubekit-mcp and register it as an MCP server. Stop and report if any step fails.
Do not run tubekit auth setup-channel or open any Google consent screen — OAuth channel bootstrap is a separate, human-in-the-loop step documented in docs/runbooks/oauth-bootstrap.md. Stop after step 4 and tell me to run that myself.
Restart your MCP client after registration; it can now call tubekit.health() and list the full tool catalog. Every tool that takes a channel argument — validate_compliance included — needs a configured channel, which means completing One-time setup — including the OAuth consent in docs/runbooks/oauth-bootstrap.md — yourself. The compliance gate itself is testable without any channel via step 3's tubekit compliance test.
# 1. Create the Fernet master key used to encrypt stored tokens (mode 0600).
tubekit auth init-master-key
tubekit auth setup-channel mychannel \ --channel-id UCxxxxxxxxxxxxxxxxxxxxxx \ --gcp-project my-gcp-project \ --client-secrets ./client_secret.json \ --scopes youtube.upload,youtube.readonly
tubekit auth setup-channel mychannel \ --channel-id UCxxxxxxxxxxxxxxxxxxxxxx \ --gcp-project my-gcp-project \ --client-secrets ./client_secret.json \ --scopes youtube.upload,youtube.readonly \ --device-code
mkdir -p ~/.config/tubekit/channels cat > ~/.config/tubekit/channels/mychannel.toml <<'EOF' [mychannel] channel_id = "UCxxxxxxxxxxxxxxxxxxxxxx" gcp_project_id = "my-gcp-project" oauth_scopes = [ "https://www.googleapis.com/auth/youtube.upload", "https://www.googleapis.com/auth/youtube.readonly", ] EOF
show prints one channel's status (token fingerprint only),list prints every configured aliastubekit channels show mychannel --channels-dir ~/.config/tubekit/channels tubekit channels list --channels-dir ~/.config/tubekit/channels
Most clients launch the server over stdio. Add this to the client's MCP config (for Claude Desktop: claude_desktop_config.json):
{
"mcpServers": { "tubekit": { "command": "tubekit-mcp-stdio", "env": { "TUBEKIT_STATE_DB_PATH": "/absolute/path/to/state.db", "TUBEKIT_MASTER_KEY_PATH": "/absolute/path/to/master.key" } } } }
Restart the client. The assistant now sees the tools below plus a tubekit.health() probe. Ask it, e.g., *"upload ./intro.mp4 to mychannel"* and it will call upload_video, which gates on compliance, charges quota, refreshes OAuth and writes an audit row — all transparently.
| Tool | What it does | OAuth scope | Quota |
|---|---|---|---|
validate_compliance(channel, metadata, thumbnail_present=False) | Run the rule registry against metadata; returns a ComplianceReport. Pure-local, no YouTube call. | — | 0 |
| `upload_video(channel, video_path, metadata, idempotency_key, privacy_status="private", notify_subscr