# GeTui / 个推 MCP > GeTui / 个推 connects your AI agent to China’s dominant push notification platform. Send targeted alerts, broadcast messages to large user groups, and track real-time delivery metrics—all through natural conversation. It lets you monitor user online status, segment users by interest tags, and audit campaign performance without touching a dashboard. ## Overview - **Category:** developer-tools - **Price:** Free - **Tags:** push-notifications, cpaas, mobile-engagement, campaign-management, lbs, message-broadcasting ## Description Managing high-volume notifications usually means clicking through several developer dashboards just to find out if your message actually landed. This MCP changes that. Instead of wrestling with complex platforms like GeTui’s own developer center, you talk directly to your agent. You can ask it to send a targeted notification to a specific user or broadcast an alert to everyone. Need to know who's online? Just ask. Your agent checks the current status and even finds out what groups of users share common interests by looking up their tags. It gives you real-time delivery stats, showing how many people received the message versus how many actually opened it. You get all this deep user insight—from monitoring application growth to auditing campaign clicks—all managed through your preferred AI client connected via Vinkius. ## Tools ### bind_user_alias Links a user's display name or username to their unique Client ID for better tracking. ### get_app_user_stats Pulls current statistics regarding the total number of active and new users in your application. ### get_push_status Verifies the current status of any initiated push task, telling you if it succeeded or failed. ### get_cid_status Checks if a user is currently online or connected to the push service right now. ### get_daily_push_report Retrieves aggregated statistics detailing all push tasks that were run on a specific day. ### get_user_tags Retrieves all user-assigned interest tags so you can segment your audience for highly targeted messages. ### push_to_all Sends a broadcast notification to every single registered user ID in your system. ### push_to_list Sends a push message simultaneously to a curated list of specific user IDs you provide. ### push_to_single Sends a notification directly and immediately to one specified user ID. ### query_user_alias Looks up the readable alias or display name associated with any given Client ID. ## Prompt Examples **Prompt:** ``` Send a push notification to CID '1a0918c...' with title 'Urgent Update'. ``` **Response:** ``` I've initiated the targeted push notification for the specified user. The task ID is '8821'. Would you like me to check the delivery status in a few minutes? ``` **Prompt:** ``` Check the online status for user CID '9920a1b...'. ``` **Response:** ``` I've checked the status for the specified CID. The user is currently 'Online' and connected to the GeTui push server. Should I check their associated tags as well? ``` **Prompt:** ``` Show me the push report for yesterday. ``` **Response:** ``` I've retrieved the push statistics for yesterday. You had 15 total push tasks reaching 120,000 users with an average display rate of 85%. Would you like a detailed breakdown of the task with the highest click-through rate? ``` ## Capabilities ### Check User Online Status Asks if a specific user is currently connected or online right now. ### Send Targeted Alerts Sends push notifications to one specific user, multiple users in a list, or the entire user base. ### Find User Interest Groups Retrieves all tags associated with a user ID, helping you identify audience segments for better targeting. ### Review Campaign Performance Accesses real-time statistics on push tasks, including how many users received the message and which ones clicked it. ### Monitor User Growth Trends Gathers application-wide statistics for new and active user counts over specific date ranges. ## Use Cases ### The 'Urgent Maintenance' Alert A DevOps Engineer needs to alert every user immediately about an upcoming service outage. They tell their agent to run `push_to_all`. The agent handles the broadcast, and they follow up by asking for a status report using `get_push_status` to confirm everything went out. ### The Targeted Re-engagement Campaign A Marketing Lead wants to re-engage users who haven't logged in. They first use `get_user_tags` to find everyone tagged 'tech-enthusiast'. They then feed that list into the agent, which runs `push_to_list` with a special discount code. ### Validating User Visibility A Product Manager suspects some users are unreachable. They ask their agent to run `get_cid_status` on a small group of user IDs, instantly confirming if the accounts are online before committing resources to a massive broadcast. ### Post-Campaign Analysis A Product Ops specialist needs to report Q3 performance. They prompt their agent for the `get_daily_push_report` for the month, getting total tasks run, average display rates, and key insights in one conversational response. ## Benefits - Coordinate time-sensitive alerts instantly. Need to send a message only to users interested in 'finance'? Your agent uses `get_user_tags` to find them and runs `push_to_list`, eliminating manual segment building. - Track campaign performance without leaving your chat window. After running an alert, you can ask the agent for real-time delivery data using `get_push_status`, confirming if messages were delivered or failed. - Simplify user identification. Instead of remembering long Client IDs, use `query_user_alias` to look up a user's display name and then target them with `push_to_single` for personalized outreach. - Monitor system health continuously. You can ask the agent to check connectivity using `get_cid_status` before running any major campaign, ensuring your message doesn't fail because the user is offline. - Automate reporting. Instead of generating a spreadsheet, you simply ask for yesterday’s metrics using `get_daily_push_report`, and the agent returns the key stats right away. ## How It Works The bottom line is you manage complex messaging infrastructure using simple, conversational commands. 1. Subscribe to this MCP using your GeTui App ID, App Key, and Master Secret. 2. Connect your preferred AI client (like Claude or Cursor) through the Vinkius Catalog. 3. Start chatting with your agent; you can then ask it to run any notification task or retrieve statistics. ## Frequently Asked Questions **How do I check the status of my push campaign using GeTui / 个推 MCP?** You run `get_push_status` and provide the task ID. This verifies if a specific notification job succeeded or failed, giving you immediate confirmation without needing to navigate logs. **Can I use GeTui / 个推 MCP for marketing segmentation?** Yes. You use `get_user_tags` to pull all user interest groups (like 'hiking' or 'finance'). Then, you can pass that list of tags into the agent to target your next push campaign. **What is the best way to send a message to only one person?** Use `push_to_single` and provide the user's Client ID. This sends a direct, targeted alert to that specific individual right away. **Does GeTui / 个推 MCP handle broadcasting to everyone?** Yes, you can run `push_to_all` if you need every registered user in your system to receive a mandatory announcement at once. It handles the massive scale. **How do I find out what users are called by their display name?** Use `query_user_alias`. If you only have a Client ID, this tool looks up and gives you the corresponding user alias so you can write better copy. **How do I find my GeTui App ID and Master Secret?** Log in to the [GeTui Developer Center](https://dev.getui.com/), select your application from the dashboard, and you will find your AppID, AppKey, and MasterSecret in the application overview section. **Can I check if a specific user is currently online?** Yes. Use the `get_cid_status` tool with the user's Client ID (CID) to retrieve their current connection status to the GeTui push server. **Is it possible to list the tags for a user?** Yes! Use the `get_user_tags` tool with a Client ID to retrieve all tags associated with that user, helping you understand their segment and interests.