# Airship MCP for AI Agents MCP

> Airship connects mobile and web engagement orchestration tools to your AI agent. This MCP lets you manage push notifications, audit subscriber segments, and map user devices across multiple channels using natural conversation. It turns complex multi-channel communication strategy into simple chat commands.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** mobile-engagement, push-notifications, omnichannel, customer-segmentation, user-retention, mobile-marketing

## Description

You need to run a massive campaign that hits users across iOS, Android, and web, but managing all those touchpoints manually is a nightmare of dashboards and API calls. This MCP connects your Airship account directly to your AI agent, letting you handle multi-channel communication strategy through conversation.

Instead of logging into three different consoles to send alerts or check delivery status, you just ask your agent. You can tell it to trigger targeted push notifications for a specific group, audit the criteria behind an audience segment, or even see which devices are linked to a single customer profile. This gives you total control over your entire user lifecycle—from initial segmentation research to final delivery confirmation. When you connect this through Vinkius, all those complex communication tools become accessible via one simple interface for your AI agent.

## Tools

### send_push_notification
Sends a push alert message out to the targeted audience.

### list_segments
Retrieves a list of all existing audience segments defined in your account.

### get_segment_details
Pulls the specific criteria—the tags and attributes—used to build a chosen segment.

### list_named_users
Displays a list of all named users set up in your system.

### associate_named_user
Links a specific device (like an iPhone or Android) to a known customer profile.

### list_channels
Lists all available communication channels, such as iOS, Android, and Web.

### get_channel_details
Retrieves technical details about a specific device or channel type.

### list_static_lists
Lists pre-defined static audience groups, often created from CSV uploads.

### list_tags
Shows all the custom tags available to categorize your audience members.

### get_push_status
Checks the delivery status and success rate of recent push notifications sent out.

## Prompt Examples

**Prompt:** 
```
Send an urgent push alert to everyone who hasn't opened the app in 30 days. The message should be 'We miss you! Check out our new features.'
```

**Response:** 
```
**✅ Push Notification Triggered**

*   **Target Segment:** Inactive Users (Last 30 Days)
*   **Status:** Scheduled
*   **Channels Affected:** iOS, Android, Web
*   **Operation ID:** ABC-9876

A delivery status report is pending. I recommend checking the `get_push_status` tool in about 5 minutes to confirm successful distribution.
```

**Prompt:** 
```
What are the criteria for our 'Platinum Tier' segment? Also, list all active channels.
```

**Response:** 
```
**📈 Segment & Channel Audit**

**Segment Details: Platinum Tier**
*   `Membership Level`: Platinum
*   `Total Spend`: > $1000
*   `Last Purchase Date`: Within 90 days

**Active Channels:**
*   📱 iOS (Metadata: Version 17, Registered: Yes)
*   🤖 Android (Metadata: Build 34, Registered: Yes)
*   🌐 Web (Metadata: Browser type, Last Active: Today)
```

**Prompt:** 
```
Map my laptop and phone to the same account. My devices are listed as 'laptop-xyz' and 'phone-abc'.
```

**Response:** 
```
**🔗 User Profile Update**

The two devices have been successfully linked to a single user profile.

*   **User ID:** U12345678
*   **Associated Devices:** [laptop-xyz, phone-abc]
*   **Tags Added:** 'Multi-Device User'

You can now send communications that target the user, regardless of which device they open it on.
```

## Capabilities

### Send Targeted Push Alerts
Trigger a push notification message instantly to specific user groups, segments, or the entire audience.

### Audit Audience Segments
List and review the exact criteria—tags and attributes—that define your existing audience segments.

### Map User Devices to Profiles
Manage named users, linking multiple devices (like an iPhone and a web browser) back to one single customer account.

### Check Channel Metadata
List all active communication channels—iOS, Android, Web, Email—and retrieve technical details for each one.

### Monitor Delivery Status
Get a quick report on whether recent push notifications were successfully delivered to the target devices.

## Use Cases

### Auditing Device Consistency After a Product Launch
A product owner needs to verify that all new users are correctly mapped across platforms. They ask their agent, 'Show me the details for this user's channels.' The agent uses `get_channel_details` and `list_named_users`, confirming that both the iOS app and web browser are linked to the single customer profile.

### Launching a Time-Sensitive Sale Campaign
A marketing manager needs to hit high-value subscribers immediately. They prompt their agent, 'Send an urgent sale alert only to users tagged 'Premium' and who haven't logged in for 7 days.' The agent coordinates the `send_push_notification` using specific segment criteria.

### Researching Segment Requirements
A growth specialist needs to build a new lifecycle campaign. They ask, 'What are the criteria behind our current 'High Potential' group?' The agent uses `get_segment_details` and `list_tags`, giving them the precise data structure needed for their next marketing push.

### Verifying Static List Compliance
An operations lead is worried about outdated user lists. They ask, 'List all static audiences we maintain.' The agent uses `list_static_lists` to provide an inventory, letting the lead quickly verify if any old campaigns are still pointing to unmaintained groups.

## Benefits

- Run complex campaigns without leaving your chat interface. Instead of jumping between dashboards to send a targeted push notification, just ask the agent to execute it.
- Understand exactly who you're talking to. You can use the `get_segment_details` tool to instantly audit segment criteria, ensuring your audience lists are accurate before launching any campaign.
- Maintain clean customer records. Use the `associate_named_user` tool to map every device—whether it’s an Android tablet or a web browser—to one consistent user profile.
- Confirm delivery success immediately. After running a large push notification, use `get_push_status` to quickly confirm if the message was delivered across all intended channels.
- Audit your tech stack on demand. You can list and check details for every communication channel (`list_channels`, `get_channel_details`) without needing to navigate complex platform menus.

## How It Works

The bottom line is, your AI client handles all the secure authentication and complex API calls so you only have to talk conversationally to get things done.

1. Subscribe to this MCP and provide your Airship App Key, Master Secret, and Region (US or EU) credentials.
2. Your agent uses these credentials to connect directly to the Airship platform's data sources.
3. You then issue natural language commands—like 'Send a sale alert to premium users'—and the agent executes the multi-step process using the necessary tools.

## Frequently Asked Questions

**How do I use Airship MCP to manage my multi-channel push campaigns?**
You simply ask your agent. Instead of manually navigating the platform, you tell the system what message to send and who needs to receive it across iOS, Android, or web. The agent handles the complex orchestration.

**Can Airship MCP help me check if my audience segments are accurate?**
Yes. You can ask the agent to pull segment details using criteria and tags. This confirms that your target groups—like 'Premium Subscribers'—are built using the exact rules you intended.

**What is the best way to link my physical devices to a single user profile?**
You use the MCP to map named users. This process links multiple specific devices (like your phone and tablet) back to one consistent customer record, ensuring all messages hit the right person.

**If I run a push notification, how do I know if it actually got delivered?**
The MCP lets you check delivery status. You ask for a report on recent sends, and the agent provides a clear audit showing which channels received the message and whether they were successful.

**Does Airship MCP help me find out what tags I have available?**
Absolutely. You can request a list of all current audience tags and attributes, giving you an immediate inventory of how your customers are segmented within the platform.