# Jiguang Aurora MCP

> Jiguang Aurora / 极光 MCP connects your AI agent to China's leading push notification platform for real-time communication control. Manage device targeting, set complex message schedules, and pull detailed delivery reports—all through natural conversation. Stop navigating portals; just tell your agent what you need done.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** push-notifications, cpaas, mobile-engagement, device-targeting, real-time-messaging, api-integration

## Description

Managing targeted messaging used to feel like juggling multiple dashboards and secret APIs. Now, your AI client handles the complexity of major push notification infrastructure. You can instruct your agent to send specific alerts to highly segmented user groups, pull metadata on devices by their registration ID, or set up campaigns that only fire at perfect times. It's about treating a complex communication system like chatting with an expert teammate.

This MCP gives you full control over scheduling and delivery auditing without ever having to log into the Jiguang portal. Whether you’re running large-scale promotions or just automating user verification, your agent acts as your dedicated messaging assistant. We built this connection through Vinkius so you get access to all of these features from one place, letting you focus on strategy instead of clicks.

## Tools

### create_schedule
Sets up a future push notification task to run at a specified time.

### delete_schedule
Removes an existing scheduled message from the system queue.

### get_account_quota
Retrieves current API usage limits and remaining quotas for your account.

### get_device_info
Fetches detailed metadata about a specific device using its unique identifiers.

### get_message_status
Checks the current delivery status and outcome of a sent push message.

### get_push_report
Retrieves a comprehensive report detailing how many users received and interacted with a specific push campaign.

### get_user_report
Generates reports on overall user activity and growth metrics over a given time period.

### list_schedules
Shows a list of all current or upcoming scheduled push tasks in the system.

### send_push
Immediately sends a customized push notification to one or more specified devices.

### update_device
Modifies tags and aliases associated with a device to refine future targeting criteria.

## Prompt Examples

**Prompt:** 
```
Send a push notification to Registration ID '1a0918c...'.
```

**Response:** 
```
I've sent the targeted push notification to the specified device. The message ID is '8821'. Would you like me to check the delivery status in a few minutes?
```

**Prompt:** 
```
Schedule a push task for tomorrow at 10 AM.
```

**Response:** 
```
Done! I've created a scheduled push task. It is set to trigger tomorrow at 10:00 AM. You can find this task in your schedule list with ID '9920'.
```

**Prompt:** 
```
Show me the user activity report for the last 7 days.
```

**Response:** 
```
I've retrieved the user activity report. Over the last 7 days, you had an average of 12,500 daily active users and 450 new device registrations. Should I break this down by platform (iOS/Android)?
```

## Capabilities

### Send Targeted Alerts
Instantly sends customized push notifications to specific users or defined user segments.

### Manage Device Details
Retrieves detailed device information and updates tags or aliases for better targeting accuracy.

### Set Message Timers
Creates, modifies, and deletes scheduled push tasks to ensure messages arrive at the ideal moment.

### Audit Delivery Status
Accesses real-time reports detailing message receipt status, user engagement metrics, and overall campaign performance.

### Monitor System Health
Checks your account's API usage limits and quota to prevent communication failures.

## Use Cases

### Handling an Urgent Feature Rollout
A PM needs 5,000 users who haven't opened the app in two weeks to get a notice about a new feature. They tell their agent: 'Send a push notification using `send_push` only to inactive users.' The agent executes the tool and confirms delivery immediately.

### Running Weekly Campaign Cycles
A marketing manager needs to ensure a product announcement hits all users next Tuesday at 9 AM. They tell their agent: 'Schedule a push for next Tuesday.' The agent uses `create_schedule`, and the manager can check it later with `list_schedules`.

### Investigating Low Engagement
An operations analyst notices that one specific device group is ignoring alerts. They ask their agent to run a report on device data using `get_device_info` and then cross-reference it with `get_user_report` to understand the pattern.

### Preparing for Peak Sales Season
A DevOps engineer needs to ensure they have enough API capacity for Black Friday. They simply ask their agent: 'What's our remaining quota?' The agent runs `get_account_quota`, giving them the necessary numbers before writing any code.

## Benefits

- Saves time by automating alerts. Instead of manually calling the `send_push` tool for every segment, you just tell your agent to 'Notify X group about Y.'
- Improves targeting accuracy using `update_device`. You can adjust device tags—like marking a user as 'Beta Tester'—so future messages only hit the right people.
- Eliminates scheduling guesswork. Use `create_schedule` and `list_schedules` to guarantee promotional alerts run exactly when they should, without manual intervention.
- Provides immediate accountability. When you need to know if a message worked, simply ask for the report using `get_push_report`; no more guessing about delivery status.
- Maintains system stability by checking quotas. Running `get_account_quota` before a major campaign prevents frustrating service outages due to API limits.

## How It Works

The bottom line is that you communicate complex messaging tasks in plain language; your AI client translates it into technical actions and delivers the results.

1. Subscribe to this MCP, then input your required Jiguang App Key and Master Secret.
2. Direct your AI client: tell it exactly which action you want—like 'Send a push notification to ID X' or 'List all scheduled tasks.'
3. The agent executes the command using the correct tool, giving you an immediate status update on success or failure.

## Frequently Asked Questions

**How do I schedule a push notification using Jiguang Aurora / 极光 MCP?**
You use the `create_schedule` tool. Just ask your agent to set it for a specific date and time, and it handles making sure the task is queued up correctly.

**Can I check if my push notifications actually worked with Jiguang Aurora / 极光 MCP?**
Yes. Use `get_push_report` to pull detailed reports on message receipt and user engagement, giving you the full picture of campaign performance.

**What is the best way to target specific users with Jiguang Aurora / 极光 MCP?**
First, use `get_device_info` to gather metadata. Then, run `update_device` to apply tags (like 'VIP') and only send messages via `send_push` to the newly tagged segments.

**Does Jiguang Aurora / 极光 MCP handle API quotas?**
Absolutely. Running `get_account_quota` is a quick, vital check that tells you exactly how much usage you have left before starting any large campaign.

**How do I remove an old scheduled message using Jiguang Aurora / 极光 MCP?**
Use the `delete_schedule` tool. You just need to tell your agent which task ID you want gone, and it removes it from the queue.