# Deta Space MCP for AI Agents AI Agent Connect

> Deta Space MCP lets you manage your personal cloud data and files directly from your AI client. It connects to Deta Base for NoSQL data storage and Deta Drive for file management, giving your agent the ability to query records, update fields, and move files through natural conversation.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_GX4IrdQUKPa9zaRnx8N7BCKZxc1g51D1pb49fcrf/ai-agent-connect
- **Tags:** nosql, serverless, personal-cloud, data-storage, file-management

## Description

Imagine having a personal cloud that your AI agent can actually touch and organize for you. Instead of manually jumping between tabs to manage NoSQL records or upload files to a storage bucket, this Connector gives your agent the keys to your Deta Space. You can tell your agent to find specific user records, update a single field in a database, or grab a file from your drive and tell you what's inside. It makes your serverless infrastructure feel like a part of your workspace. When you connect this through the Vinkius catalog, you're basically giving your agent a hands-on way to manage your data without having to write custom scripts for every single task. It's about moving from telling the AI what to do to the AI doing it for you because it has the direct access it needs. This setup handles the heavy lifting of data movement and retrieval so you can stay focused on your actual work.

## Tools

### base_delete_item
Deletes a specific item from Deta Base using its unique key. Use this to remove outdated records from your NoSQL store.

### base_get_item
Fetches a single record from Deta Base so your agent can read its contents. It's the fastest way to grab a specific item.

### base_insert_item
Adds a new item to Deta Base only if the key doesn't already exist. This helps you keep your data clean and unique.

### base_put_items
Saves a list of JSON items into Deta Base in one go. This is perfect for bulk data entry into your NoSQL database.

### base_query_items
Searches your Deta Base for items that match specific query logic. Use it to filter and find data based on multiple criteria.

### base_update_item
Changes specific attributes of an existing item without overwriting the whole object. This allows for precise, atomic updates.

### drive_upload_file
Sends a file from your local system up to your Deta Drive. This lets your agent handle file transfers for you.

### drive_delete_files
Removes one or more files from your Deta Drive storage. Use this to clean up your personal cloud drive quickly.

### drive_download_file
Grabs a specific file from your Deta Drive by its name. Your agent can use this to pull files into your local environment.

### drive_list_files
Shows a list of all files currently stored in your Deta Drive. It's the best way to see what's currently in your storage.

## Prompt Examples

**Prompt:** 
```
Show me the last 5 items added to my 'orders' collection.
```

**Response:** 
```
I've queried your 'orders' collection and found the following recent entries:

| Order ID | Amount | Status |
| :--- | :--- | :--- |
| #9921 | $45.00 | Shipped |
| #9922 | $12.50 | Processing |
| #9923 | $110.00 | Shipped |
| #9924 | $8.99 | Delivered |
| #9925 | $22.40 | Processing |

Would you like me to update the status on any of these?
```

**Prompt:** 
```
Is there a file named 'config.json' in my drive?
```

**Response:** 
```
I checked your Deta Drive and found one file matching that name:

* **config.json** (Stored in root directory)

Would you like me to download it for you or show you the contents?
```

**Prompt:** 
```
Change the 'is_premium' status to true for user_44.
```

**Response:** 
```
I've successfully updated the record for **user_44**. The `is_premium` attribute is now set to **true**.
```

## Capabilities

### Update database records
Modify specific attributes of a NoSQL item without rewriting the entire object.

### Query JSON data
Search through your Deta Base collections using complex query logic.

### Upload files to drive
Move files from your local machine into your personal cloud storage.

### Download cloud files
Fetch files from Deta Drive to your local environment.

### List storage contents
See every file currently stored in your Deta Drive.

### Delete database entries
Remove specific records from your NoSQL storage by their unique key.

## Use Cases

### Updating user profiles
A developer asks the agent to change a user's status to 'active' using `base_update_item` instead of logging into a dashboard.

### Batch uploading logs
A power user tells the agent to move a folder of logs into Deta Drive using `drive_upload_file` to keep their local machine clean.

### Querying order history
A data engineer asks for all orders from last week using `base_query_items` to quickly inspect recent transactions.

### Cleaning up old files
A user tells the agent to delete all files in a specific drive using `drive_delete_files` to free up space.

## Benefits

- Real-time NoSQL management: Use `base_update_item` to change specific database fields instantly without manual overhead.
- Faster file handling: Move assets quickly using `drive_upload_file` and `drive_download_file` without leaving your chat.
- Precise data discovery: Use `base_query_items` to find specific JSON objects in your Deta Base collections.
- Safe data entry: Prevent duplicates when adding new data with `base_insert_item` to keep your records clean.
- Organized cloud storage: Keep track of your personal files easily with `drive_list_files` and `drive_delete_files`.

## How It Works

The bottom line is you get a direct bridge between your AI agent and your serverless cloud storage and database.

1. Add your Deta Space App Key and Project ID to the Connector configuration.
2. Connect your AI client to the Connector via Vinkius.
3. Ask your agent to perform actions like 'List my recent files' or 'Update the status of user_123'.

## Frequently Asked Questions

**Can I use Deta Space MCP to manage my own private cloud?**
Yes. This Connector connects your AI agent to your personal Deta Space, allowing you to manage your own private NoSQL database and file storage through a chat interface.

**Does Deta Space MCP support NoSQL data?**
Yes, it specifically works with Deta Base, which is a high-performance NoSQL database for storing JSON data.

**How do I upload files using Deta Space MCP?**
You can simply ask your AI agent to upload a file for you. It will use the drive tools to move the file from your local environment to your Deta Drive.

**Can I update only one part of a JSON record?**
Yes, the Connector supports atomic updates. This means your agent can change specific fields in a database item without overwriting the entire record.

**Does Deta Space MCP work with Cursor or Claude?**
Yes, it works with any MCP-compatible client, including Claude, Cursor, Windsurf, and VS Code.

**How can I search for specific records in a Deta Base?**
Use the `base_query_items` tool. You can provide a JSON array of query objects to filter items by their attributes, and even handle pagination using the `limit` and `last` parameters.

**Can I update just one field in a database item without sending the whole object?**
Yes! The `base_update_item` tool allows you to perform atomic updates. You can use the `set` parameter to update fields, `increment` for numbers, or `append` for arrays.

**How do I upload a text file or document to Deta Drive?**
Use the `drive_upload_file` tool. Provide the `drive_name`, the desired file `name` (path), and the `content` of the file. The agent will handle the storage process for you.