# ByteNite MCP

> ByteNite manages distributed video encoding and media processing jobs directly from your AI agent. Trigger new encodings, track job progress, list available templates, and monitor system health without leaving your workspace. It's designed for developers needing to orchestrate complex media workflows conversationally.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** video-encoding, distributed-computing, media-processing, job-orchestration, cloud-rendering

## Description

Managing large-scale video assets used to mean jumping between a dashboard, checking status codes, manually verifying storage limits, and submitting forms just to start an encoding job. This MCP lets you bypass all that friction. You talk to your agent about the video task—say, 'I need this marketing reel in ProRes HQ for Instagram.' Your agent handles the rest: it checks which templates are available, confirms system health, and kicks off the `create_encoding_job` right away. If you need to know where the final file will land or what storage buckets are configured, you just ask. It’s about getting the results—the finished files and the operational insights—without ever needing to click a button on a separate website. For developers building pipelines, this integration through Vinkius gives your AI client instant access to the entire video processing ecosystem.

## Tools

### create_encoding_job
Starts a new video encoding task using specified parameters.

### get_account_info
Fetches core profile statistics and usage metrics for your account.

### get_app
Retrieves detailed information about a single specialized processing application.

### get_encoding_job
Gets the current status and details for one specific encoding job ID.

### get_system_info
Retrieves real-time operational metrics and health status of the ByteNite infrastructure.

### get_template
Fetches all configuration details for a single encoding template.

### list_apps
Lists every specialized processing application available in the ByteNite system.

### list_storage_buckets
Shows every configured storage bucket where media assets can be saved.

### list_encoding_jobs
Provides a summary list of all video encoding jobs, active or finished.

### list_templates
Lists all available encoding templates you can use to start a job.

## Prompt Examples

**Prompt:** 
```
List all my current video encoding jobs in ByteNite.
```

**Response:** 
```
I've retrieved your jobs. You have 3 active encodings: 'Marketing Video' (ID: job_1, 80% done), 'Product Demo' (ID: job_2, Finished), and 'Tutorial' (ID: job_3, Processing).
```

**Prompt:** 
```
Show the available encoding templates.
```

**Response:** 
```
Retrieving templates... You have 'H.264 1080p' (ID: temp_1), 'WebM 720p' (ID: temp_2), and 'ProRes HQ' (ID: temp_3) configured.
```

**Prompt:** 
```
Encode video https://example.com/source.mp4 using template temp_123.
```

**Response:** 
```
New encoding job created! ByteNite is now processing your video with ID job_99283. I will notify you once the output is ready for download.
```

## Capabilities

### Initiate Video Encoding
Start new media encoding tasks using predefined templates and source files.

### Monitor Job Status
Get the current progress, output URLs, and metadata for any running or completed video job.

### Manage Templates & Assets
List all available encoding profiles and check your account's storage bucket configurations.

### Assess System Health
Retrieve real-time status reports on the underlying ByteNite infrastructure.

### View Account Data
Access profile statistics and overall usage metrics straight through your agent.

## Use Cases

### Archiving Quarterly Reports
A Media Ops Manager needs to encode 50 videos for an annual report. Instead of manually submitting 50 jobs, they prompt their agent: 'Run the quarterly package using template ProRes HQ.' The MCP runs `create_encoding_job` 50 times, and then uses `list_storage_buckets` to confirm that a dedicated 'Annual Report' bucket is ready for all output URLs.

### Debugging a Failed Job
A Video Engineer knows an encoding job failed but can’t tell why. They prompt the agent to check the status, which runs `get_encoding_job`. The MCP retrieves the detailed metadata and error code, telling them if the issue was corrupt source material or a template misconfiguration.

### Building a Media Pipeline
A Developer needs to write code that checks system limits before running any encoding. They first use `get_account_info` to check storage capacity, then they use `list_apps` to see which specialized tools are available before finally calling `create_encoding_job`.

### Checking Template Consistency
A Producer needs to know what's possible. They ask the agent to list all encoding templates, running `list_templates`. This immediately shows them if they can switch from H.264 1080p to a newer format like WebM without having to consult documentation.

## Benefits

- Instant status checks: Instead of visiting a dashboard, simply ask to `list_encoding_jobs` and get the progress (e.g., 80% done) for multiple files instantly.
- Predictable output: Use `list_templates` first to confirm available profiles before running `create_encoding_job`, ensuring consistent video quality every time.
- System visibility: When performance lags, run `get_system_info` immediately. This lets you know if the issue is with your files or the platform itself.
- Storage management: Check `list_storage_buckets` and `get_account_info` to see exactly where data is going and how much space you have left.
- Developer speed: Developers can embed job orchestration—from listing templates to running a full encoding sequence—into automated pipelines using the MCP.

## How It Works

The bottom line is: your AI client uses this connection to talk to ByteNite’s systems directly, turning complex dashboard work into simple conversation.

1. Subscribe to the ByteNite MCP and enter your unique API key.
2. Your AI client sends a command—like 'List all available templates'—to the MCP.
3. The MCP executes the necessary tool calls, retrieves the data (e.g., template names), and passes that structured result back to your agent for you to use.

## Frequently Asked Questions

**How do I find out if my encoding job failed using get_encoding_job?**
The `get_encoding_job` tool returns detailed metadata, including the final status and any associated error codes. This tells you exactly why the job stopped or finished.

**What is the difference between list_templates and get_template?**
`list_templates` gives you a directory of all available profiles (e.g., 'WebM 720p', 'ProRes HQ'). `get_template` pulls deep, specific details about one single template using its ID.

**Do I need to use list_storage_buckets before creating a job?**
It's good practice. Running `list_storage_buckets` first lets you confirm which buckets are configured and available for output, preventing potential save failures.

**Can I see my account usage with get_account_info?**
Yes. This tool pulls your core profile statistics, letting you check current storage limits and overall usage metrics directly through the MCP.

**How can I use list_apps to check which specialized processing tools are available in my ByteNite ecosystem?**
It returns a comprehensive catalog of all integrated apps. This lets you see what specialized services exist, like watermarking or metadata extraction, so your AI client knows exactly what functions it can call for complex media tasks.

**If I suspect performance issues, how should I use get_system_info to check the ByteNite infrastructure health?**
This tool provides real-time metrics on the core system's operational status. You get immediate data points on uptime and resource utilization, which helps you confirm if a bottleneck is within the ByteNite platform itself.

**When I list_encoding_jobs, can I filter or sort the results to find specific projects?**
Yes, you can often narrow down the output by adding filters like project name or date range. This prevents your agent from dumping hundreds of jobs and helps it pinpoint exactly what you're looking for.

**What details do I need to provide when using create_encoding_job to make sure the task runs correctly?**
You must specify three things: the source file location, a valid template ID from list_templates, and the desired output format. Providing these inputs upfront prevents job failures.

**Can I check the progress of a video encoding job using the agent?**
Yes! Use the `get_encoding_job` tool with the Job ID. Your agent will fetch the real-time progress percentage and current status directly from ByteNite.

**How do I list all the available encoding templates?**
Simply ask the agent to `list_templates`. It will retrieve all the configured encoding profiles in your ByteNite account, making it easy to find the right settings for a new job.

**Does the integration allow creating a new encoding job?**
Yes. Use the `create_encoding_job` action and provide the Template ID and the input video URL. The job will be queued and processed by the ByteNite distributed network instantly.