Viralth para agentes y desarrolladores

1. Consigue una clave de API

Créala en tu Dashboard. Hay una clave activa por cuenta, se muestra una sola vez, y cambiarla revoca la anterior al instante. No la pongas en código que compartas.

2. Conecta el servidor MCP

Viralth habla el Model Context Protocol por HTTP. Apunta tu cliente a esta URL y envía la clave en la cabecera Authorization.

https://viralth.com/api/mcp

Claude Code

claude mcp add --transport http viralth https://viralth.com/api/mcp \
  --header "Authorization: Bearer YOUR_KEY"

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "viralth": {
      "url": "https://viralth.com/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

Claude Desktop (claude_desktop_config.json)

Claude Desktop usa los servidores remotos que piden cabecera a través de mcp-remote, que necesita Node.js instalado.

{
  "mcpServers": {
    "viralth": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://viralth.com/api/mcp",
               "--header", "Authorization:${VIRALTH_AUTH}"],
      "env": { "VIRALTH_AUTH": "Bearer YOUR_KEY" }
    }
  }
}

Después pide: «Hazme una miniatura para este vídeo, en español e inglés». Recibes las dos imágenes y se gasta un crédito.

Herramientas

• generate_thumbnail1 crédito por imagen

  Genera de 1 a 4 miniaturas a partir de un título, sin foto de nadie, con el titular como texto editable. Si quieres, las entrega en varios idiomas a la vez.

• localize_thumbnailGratis

  Traduce el texto de una miniatura que ya tienes al español, inglés, portugués, francés, alemán o italiano. El mismo fondo, una imagen por idioma.

• edit_textGratis

  Cambia el texto, la fuente, el color o el tamaño de una capa de texto y devuelve la imagen actualizada.

• list_thumbnailsGratis

  Tus miniaturas más recientes, con el id que necesita cada herramienta.

• get_creditsGratis

  Cuántos créditos te quedan.

• list_youtube_videosGratis

  Los vídeos recientes del canal de YouTube que conectaste en el Dashboard.

• publish_to_youtubeGratis

  Cambia la miniatura de uno de esos vídeos, en un idioma. Cambia el vídeo publicado, así que se pide al agente que confirme antes.

API REST

Las herramientas MCP llaman a los mismos endpoints que usa el Studio, y esos también aceptan tu clave. Con "textMode": "layers" recibes el fondo sin texto y un generationId; si lo omites, el titular va pintado en la imagen.

curl https://viralth.com/api/generate-thumbnail \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"variantId":"A","config":{"title":"I tested every cheap keyboard",
       "visualStyle":"hyperrealistic","subjectPosition":"Right",
       "identityStrength":90,"faceEmotion":"original",
       "subjectMode":"faceless","textMode":"layers","format":"youtube"}}'

Límites, claros

• Cada imagen generada cuesta 1 crédito, igual que en el Studio, y si la generación falla se devuelve.
• Hasta 10 generaciones de imagen y 20 peticiones de otro tipo por minuto y cuenta.
• El servidor MCP crea miniaturas sin personas. Para usar tu cara, de momento, hace falta el Studio.
• El acceso es solo con clave de API. Los conectores que solo admiten OAuth, como los de ChatGPT, aún no funcionan.