# Xiaomi Push Service MCP for AI Agents AI Agent Connect

> Xiaomi Push Service / 小米推送 lets you send push notifications to MIUI and global Xiaomi devices using your AI client. It handles complex message sending, alias mapping, and regional broadcasting so you don't have to manually navigate the MiPush Console.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/undefined/ai-agent-connect
- **Tags:** push-notifications, mobile-engagement, android-development, message-broadcasting, alias-mapping, real-time-alerts

## Description

Managing mobile engagement for the Xiaomi ecosystem usually means jumping through hoops in a complex web console. You have to worry about regional gateways, find specific registration IDs, and figure out how to group users correctly. This Connector changes that by giving your agent a direct line to the Xiaomi Push Service. Instead of manual data entry, you can just tell your agent to notify a specific user alias or blast a maintenance alert to your entire user base. It handles the routing for China, Europe, and other major regions automatically. If you're tired of copy-pasting IDs and navigating multiple tabs, you can find this among the 4,000+ integrations in the Vinkius catalog to get your notifications running in minutes. It turns a tedious operational task into a simple conversation, letting you focus on your app rather than the plumbing of message delivery.

## Tools

### unsubscribe_from_topic
Remove a device from a specific notification topic. Use this to manage user preferences and stop unwanted notifications.

### push_to_alias
Send a push notification to a specific user alias. This makes it easy to reach individual users without needing their hardware IDs.

### push_to_all
Broadcast a notification to every device registered to your application. Use this for urgent global announcements.

### push_to_regid
Send a push notification to a unique device registration ID. This is the most direct way to target a specific piece of hardware.

### push_to_topic
Send a notification to a specific group of devices subscribed to a topic. This is perfect for segmented marketing.

### subscribe_to_topic
Add a device to a specific notification topic. This helps you organize users into groups for targeted messaging.

## Prompt Examples

**Prompt:** 
```
Send a push to the 'beta_testers' topic saying 'The new update is live!'
```

**Response:** 
```
I've sent that notification to the **beta_testers** topic. 

**Status:** Success
**Message:** "The new update is live!"
**Target:** All devices in the beta_testers group.
```

**Prompt:** 
```
Notify the user with alias 'user_442' that their order has shipped.
```

**Response:** 
```
I've sent the order update to the user with alias **user_442**. 

**Details:**
- **Recipient:** user_442
- **Message:** "Your order has shipped."
- **Status:** Delivered to the Xiaomi gateway.
```

**Prompt:** 
```
Broadcast a message to everyone in the Global region about the 2 PM maintenance.
```

**Response:** 
```
I've initiated a global broadcast for the **Global region**.

**Broadcast Details:**
- **Scope:** All registered devices
- **Region:** Global
- **Content:** "Maintenance starts at 2 PM tonight."
- **Status:** Sent successfully.
```

## Capabilities

### Notify specific user aliases
Send a push notification to a user based on a custom name you've assigned to them.

### Broadcast to all devices
Send a message to every single device registered to your application at once.

### Target unique registration IDs
Send a push notification directly to a specific hardware registration ID.

### Message specific topics
Send a notification to a group of devices that are subscribed to a particular topic.

### Add devices to topics
Subscribe a specific device to a notification topic for segmented engagement.

### Remove devices from topics
Unsubscribe a device from a topic to stop it from receiving specific messages.

## Use Cases

### Urgent System Alert
A developer notices a server crash and asks the agent to send a high-priority push to the 'admin' alias to alert the team immediately.

### Global Maintenance
An ops lead tells the agent to broadcast a maintenance window notice to all users using push_to_all to ensure everyone sees the update.

### Segmented Marketing
A marketer wants to notify only 'premium' users and asks the agent to send a message to the premium topic using push_to_topic.

### User Onboarding
A new user joins and the agent automatically calls subscribe_to_topic to add them to the 'welcome' group for tailored onboarding messages.

## Benefits

- Skip the MiPush Console: You no longer have to log into a separate dashboard to send messages or manage your app's push settings.
- Precise Targeting: Use push_to_alias or push_to_regid to reach specific users instead of guessing or sending generic blasts.
- Faster Broadcasts: Use push_to_all to reach your entire user base in seconds with a single command from your AI client.
- Automated Topic Management: Use subscribe_to_topic and unsubscribe_from_topic to handle user groups dynamically as they join or leave.
- Regional Control: Easily switch between regional gateways like China, Europe, and India without having to manually reconfigure endpoints.

## How It Works

The bottom line is that you get a direct line to the Xiaomi notification system without leaving your workspace.

1. Subscribe to the Connector and provide your Xiaomi App Secret.
2. Select your target region like China, Global, or Europe.
3. Ask your agent to send notifications or manage your device topics.

## Frequently Asked Questions

**Can I use Xiaomi Push Service / 小米推送 for non-Xiaomi devices?**
No, this Connector is specifically designed for the Xiaomi ecosystem, including MIUI and Global Xiaomi devices. It connects directly to Xiaomi's proprietary push platform.

**How do I send a message to a specific person using this Connector?**
You can use the alias tool to target a specific person. By using a custom alias, you don't need to worry about finding their specific hardware ID every time you want to send a message.

**Can I send messages to different countries with Xiaomi Push Service / 小米推送?**
Yes, the Connector supports regional gateways for China, Europe, India, and more. You just need to specify your target region when setting up or sending your commands.

**Is there a way to group users for notifications?**
Yes, you can use topics to group your users. This allows you to send messages to specific segments, like beta testers or premium members, rather than blasting everyone.

**How does this work with my AI client like Claude or Cursor?**
Once you connect the Connector through Vinkius, you can simply type natural language commands into Claude or Cursor. Your agent will then execute the necessary push commands for you automatically.

**How do I find my Xiaomi App Secret?**
Log in to the [Xiaomi Open Platform console](https://dev.mi.com/console/), navigate to the 'Push Service' section, select your application, and you will find your unique App Secret in the application details overview.

**Which region should I select?**
Select the region where your users are primarily located. `CHINA` uses the Mainland gateway, while `GLOBAL` uses the Singapore gateway. Europe, Russia, and India have dedicated local gateways for better delivery performance.

**What is the difference between RegID and Alias?**
A RegID is a unique identifier generated by the Xiaomi SDK for each device. An Alias is a custom string (like a username) that you associate with one or more RegIDs in your application code to simplify targeting.