# Sirv MCP

> Sirv MCP Server lets your AI agent manage every file asset and billing detail in your CDN account. You can list directories, check file metadata—like size or format—monitor bandwidth usage, audit storage consumption, and delete old files. Everything happens via natural language chat, letting you skip the dashboard entirely.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** cdn, digital-asset-management, image-optimization, bandwidth-monitoring, file-storage

## Description

Your AI client can manage every file asset and billing detail in your Sirv CDN account. You don't have to open up a dashboard or run messy command lines—you just talk to your agent, and it does the dirty work.

When you need to handle assets, your agent starts by checking where things are. It can use `list_account_users` to see who has access to the Sirv instance, giving you an immediate roster of collaborators. You can check which custom domains are hooked up by running `list_custom_domains`, making sure every endpoint is correctly configured.

Need to know what's inside a folder? Just tell it the path, and your agent executes `read_directory`. It spits out everything contained in that specific directory—all the files and any subfolders nested deep inside. If you need to find something without knowing the exact location, use `search_files`. This tool searches across your entire asset library, letting you track down assets based on keywords or metadata tags.

Once you pinpoint a file, you can get its technical specs instantly using `get_file_details`. You'll get the format, dimensions, and modification date without ever having to download a single byte. For an overview of everything stored, run `get_account_stats` to check your total storage usage and overall traffic numbers.

Monitoring consumption is straightforward. To drill down into exactly how bandwidth and storage were used over a specific time period, use `get_detailed_usage`. You can also pull the big picture on resource limits by calling `get_account_stats`, giving you an audit of your current usage against your plan's capacity.

If it's time to clean house, your agent handles asset deletion. Running `delete_file` permanently removes a specified file from Sirv storage. Remember, that action is irreversible.

For billing and account audits, the system has two dedicated tools. You can pull specific financial data related to your service plan and usage cycle using `get_billing_info`. For broader metrics on what's happening with the entire account—like checking who needs access or listing domains—you use `list_account_users` and `list_custom_domains`, respectively.

Everything you need—from listing contents via `read_directory` to finding a specific image using `search_files` and then deleting it with `delete_file`—happens entirely through natural chat. It's all about direct action, giving your agent full control over file management and financial tracking in Sirv.

## Tools

### delete_file
Permanently removes a specified file from your Sirv storage. This action is irreversible.

### get_account_stats
Retrieves an overview of your total account storage usage and overall traffic statistics.

### get_billing_info
Pulls specific financial data related to your Sirv service billing cycle.

### get_detailed_usage
Retrieves granular metrics detailing how bandwidth and storage were used over a specific period.

### get_file_details
Fetches technical details for one file, including its format, dimensions, and modification date.

### list_account_users
Shows a list of every user account that has access to the Sirv instance.

### list_custom_domains
Lists all custom domain names configured and linked to your Sirv CDN.

### read_directory
Reads the contents of a specific directory path, listing its contained files and subfolders.

### search_files
Searches across your entire asset library to find files based on keywords or metadata.

## Prompt Examples

**Prompt:** 
```
List the contents of the '/images' directory in my Sirv account.
```

**Response:** 
```
Directory '/images' contains 15 items:
- 12 images (JPEG, PNG, WebP)
- 3 PDF documents
Total size: 48.2 MB. Would you like metadata details for any specific file?
```

**Prompt:** 
```
Show me the bandwidth usage for this month.
```

**Response:** 
```
Bandwidth usage for April 2026:
- Total transferred: 124.5 GB
- Storage used: 2.3 GB / 10 GB
- Requests: 1.2M
- Peak day: April 1 (18.3 GB)
You're at 62.3% of your monthly bandwidth allowance.
```

## Capabilities

### List Directory Contents
Your AI agent lists all files and folders within a specified directory path.

### Search Assets by Metadata
The agent searches your entire asset library for files matching specific criteria or keywords.

### Retrieve File Details
You get technical details (format, size, dates) for a single file without downloading it.

### Delete Files Permanently
The agent removes unused or outdated media assets from your Sirv storage. Note: this action is irreversible.

### Monitor Usage Metrics
You audit current bandwidth usage, total storage consumption, and request counts for the account period.

### Get Billing Records
The agent pulls specific financial details related to your Sirv service plan and usage history.

## Use Cases

