# Huawei Push Kit MCP

> Huawei Push Kit / 华为推送服务 lets your AI agent manage all device notifications for the Huawei Mobile Services (HMS) ecosystem. You can send targeted alerts to unique devices, broadcast messages to large topic groups, or create specific notification flows based on complex user criteria—all by talking to your agent.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** push-notifications, mobile-engagement, hms-ecosystem, message-orchestration, targeted-messaging, real-time-alerts

## Description

Managing device communication used to mean navigating massive developer consoles and writing complex API calls just to send a simple alert. This MCP changes that. It connects the full power of Huawei Push Kit directly to your AI client, letting you handle everything from basic announcements to highly specific user targeting through natural conversation. Instead of logging into AppGallery Connect, telling your agent what needs to happen—like sending an update only to users who are subscribed to both 'sales' and 'beta' topics—is enough. Your agent acts as a real-time push coordinator for your whole business. You can manage subscriptions by checking which topics devices follow or even adding new ones using the `subscribe_to_topic` tool. Whether you need to send an immediate alert to a single user via `push_to_token`, broadcast a global update with `push_to_topic`, or execute complex targeting logic with `push_to_condition`, all those actions are available from one, authorized source through Vinkius.

## Tools

### list_topic_subscriptions
Retrieves and lists all content topics that a specific device is currently registered to receive updates from.

### push_to_condition
Sends an alert only if the target device matches complex criteria based on multiple subscribed topics.

### push_to_token
Delivers a direct, high-priority message to one specific device using its unique token identifier.

### push_to_topic
Sends an update simultaneously to every single device currently subscribed to a named content topic.

### subscribe_to_topic
Adds a new interest topic for a device, ensuring it receives future messages related to that subject matter.

### unsubscribe_from_topic
Removes a specific content topic from a device's subscriptions, stopping all future alerts on that subject.

## Prompt Examples

**Prompt:** 
```
Send a push notification to token 'ABCD...1234' with title 'Good Morning' and body 'Don't forget your tasks today'.
```

**Response:** 
```
I've successfully sent the notification to the device token. The Huawei request ID is `1234567890`. Should I also send this update to your global announcement topic?
```

**Prompt:** 
```
Broadcast a system update notification to the 'all_users' topic for version '2.5.0'.
```

**Response:** 
```
I've initiated the broadcast to all devices subscribed to the `all_users` topic. The message 'Version 2.5.0 is now ready for download' has been successfully submitted to Huawei Push Kit. Would you like me to monitor the delivery status?
```

**Prompt:** 
```
Check the connectivity status of our Huawei Push and OAuth gateways.
```

**Response:** 
```
I've performed a diagnostic check. Both the Huawei OAuth authentication gateway and the Push Kit API are responding normally. Your App ID is correctly configured. Is there anything else you'd like to audit?
```

## Capabilities

### Send messages to single devices
Deliver a push notification directly to a unique device token.

### Broadcast updates by topic
Push the same message out simultaneously to all subscribers of a specific content topic.

### Target messages with conditions
Send notifications only if devices match multiple, complex criteria defined by topics.

### Manage device subscriptions
Add or remove specific content topics from a device's list of interests.

### Verify system connectivity
Check if your App ID and connection gateways are working correctly, helping you troubleshoot alerts before deployment.

## Use Cases

### The product launch announcement
A marketing team needs to tell 50,000 users about a new feature. They ask their agent to 'Broadcast the release notes to all active beta testers.' The agent uses `push_to_topic` on the designated 'beta_testers' topic, ensuring rapid, reliable delivery without manual API calls.

### The abandoned cart reminder
An e-commerce backend needs to remind a specific user who left items in their cart. They prompt the agent: 'Send an alert to token XYZ about the cart.' The agent executes `push_to_token`, ensuring the message hits that single, critical device immediately.

### The regional sales promotion
A sales team only wants to promote a deal in Europe. They ask their agent to 'Send an alert for discounts, but only to users subscribed to both 'discounts' and 'europe_region'.' The agent uses `push_to_condition`, guaranteeing the message reaches the right segment.

### The content cleanup
A developer needs to remove old topics because they are no longer relevant. They prompt: 'Remove the 'old_guide' topic from all tokens.' The agent executes `unsubscribe_from_topic`, maintaining clean, accurate device subscriptions.

## Benefits

- Targeted messaging gets you precise results. Instead of blasting everyone, you can use `push_to_token` to send an alert only to a single user's device.
- Mass communication is simple too. To reach all users interested in system updates, just prompt your agent to use the `push_to_topic` tool on a known group topic.
- Complex logic becomes conversational. Use `push_to_condition` to send messages that only fire when devices meet specific criteria, like 'Topic A' AND 'Topic B'.
- Managing user interest is easy. Need to stop sending alerts? Prompt the agent to use `unsubscribe_from_topic`. Want them interested in something new? Use `subscribe_to_topic`.
- You gain full operational visibility. The MCP lets you run diagnostics and check token validity, saving time previously spent debugging connectivity issues.

## How It Works

The bottom line is you manage complex device communications using plain English prompts instead of developer console clicks and API code.

1. Subscribe to this MCP in Vinkius and provide your Huawei HMS App ID and App Secret.
2. Connect the MCP to your preferred AI client (like Cursor or Claude).
3. Use natural language instructions, like 'Send an alert for X topic' or 'List topics for token Y', to trigger the desired action.

## Frequently Asked Questions

**How do I send an alert using Huawei Push Kit / 华为推送服务 MCP?**
You simply prompt your agent with the details, such as 'Send a message to token XYZ.' The agent handles connecting and sending the push notification for you.

**Can I use Huawei Push Kit / 华为推送服务 MCP for mass marketing?**
Yes. You can use `push_to_topic` to broadcast updates to large groups of subscribers, making it ideal for global campaigns or product announcements.

**Does Huawei Push Kit / 华为推送服务 MCP support complex targeting?**
Absolutely. Use the `push_to_condition` tool to target devices that satisfy multiple topic requirements simultaneously (e.g., users in both 'premium' and 'europe').

**What is the difference between push_to_token and push_to_topic?**
Sending via `push_to_token` targets one specific device directly, guaranteeing a personal alert. Sending via `push_to_topic` hits every device subscribed to that general topic.

**How do I check if my tokens are valid?**
You can use the MCP's diagnostic capabilities or prompt your agent to validate token formats and check overall API connectivity status, ensuring your alerts won't fail unexpectedly.