# Xiaomi Push Service MCP > Xiaomi Push Service / 小米推送: Send reliable push notifications across the entire Xiaomi ecosystem. This MCP lets your AI agent target specific users by unique IDs, send alerts to defined groups, or broadcast announcements globally, all without touching a developer console. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** push-notifications, mobile-engagement, android-development, message-broadcasting, alias-mapping, real-time-alerts ## Description Need to get a message out to millions of Xiaomi devices? Instead of logging into complex web consoles, your AI client handles the entire process. This MCP connects you directly to Xiaomi's notification platform, giving your agent real-time control over device communication and mobile engagement. Your agent can send alerts using a unique Registration ID, target users via custom aliases, or broadcast an update across large groups of devices. You even get granular control by subscribing or unsubscribing a specific device to certain topics. This means you can coordinate everything from high-priority system warnings to general marketing announcements—all within your natural conversation flow. If you're looking for centralized access to global and regional push delivery, connecting this MCP through Vinkius makes it available alongside thousands of other tools your agent might need. ## Tools ### push_to_alias Send a notification to any user simply by their custom alias. ### push_to_all Broadcast an announcement that goes out to every device linked to your app. ### push_to_regid Send a notification directly using the unique hardware registration ID of a specific device. ### push_to_topic Deliver an alert only to devices that are subscribed to a particular content topic. ### subscribe_to_topic Adds a device to a specified communication topic so it can receive future messages. ### unsubscribe_from_topic Removes a device from a content topic, stopping all further notifications for that group. ## Prompt Examples **Prompt:** ``` Send a push notification to Xiaomi RegID 'ABCD...1234' with title 'Welcome' and body 'Glad to have you here!'. ``` **Response:** ``` I've successfully sent the notification to the Registration ID. The Xiaomi message ID is `1234567890`. Should I also verify if this RegID is correctly formatted? ``` **Prompt:** ``` Push an urgent alert to user alias 'user_8821' saying 'Your account has a new login'. ``` **Response:** ``` I've initiated the high-priority push to the user alias `user_8821`. The message has been submitted to the Xiaomi gateway. Would you like me to check the connectivity status of your configured region? ``` **Prompt:** ``` Broadcast a global announcement to all users: 'Maintenance starts at 10 PM tonight'. ``` **Response:** ``` I've started the broadcast to all devices registered to your application. The maintenance announcement has been successfully sent via Xiaomi Push. Should I verify which region is currently active for these operations? ``` ## Capabilities ### Send alerts to a specific device ID Sends a targeted notification directly to a user's unique Xiaomi Registration ID. ### Target users by custom name Dispatches notifications using a predefined user alias instead of the raw device ID. ### Broadcast to all connected devices Sends an announcement that reaches every single app-registered device for your application. ### Send alerts to specific groups Delivers a message only to devices subscribed to a certain content topic. ### Manage subscriptions and topics Allows you to programmatically add or remove device membership from defined communication topics. ## Use Cases ### The App Team needs an urgent security warning A developer realizes 5,000 users are affected by a bug. Instead of manually writing 5,000 API calls, they ask their agent to 'Broadcast the maintenance alert using `push_to_all`'. The MCP instantly sends the message everywhere. ### A Marketing Team needs to segment an announcement The team wants to advertise a new feature only to premium users. They use their agent to check which users are subscribed to the 'premium_tier' topic and then run `push_to_topic` on that group. ### An Ops Team needs to confirm a user migrated accounts The team verifies if an old account ID is still active. They ask their agent to 'Send a test message using `push_to_regid`' to the specific unique device identifier, confirming connectivity. ### A System Administrator needs to clean up inactive devices The admin wants to remove all old accounts from mailing lists. They use their agent to run `unsubscribe_from_topic` for a list of known defunct IDs, keeping the notification system clean. ## Benefits - Stop logging into the MiPush Console. Your agent handles all targeting, whether you need to use `push_to_regid` for a single user or send a broad blast using `push_to_all`. This is pure automation. - Achieve precise audience segmentation by utilizing topics. Instead of spamming everyone, your agent can first use `subscribe_to_topic` and then `push_to_topic` to hit only the relevant users. - Support global reach from one place. You manage regional gateways for China, Europe, India, and more without needing multiple integrations or complex API calls. - Simplify user targeting. If you don't have a full Registration ID handy, `push_to_alias` lets your agent find the right user using only their custom name. - Maintain clean communication channels by controlling membership. Use `unsubscribe_from_topic` when a user leaves a group to ensure they stop receiving irrelevant messages. ## How It Works The bottom line is that after setting up the credentials for the right region, you just talk to your AI client and it handles all the complex message routing. 1. Subscribe to this MCP and provide your Xiaomi App Secret, making sure to select the correct regional gateway (e.g., Global, China). 2. Connect your preferred AI client—like Claude or Cursor—to Vinkius and authorize access. 3. Ask your agent to perform a specific action, such as 'Send an urgent alert to user alias X' or 'Broadcast this update globally.' ## Frequently Asked Questions **How do I send a message to a single Xiaomi user using the push_to_regid tool?** You must provide the unique Registration ID. Your agent uses this specific identifier to target and deliver the notification directly to that one device. **Can I broadcast to all users without listing every single ID? (push_to_all)** Yes. The `push_to_all` tool sends an announcement across your entire application's user base, making it perfect for system-wide maintenance notices. **Is the push_to_topic method better than targeting by alias?** It depends on your goal. Use `push_to_alias` when you know the person's specific name, but use `push_to_topic` when you need to hit a defined group of interest. **What is the difference between subscribe_to_topic and push_to_topic?** Subscribing (`subscribe_to_topic`) adds a device's membership to a topic. Pushing (`push_to_topic`) sends the message only after that subscription link has been established. **Does this MCP support different geographic regions?** Yes, it manages specialized regional gateways for various markets (like China, Europe, and Global), ensuring your alerts reach devices correctly wherever they are located.