Create and manage Convertrilo video encoding jobs from MCP clients and agent workflows.
Copy the AI prompt to install this server into Claude Code, Cursor, or another agent β or use 1-click editor setup below.
π‘ Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Type-safe client for the Convertrilo API.
When optimize: "vmaf" is requested, Convertrilo performs VMAF sampling and one optimized final encode. A supplied passes: 2 value remains accepted for backward compatibility, but the API uses and bills one effective pass.
Pricing responses expose requestedPasses and effectivePasses. New integrations should use passes: 1 with VMAF.
The package currently targets modern Node.js runtimes with global fetch. If your runtime does
not provide fetch, pass fetchImpl to the client.
The package includes two executable automation tools:
Use convertrilo for scripts, CI, cron, and local operations. Use convertrilo-mcp
as a stdio MCP server for agent and workflow integrations.
Run convertrilo login or convertrilo init to save an API key locally, or run
convertrilo with no arguments to start the interactive encode wizard. Waiting
commands show terminal progress by default and keep --json clean for scripts.
Shell completion snippets are available with:
See docs/CLI-AND-MCP.md for commands, MCP client config,
S3 output examples, VMAF, two-pass, status, cancel, and balance workflows.
If you want the simplest terminal walkthrough, start with
docs/CLI-QUICKSTART.md.
For agent/client setup, use docs/MCP-QUICKSTART.md.
MCP registry metadata lives in server.json.
Use an API key for server-to-server integrations. Browser apps should call your own backend, then your backend calls Convertrilo.
The examples/ directory contains starter scripts for the main integration paths:
node-url-to-cdn.ts - encode a public URL and receive a signed CDN download URLnode-url-to-s3.ts - encode a public URL and upload the result to S3/S3-compatible storagegoogle-drive-byo-token.ts - upload output to Google Drive using a customer-owned service accountfolder-ingest-s3.ts - queue one encode job per video in an S3 prefixidempotency.ts - safely retry createJob and createJobsBulkwebhook-receiver-hmac.ts - verify managed webhook HMAC signatures from a Node receiverLocal SDK smoke tests use .env, but published SDK users should provide credentials through their
own server environment. Do not put Convertrilo API keys or customer storage tokens in frontend code.
For a complete server-to-server walkthrough covering URL, S3, folder ingest, Google Drive
service accounts, polling, and webhooks, see
docs/API-INTEGRATION-GUIDE.md.
Use an idempotency key when retrying create calls from your backend. Reusing the same key with the same body returns the original response instead of creating duplicate jobs.
Delete managed upload and output objects after a job reaches a terminal state:
The job record and billing history remain available for auditing. Active jobs return the stable
job_active error until they are canceled.
Save reusable encode settings without storing source URLs, storage credentials, or output secrets:
Save reusable delivery targets without storing raw storage secrets in the destination itself. S3 destinations reference an encrypted saved S3 credential:
Terminal users can inspect the same report with:
For S3-compatible services, pass endpoint and usually forcePathStyle: true.
For headless API integrations, save a customer-owned Google service account once. Use a Google Shared Drive for output and add the returned service-account email as a member with permission to create files.
Dashboard Google Picker authorization is separate from SDK automation.
Queue one job per video in an S3 prefix:
Use maxFiles to cap how many discovered videos are queued from a folder.
Queue one job per video in a Google Drive folder:
Convertrilo mints short-lived Google tokens from the encrypted service-account credential when each worker starts.
Poll each returned jobId with client.onDemandStatus(jobId).
Managed webhooks are HMAC signed. You can test a webhook and inspect recent delivery attempts:
No reviews yet β be the first to share how this listing worked for you.
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
[](https://allmcps.com/mcp/convertrilo)<a href="https://allmcps.com/mcp/convertrilo"><img src="https://allmcps.com/api/badge/convertrilo?style=directory" alt="Convertrilo on AllMCPs" /></a>