# Postscript MCP

> Postscript MCP connects your AI agent directly to your Shopify SMS marketing account. Manage subscribers, campaign performance, and automated keywords conversationally from any chat client. You can list all contacts, monitor abandoned cart flows, update user details, and even check overall account plan health—all without touching a dashboard.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** sms-marketing, mms-marketing, shopify-integration, customer-retention, subscriber-management

## Description

This integration lets you run your full SMS marketing operation through natural language conversation. Instead of logging into the Postscript dashboard to check metrics or manage lists, your AI agent acts as a dedicated growth manager for your brand. You can retrieve detailed subscriber information and monitor how well your campaigns are performing—for example, checking conversion rates on past promotions. Need to update someone's profile? Your agent handles it with simple commands. The entire process of managing audience data, monitoring automated flows like abandoned cart recovery, or listing all active keywords happens right in the chat window. If you use Vinkius for your MCP catalog, this connection makes sure your AI client has instant, deep access to all the tools required to keep your SMS revenue growing.

## Tools

### create_subscriber
Adds a new customer to your SMS subscriber list, making sure they are opted in.

### create_webhook
Sets up a new webhook endpoint so Postscript can send data to an external system.

### delete_webhook
Removes an existing, no-longer-needed webhook from your account.

### get_account_info
Retrieves general details about your overall Postscript marketing account and plan.

### get_campaign
Fetches detailed performance metrics for a specific SMS campaign you ran.

### get_subscriber
Retrieves all profile details and history for one specific subscriber by their identifier.

### list_automations
Lists all the automated marketing flows, such as 'Welcome Series' or 'Abandoned Cart', that are active.

### list_campaigns
Provides a list of every SMS campaign you have run or scheduled.

### list_keywords
Shows all the short code keywords used for customer sign-ups and opt-ins.

### list_subscribers
Generates a complete list of every phone number currently managed in your subscriber database.

### list_webhooks
Lists all the current, active webhooks connected to or running from your account.

### update_subscriber
Changes specific information for an existing subscriber record, like updating their name or email.

## Prompt Examples

**Prompt:** 
```
List all active SMS subscribers in Postscript.
```

**Response:** 
```
I've retrieved your subscribers. You have 1,500 active contacts. Notable recent additions include 'Alice Miller' and 'Sarah Chen'. Would you like to see the opt-in source for any of them?
```

**Prompt:** 
```
Show me the performance of all active SMS campaigns with conversion rates and revenue attribution.
```

**Response:** 
```
5 active SMS campaigns this month. "Flash Sale Friday" generated $34,200 from 12,400 messages (2.8% conversion, $2.76 revenue per message). "Abandoned Cart Recovery" recovered $18,700 across 3,400 sends (8.2% conversion). "Welcome Series" onboarded 890 new subscribers with 94% opt-in retention. "VIP Early Access" drove $12,100 from just 800 sends (highest RPM at $15.13). Total SMS revenue: $72,400. Overall unsubscribe rate: 0.4%.
```

**Prompt:** 
```
Create a new SMS campaign targeting customers who purchased in the last 30 days but have not reordered.
```

**Response:** 
```
Campaign "Re-order Reminder" created. Audience: 2,340 customers (purchased 30+ days ago, no repeat order). Message: "Missing your favorites? Come back and enjoy 15% off your next order with code RETURN15. Shop now: [link]". Scheduled: Tomorrow at 11 AM EST (optimal send time). Estimated reach: 2,280 deliverable. Projected revenue based on similar campaigns: $4,600-$6,200.
```

## Capabilities

### Manage Subscriber Lists
List every active subscriber and fetch specific details about individual user profiles.

### Monitor Marketing Campaigns
Access performance data for all your SMS campaigns and automated flows, like welcome series or cart recovery sequences.

### Control Keywords
Search through and list the keywords that manage how customers opt-in to your messaging program.

### Maintain Webhooks
Create, delete, or view webhook metadata to keep your system integrations running smoothly.

### View Account Status
Get high-level information about your Postscript account and current plan details.

## Use Cases

### Auditing a Campaign Flop
The manager needs to know why the 'Summer Sale' campaign only hit 50% of its projected audience. They prompt their agent to run `list_campaigns` and then focus on the specific performance data using `get_campaign`, immediately identifying that the messaging failed because they didn't update subscriber details first.

### Building a New Lead Nurture Flow
The marketing specialist wants to start an abandoned cart flow. They use their agent to run `list_automations`, confirming that the 'Abandoned Cart Recovery' sequence is active, and then use `get_account_info` to ensure they have enough plan capacity for the new messages.

### Handling a Data Cleanup Day
The operations team finds an old webhook pointing to a retired system. They use the agent to run `list_webhooks`, confirm the bad endpoint, and then execute `delete_webhook` instantly via chat.

### Checking New Lead Quality
A sales rep gets a list of new contacts from Shopify. Instead of manual data entry, they ask their agent to run `list_subscribers`, then use `get_subscriber` on the top 10 leads to check for detailed profile metadata and ensure everything is accurate before outreach.

## Benefits

- Stop switching apps. You can get a complete list of subscribers and their profiles using `list_subscribers` and `get_subscriber` without leaving your chat client, saving hours of context-switching time.
- Know exactly where your leads are coming from. Use `list_keywords` to review all opt-in sources instantly, giving you actionable data on which marketing channels work best for sign-ups.
- Track revenue performance without logging in. You can check the details of specific promotions with `get_campaign` and see conversion rates right when you need them.
- Automate compliance checks. Use `create_subscriber` to ensure any new lead is added while adhering to all necessary marketing regulations.
- Maintain system stability. Quickly list active webhooks using `list_webhooks` so you can verify if your critical integrations are running correctly.

## How It Works

The bottom line is that you can automate complex, multi-step marketing data checks using only conversation.

1. Subscribe to this MCP on Vinkius and enter your unique Postscript Private API Key from the platform settings.
2. Your AI agent authenticates the connection, granting it access to read and write marketing data within Postscript.
3. You simply ask your agent to perform a task—like 'Show me the performance of the last abandoned cart campaign'—and get an immediate answer.

## Frequently Asked Questions

**How do I list all my SMS subscribers using Postscript MCP?**
You use the `list_subscribers` tool. This command retrieves a full roster of every phone number in your database, letting you know exactly who is opted into marketing messages.

**Can I check campaign performance with Postscript MCP?**
Yes, use the `list_campaigns` tool first to see all available campaigns. Then, run `get_campaign` on any specific name to pull detailed metrics and revenue data.

**What is the difference between listing subscribers and getting subscriber details in Postscript MCP?**
Running `list_subscribers` gives you a simple count and list of names. Running `get_subscriber` requires a specific ID, but it returns rich metadata—like their full profile history or last activity.

**How do I make sure my automations are running correctly using Postscript MCP?**
You check the system status by using `list_automations`. This shows you if flows like abandoned cart recovery are active and configured properly for your store.

**Do I need to worry about webhooks when using Postscript MCP?**
If other systems rely on Postscript sending data, you must use `list_webhooks` first. This confirms that every connection point is active and points to the correct endpoint.