### Cleaning up an abandoned product line's assets
The Content Manager knows the 'Fall 2022' folder is full of unused images. Instead of logging in and manually browsing, they ask their agent to `read_directory` first, confirm the contents, then tell it to run `delete_file` on all JPEG assets older than two years. The cleanup happens in three chat commands.

### Debugging a missing product image
The Front-End Developer sees an error for a specific asset ID. They ask the agent to `get_file_details` on that ID immediately. The agent returns the format, size, and last modified date in seconds, letting the developer confirm if the file is corrupt or just mislinked.

### Budget planning for next quarter's growth
The E-commerce Director needs to know if they can handle a massive marketing push. They ask their agent to run `get_account_stats` and follow up with `get_detailed_usage`. This gives them the bandwidth ceiling, allowing them to plan purchases based on hard data.

### Checking compliance after staff turnover
The Ops Engineer suspects former employees left sensitive assets lying around. They use `list_account_users` to confirm who had access and then run a targeted `search_files` query for specific keywords ('draft,' 'internal') across the entire asset pool.

## Benefits

- Audit storage usage instantly. Instead of clicking into the Usage dashboard to see if you're nearing your limit, use `get_account_stats` or `get_detailed_usage` to get a clear percentage and metric breakdown immediately.
- Quickly audit assets for cleanup. Need to find all old product logos? Use `search_files` to target specific metadata across millions of files, bypassing the manual folder navigation entirely.
- Understand your costs without logging into billing portals. Run `get_billing_info` or check usage with `get_detailed_usage` to see exactly what drove up last month's bill—and when it happened.
- Manage content structure via chat. Use `read_directory` to list the contents of a specific folder path, letting you plan out asset changes and confirm file locations before running `delete_file`.
- Inspect assets on the fly. You can run `get_file_details` for any file ID to check its size or format without having to download it first, perfect for web development checks.
- Verify domain setup easily. Use `list_custom_domains` to confirm which custom domains are active and linked to your Sirv account at a glance.

## How It Works

The bottom line is that your agent speaks Sirv's API language, letting you manage assets through conversation instead of a web UI.

1. Add the Sirv integration credentials (Client ID, Client Secret) to your AI toolset.
2. Your AI client uses natural language to generate specific API calls (e.g., 'Show me bandwidth usage for this month').
3. The server executes the call and returns structured data—like file lists or usage graphs—right back into your chat window.

## Frequently Asked Questions

**How do I use the delete_file tool with Sirv MCP Server?**
You tell your agent which file to remove and provide its unique ID or path. Always confirm the specific asset details first using `get_file_details` before running `delete_file`, since this action is permanent.

**What information can I get with get_account_stats?**
This tool gives you a high-level snapshot of your entire Sirv account, showing total storage used and overall traffic statistics. It's the fastest way to check if you have capacity left.

**Can I find specific assets using search_files?**
Yes. You can use `search_files` to look for files across your entire library by keyword, size, or metadata tags. This is way faster than browsing folder structures.

**How do I check my current billing details with get_billing_info?**
Simply ask the agent to run `get_billing_info`. It pulls your account's financial summary, letting you see the costs and usage period without needing to log into a separate finance portal.

**What path do I need for the `read_directory` tool?**
It requires an absolute path starting with "/". This ensures your agent knows exactly which folder to read. You can list the contents of any specific directory in your Sirv account.

**How do I use `get_file_details` to check an asset's dimensions or format?**
The tool retrieves detailed metadata for a single file, giving you its dimensions, format (like JPEG or PNG), size, and modification dates. You just need the specific file ID.

**What information does `list_custom_domains` provide about my account setup?**
This tool lists every custom domain currently configured for your Sirv account. It helps you verify that all external domains are connected and pointing to the correct assets.

**How can I check my detailed usage metrics using `get_detailed_usage`?**
This tool provides a granular breakdown of resource consumption beyond simple totals. It helps you pinpoint exactly where your bandwidth or storage is being used, which is useful for auditing.

**Can it accidentally delete all my files?**
The delete_file tool only removes the specific file you target by path. It cannot delete entire directories at once. Each deletion requires an explicit file path.

**How does authentication work?**
You provide your Client ID and Client Secret. The integration automatically exchanges them for a Bearer token on each session — no manual OAuth setup required.

**What file types does Sirv support?**
Sirv supports images (JPEG, PNG, WebP, SVG, GIF), videos, PDFs, and other static files. The integration can browse and manage all file types stored in your account.