# LeanCloud MCP

> LeanCloud MCP connects your AI agent directly to a scalable backend service, letting you manage application data and user accounts through natural conversation. Your agent can list records, create new content, update profiles, audit files, or trigger push notifications—all without needing to log into the console.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** backend-as-a-service, data-modeling, user-management, push-notifications, api-development, cloud-storage

## Description

You shouldn't have to jump between an IDE, a dashboard, and a database terminal just to run a simple data check. This MCP lets your agent treat LeanCloud like another API endpoint you already use every day. Instead of building complex scripts to handle user data or content changes, you just ask it. Your agent can list specific object types within any data class, pull detailed metadata on individual records, and even manage the full lifecycle of an application's membership base. Need to update a profile? Just tell your agent. Want to send out a mass alert? It handles that too. Everything—from listing user accounts to initiating notifications—is accessible through your AI client via Vinkius.

## Tools

### create_object
Creates and saves a brand-new object record into your defined data classes.

### delete_object
Permanently removes an existing, specified object from the database.

### get_app_stats
Retrieves key performance metrics for your application, like total API calls or storage usage.

### get_object
Pulls the full set of details for a single, specified data object by its ID.

### get_user
Fetches all profile information associated with one specific user account.

### list_files
Lists and reports on every file currently uploaded to your application's cloud storage.

### list_objects
Generates a list of all available object types within a specific data class structure.

### list_users
Retrieves a comprehensive roster of every single user currently registered in the system.

### push_notification
Sends an immediate, targeted notification message to one or more users.

### update_object
Modifies existing content records with new data without deleting and recreating them.

## Prompt Examples

**Prompt:** 
```
List the last 5 objects in the 'GameScore' class.
```

**Response:** 
```
I've retrieved the latest records from the GameScore class. You have 5 recent entries, including scores from 'User8821' and 'User9920'. Would you like to view the full metadata for the highest score?
```

**Prompt:** 
```
Show me all users in the application.
```

**Response:** 
```
I've listed the users for your LeanCloud application. You have 150 total registered members. Should I retrieve the detailed profile for the most recently active user?
```

**Prompt:** 
```
Check the application statistics for today.
```

**Response:** 
```
I've retrieved the app statistics. Today, your backend has handled 5,000 API requests with a 99.9% success rate. Storage usage is currently at 1.2GB. Would you like a breakdown of the most called endpoints?
```

## Capabilities

### Manage data records
Create, read, update, and delete content objects within specific application classes.

### Handle user accounts
Browse or retrieve detailed profiles for every user registered in the system.

### Audit files and statistics
List all cloud-stored application files, or check real-time metrics on API usage and storage capacity.

### Send alerts
Trigger immediate push notifications to specific users across the platform.

## Use Cases

### The weekly user audit
A Product Ops Manager needs to check who signed up last week and if any of their records are missing key data points. They ask the agent to list_users, then run get_user on a few profiles they suspect are incomplete. The agent reports back which profiles need manual cleanup.

### Responding to system alerts
The developer notices an old feature needs deactivation and wants to clean up the associated data. They use list_objects to confirm the object type, then call delete_object on specific records, preventing accidental data loss.

### Deployment status check
A developer is preparing a new feature release and needs confirmation that all necessary files are uploaded. They ask the agent to list_files, verifying every required document is present before code deployment can proceed.

### Coordinating marketing campaigns
The marketing team launches a campaign and needs to notify 50 specific users immediately. They use push_notification, passing the recipient list and message content directly through their agent without touching the notification service console.

## Benefits

- Instead of running separate queries to see what objects exist, simply ask the agent to list_objects. It handles the class structure so you don't have to worry about naming conventions.
- You can audit your entire user base by calling list_users and then quickly get detailed info on specific people using get_user, all in one conversational flow.
- Never lose track of what data is available; use list_files to instantly inventory every single asset stored in your cloud storage area.
- Update records without the headache. Use update_object to modify fields or correct errors across multiple pieces of data points with a single command.
- Keep users engaged by sending out push_notification alerts right from your agent workspace, triggering immediate action.

## How It Works

The bottom line is you talk to your backend infrastructure naturally, and it responds with structured data.

1. Subscribe to this MCP and supply your unique LeanCloud App ID and App Key.
2. Connect the credentials to any compatible AI client, like Cursor or VS Code.
3. Tell your agent what needs doing; for example, 'List all users who haven't logged in this month.' The agent executes the command using the proper tools.

## Frequently Asked Questions

**Can I use LeanCloud MCP to retrieve old user data?**
Yes. You can use list_users to see a roster of all accounts, and then get_user to pull detailed profile information for any specific person in the system.

**How do I update content using LeanCloud MCP?**
You use the update_object tool. You simply tell your agent which object needs changing and what the new value should be, preventing data corruption from manual API calls.

**What is the difference between list_objects and list_users in LeanCloud MCP?**
list_objects lists all available *data types* (or classes) you have defined. list_users specifically provides a roster of actual user accounts that exist within your application.

**Does LeanCloud MCP handle notifications?**
Yes, it does. You can trigger immediate alerts to users by running the push_notification tool directly through your agent interface.

**Can I check system performance with LeanCloud MCP?**
Absolutely. Use get_app_stats to retrieve critical metrics like API request counts and overall storage usage, helping you monitor application health at a glance.