# Tencent COS MCP

> Tencent COS / 腾讯云对象存储 connects your AI agent to China's leading cloud storage platform. It lets you manage massive file archives and digital assets using natural language commands. You can upload new content, check if files exist before deployment, get detailed metadata reports, and list directory contents—all without ever logging into the Tencent Cloud Console.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** object-storage, cdn, file-management, data-lifecycle, cloud-assets, metadata-management

## Description

This connector gives your AI agent control over complex cloud storage operations, treating your entire asset library like an extension of your chat window. You can instantly upload text assets or delete old files across multiple buckets using simple prompts. Need to audit a directory? Your agent handles listing contents and checking object headers so you know exactly what's in place. It even generates public access points for shared content on demand. Because this MCP is hosted on Vinkius, your AI client gains instant access to dozens of services—making it the single source for orchestrating both your cloud storage and other business processes. You just tell your agent what you need done with your files, and it handles the infrastructure calls.

## Tools

### check_object_exists
Confirms whether a specific file key is present in the bucket.

### copy_object
Duplicates an existing object from one location to another within your bucket.

### delete_object
Permanently removes a specified file from the COS storage.

### download_object_text
Downloads the text content of an object and presents it to your agent for use.

### get_bucket_acl
Retrieves the current access permissions settings for the entire bucket.

### get_object_metadata
Fetches technical details about a file, such as its size or content type.

### head_bucket
Checks if the bucket itself is correctly configured and accessible via API.

### list_objects
Use prefix to filter by path.

List objects in the COS bucket

### list_root_objects
List top-level objects and folders

### upload_object
Max 5GB per request.

Upload text content to COS

## Prompt Examples

**Prompt:** 
```
List all files in the root of my Tencent COS bucket.
```

**Response:** 
```
I've retrieved the root object list. I found 10 items, including 'index.html' and 'uploads/'. Would you like to see the contents of a specific folder or get metadata for a file?
```

**Prompt:** 
```
Check if the file 'backups/db_init.sql' exists in COS.
```

**Response:** 
```
I've performed a metadata check for that key. The file `backups/db_init.sql` exists in your bucket. It was created on Oct 27, 2023 and has a size of 1.2 MB. Should I generate a public URL for it?
```

**Prompt:** 
```
Get the metadata for 'static/css/main.css'.
```

**Response:** 
```
I've retrieved the metadata for that object. The Content-Type is 'text/css' and it has an ETag of '88210934...'. The storage class is Standard. Would you like me to download the text content for you to audit?
```

## Capabilities

### Check File Existence
Quickly verifies if a specific file or object key is present in the bucket.

### Get Object Details
Retrieves technical metadata, like content type and storage class, for any given asset.

### List Folder Contents
Displays the full list of files or subdirectories within a specified path using advanced filters.

### Upload and Modify Assets
Sends text content to the cloud, uploads new objects, or copies existing ones within the storage structure.

### Download Text Content
Pulls down the raw text data from a specified object for immediate use by your agent.

## Use Cases

### Auditing a client's document archive
An operations manager needs to know if 'ClientX/Q3/final.pdf' exists and what its last modified date was. Instead of manually checking the file path, they ask their agent to check_object_exists and get_object_metadata, getting a precise answer instantly.

### Preparing content for public release
A marketing team needs to make five new images available. They ask their agent to upload_object the text descriptions and generate public endpoints automatically, making them accessible without manual URL setup.

### Verifying data integrity before migration
A developer must confirm that a critical configuration file is still present before deploying code. They use head_bucket first to verify the entire bucket connection, then check_object_exists for the specific key.

### Analyzing old data structures
An auditor needs to see every folder and subfolder under 'archive/'. Instead of traversing deep directory trees, they use list_objects with advanced filters to get a complete map.

## Benefits

- You gain immediate visibility into your entire storage setup. Instead of clicking through multiple tabs to check permissions, you just ask the agent to get bucket access permissions.
- Asset management becomes instant. Need to move a file? Use the copy_object tool to duplicate content without manual steps, and use delete_object when an asset is retired.
- Audit files with precision. The list_objects tool lets you filter by path or delimiter, organizing your storage structure in a single request rather than piecing together results.
- Metadata queries are simple. Use get_object_metadata to grab technical details like the content type or ETag for any file so your agent can process it correctly.
- Streamline content updates. You can upload_object text assets and instantly generate public endpoints, making them ready for use without console navigation.

## How It Works

The bottom line is that you interact with cloud storage like talking to a colleague, not navigating a complex web console.

1. Subscribe to this MCP and input your specific Tencent Cloud credentials, including the SecretId, SecretKey, Region, and target Bucket Name.
2. Connect your AI client (like Claude or Cursor) to Vinkius, giving it permission to use this storage tool.
3. Ask your agent a question—for example, 'List all files in the root folder'—and get an actionable list of results back.

## Frequently Asked Questions

**Does Tencent COS / 腾讯云对象存储 support listing all files?**
Yes, it does. You can use list_objects to view the contents of a bucket and even filter by specific paths or folder markers.

**How do I check if an object is already in the bucket using Tencent COS / 腾讯云对象存储?**
You run the check_object_exists tool. This sends a quick metadata query and tells you immediately if that specific file key exists, saving time compared to downloading it just to verify.

**Can Tencent COS / 腾讯云对象存储 handle large files?**
Yes. The upload_object tool supports up to 5GB per request, giving you plenty of room for large text assets and documents.

**What is the difference between list_objects and list_root_objects with Tencent COS / 腾讯云对象存储?**
list_root_objects shows only the top-level contents, like main folders. list_objects lets you specify a prefix to drill down into specific paths deeper in your storage structure.

**Do I need special coding knowledge for Tencent COS / 腾讯云对象存储 MCP?**
No. You interact with it using natural language prompts through your AI client, so you don't need to write code or worry about the underlying API calls.