# GeTui MCP for AI Agents AI Agent Connect

> GeTui / 个推 MCP lets your AI agent manage push notification campaigns, user status, and delivery analytics for the Chinese market. Instead of navigating the GeTui Developer Center, you can ask your agent to broadcast messages, check who's online, or pull performance reports. It bridges your AI client to one of China's largest notification platforms for real-time engagement.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_Sd66GoE1H5ZfVP3u1Z8BbI3AJIvpAHfiwmzSH4L1/ai-agent-connect
- **Tags:** push-notifications, cpaas, mobile-engagement, campaign-management, lbs, message-broadcasting

## Description

GeTui / 个推 MCP lets you orchestrate your push notification infrastructure with one of the dominant CPaaS providers in China. Usually, managing these campaigns means jumping through hoops in a complex developer portal, filtering through user segments, and manually checking delivery rates. With this Connector, you just tell your AI agent what to do. You can ask it to send a specific alert to a subset of users or check if a certain group is currently active. It handles the heavy lifting of interacting with the GeTui platform, turning a multi-step manual process into a quick conversation. Whether you're a marketing lead trying to hit a deadline or a DevOps engineer monitoring system health, this connection gives you a direct line to your notification infrastructure. It's a huge time saver for anyone who needs to stay on top of mobile engagement without the friction of a traditional dashboard. You'll find it's much easier to keep your communication flow accurate when your AI can pull real-time stats and manage user aliases on the fly. It's one of the many high-utility connectors available on the Vinkius catalog that makes managing complex CPaaS services feel like a simple chat. By moving these tasks into your primary workspace, you stop context switching between different tabs and tools. You get to focus on the strategy of your communication while the agent handles the execution of the push tasks. This means faster response times for your users and more accurate data for your internal reports, all without the usual overhead of a manual workflow.

## Tools

### push_to_all
Broadcast push to all users. This sends a message to every single person registered in your app at once.

### get_push_status
Check push task status. This lets you see if a specific notification campaign is still sending or has finished.

### bind_user_alias
Bind alias to user. This connects a readable name to a user's unique ID so your agent can identify people easily.

### get_app_user_stats
Get application user stats. This pulls high-level data about your user base to help you track growth and engagement.

### get_cid_status
Check user online status. This tells you if a specific user is currently connected to your app in real-time.

### get_daily_push_report
Get daily push report. This retrieves a summary of the previous day's delivery and click metrics automatically.

### get_user_tags
Get user tags. This lets you browse the different categories and interests of your audience for better targeting.

### push_to_list
Send push to multiple users. This sends a targeted notification to a specific group of people based on a list.

### push_to_single
Send push to single user. This sends a direct message to one specific individual for personalized alerts.

### query_user_alias
Query user alias. This looks up the custom name associated with a user ID to help the agent identify the user.

## Prompt Examples

**Prompt:** 
```
Can you send a push to all my users telling them the app will be down for maintenance at midnight?
```

**Response:** 
```
I've initiated a broadcast push to your entire user base regarding the maintenance window. 

**Task Details:**
- **Message:** App maintenance at midnight
- **Status:** Pending
- **Target:** All Users

Would you like me to check the delivery status in 15 minutes?
```

**Prompt:** 
```
Are there any users currently online right now?
```

**Response:** 
```
I've checked the status for a few recent active IDs. Here is the current status:

| User ID | Alias | Status |
| :--- | :--- | :--- |
| 1a0918c... | User_A | Online |
| 9920a1b... | User_B | Offline |
| 4432b... | User_C | Online |

Would you like me to check more specific IDs?
```

**Prompt:** 
```
Give me a summary of how our push notifications performed yesterday.
```

**Response:** 
```
Here is the push performance summary for yesterday:

- **Total Tasks:** 15
- **Total Reach:** 120,000 users
- **Avg. Display Rate:** 85%
- **Top Performing Task:** Task #8821 (highest click-through rate)

Do you want a detailed breakdown of the top task?
```

## Capabilities

### Broadcast push notifications
Send a message to your entire user base instantly.

### Target specific user lists
Send alerts to a chosen group of users based on their IDs.

### Check real-time online status
Verify if a specific user is currently connected to your app.

### Pull daily performance reports
Get a summary of your push reach and click rates from the previous day.

### Browse audience segments
Identify user groups based on their tags and interests.

### Track user growth stats
Retrieve application-wide data on new and active users.

### Manage user aliases
Link human-readable names to specific user IDs for easier identification.

## Use Cases

### Flash Sale Alert
A marketing lead needs to notify 50,000 users of a 1-hour sale. They ask the agent to use push_to_list with a custom payload.

### System Outage
A DevOps engineer notices a spike in errors and asks the agent to use push_to_all to warn users of a maintenance window.

### User Verification
A support agent wants to see if a user is active. They ask the agent to use get_cid_status to check the connection.

### Campaign Audit
A product manager asks for a summary of yesterday's reach. The agent uses get_daily_push_report to provide the stats.

## Benefits

- Stop navigating complex dashboards by using push_to_all to broadcast messages instantly.
- Get precise audience data by using get_user_tags to identify segments for better targeting.
- Monitor real-time engagement with get_daily_push_report to see click rates and delivery.
- Identify active users quickly using get_cid_status to see who's currently online.
- Simplify user management by using bind_user_alias to attach readable names to IDs.
- Track growth trends easily with get_app_user_stats to see new user acquisition.

## How It Works

The bottom line is that you get a conversational interface for managing complex Chinese push notification infrastructure.

1. Subscribe to the Connector and enter your GeTui App ID, App Key, and Master Secret.
2. Connect the Connector to your preferred AI client like Claude, Cursor, or Windsurf.
3. Start asking your agent to send pushes, check statuses, or pull reports via natural language.

## Frequently Asked Questions

**How do I send push notifications to users in China using an AI agent?**
You can use the GeTui MCP to connect your AI agent directly to the GeTui platform. This allows you to send messages to all users, specific lists, or individuals using plain English commands.

**Can GeTui MCP help me manage marketing campaigns?**
Yes, it allows you to coordinate time-sensitive promotional pushes and audit user engagement directly from your AI workspace without needing to log into a separate dashboard.

**How can I check if a user is online using GeTui?**
The Connector provides a way for your agent to check the real-time online or offline status of specific users based on their unique Client IDs.

**Can I get daily reports from GeTui through my AI client?**
Yes, your agent can retrieve daily push reports including delivery counts, display rates, and click statistics to help you track campaign performance.

**How do I target specific user groups with GeTui notifications?**
You can ask your agent to browse user tags to identify specific audience segments and then send targeted notifications to those specific user lists.

**Is there a way to automate GeTui push tasks with Claude or Cursor?**
By connecting this Connector to Claude, Cursor, or any other compatible AI client, you can automate push broadcasts, status checks, and report gathering through natural conversation.

**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.