# Postscript MCP

> Postscript MCP Server drives e-commerce revenue by letting your AI client manage all SMS and MMS marketing campaigns for Shopify stores. It gives you direct access to subscriber metadata, campaign performance metrics, and automated keyword management—all through natural conversation.

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

## Description

Postscript MCP Server lets your AI client manage every angle of your SMS and MMS marketing campaigns for Shopify stores. You get direct access to subscriber metadata, campaign performance metrics, and keyword management—all through natural conversation with your agent.

### Managing Your Contacts
Your agent handles all subscriber data. Use `list_subscribers` to pull a summary rundown of every SMS contact you have on file. If you need deep info on just one person, run `get_subscriber` to grab that user's complete profile and metadata. You can also modify an existing profile using `update_subscriber` if someone changes their details. Need to get new people signed up? Use `create_subscriber` to subscribe a fresh user to your SMS marketing list; just remember compliance rules apply there.

### Running Campaigns and Checking Results
When it comes to campaign results, you're always in control. You can use `list_campaigns` to pull a summary of every single campaign you've run or set up over time. If you want the nitty-gritty details on one specific effort, `get_campaign` pulls detailed performance metrics for that single SMS campaign. For automated sequences—like those abandoned cart flows—you can use `list_automations` to see a list of all active automation workflows running right now.

### Monitoring Your System and Opt-Ins
Your agent keeps tabs on how your system is wired up, too. You'll find that you can check the status of every webhook connection using `list_webhooks`, or if you need to clean house, you can use `delete_webhook` to remove an old one, or even `create_webhook` to set up and activate a brand-new endpoint for data transfer. For high-level oversight, run `get_account_info` to pull overall details about your Postscript account and current plan level.

When it comes to how people find you, the agent handles keyword management. Use `list_keywords` to see every mobile keyword that users use when they opt in to your texts. This keeps a clear picture of what's driving sign-ups.

### Putting It All Together
Your AI client acts like a dedicated marketing manager for your Shopify store, handling all the heavy lifting without forcing you to open up any dashboards. You don't need to manually check subscriber status or run reports; your agent just handles it through simple conversation. You can track engagement metrics from campaigns and automate flows while also making sure every single user profile is accurate.

## Tools

### create_subscriber
Subscribes a new user to your SMS marketing list (compliance rules apply).

### create_webhook
Sets up and activates a brand-new webhook endpoint.

### delete_webhook
Removes an existing, active webhook connection.

### get_account_info
Retrieves high-level details about your Postscript account and plan.

### get_campaign
Pulls specific performance and detail metrics for a single SMS campaign.

### get_subscriber
Gets the complete profile data and metadata for one specific subscriber.

### list_automations
Lists all active SMS automation flows, such as abandoned cart sequences.

### list_campaigns
Retrieves a summary list of every campaign you've run or set up.

### list_keywords
Lists all the mobile keywords that users use to opt-in to your service.

### list_subscribers
Returns a summary list of all SMS subscribers currently on file.

### list_webhooks
Shows a rundown of all active webhook connections and their status.

### update_subscriber
Modifies the details (metadata) for an existing subscriber profile.

## 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 all SMS subscribers or pull specific profile data (metadata) on any single user.

### Monitor Campaign Results
Retrieve details and performance metrics for active SMS campaigns and automated flows.

### Control Opt-In Keywords
Search through, list, and manage the keywords that users use to subscribe to your texts.

### Update User Details
Modify existing subscriber information on a user's profile.

### Set Up Webhooks
Create, list, or delete webhooks to connect Postscript data to other systems.

## Use Cases

### Auditing Campaign Performance
A marketer needs to know which of their three main SMS campaigns generated the most revenue last month. Instead of navigating the campaign dashboard, they ask their agent: 'Show me performance for all campaigns.' The agent runs `list_campaigns` and then drills down using `get_campaign`, providing a clear ranking by total attributed revenue.

### Troubleshooting Webhooks
The ops team notices that new subscriber data isn't appearing in the CRM. They ask their agent to 'List all active webhooks and check for errors.' The agent runs `list_webhooks`, identifies a stale webhook, and then uses `delete_webhook` followed by `create_webhook` to fix the connection.

### Targeting VIP Users
A store owner wants to run a special promotion only for users who have high value. They ask their agent to 'Find all subscribers with premium metadata.' The agent uses `list_subscribers` and filters the results using `get_subscriber`, allowing the marketer to send a highly targeted message.

### Scaling Keyword Strategy
The marketing lead suspects a keyword is underperforming. They ask their agent, 'Which keywords should I pay more attention to?' The agent runs `list_keywords`, showing the volume and usage of every opt-in source, helping them reallocate resources.

## Benefits

- Check campaign health instantly. Instead of digging through reports, you ask the AI agent to pull `get_campaign` data, getting metrics like conversion rates and total revenue immediately.
- Build out complex flows without leaving chat. You can list automations using `list_automations` or get detailed info on a single user's history with `get_subscriber`, all from one interface.
- Keep track of growth sources easily. Use `list_keywords` to see exactly which terms are driving opt-ins, giving you immediate insight into marketing success channels.
- Handle technical setup in chat. Need to connect a new system? You can use `create_webhook` and then monitor it with `list_webhooks`, skipping the manual dashboard flow entirely.
- Manage your base data quickly. Use `list_subscribers` for an overview or `update_subscriber` if you need to correct metadata on a specific user's profile.

## How It Works

The bottom line is you manage your entire SMS marketing operation using natural language commands, never having to switch apps or navigate complex dashboards again.

1. First, subscribe to this server and enter your Postscript Private API Key into the client settings.
2. Next, tell your AI agent what you need. For example: 'What was the revenue from last week's flash sale campaign?'
3. The agent runs the necessary tool calls (like `get_campaign`) and returns a plain text summary of the results right in the chat.

## Frequently Asked Questions

**How do I find out if a keyword is active using list_keywords?**
The agent runs `list_keywords` and provides an overview of every opt-in source you have set up. This shows which keywords are currently active for subscribers to use.

**Can I update a user's data using the update_subscriber tool?**
Yes, `update_subscriber` allows you to modify specific metadata on an existing subscriber profile. You just tell the agent what field to change and the new value.

**How does get_campaign help me check revenue?**
`get_campaign` pulls detailed metrics for a single campaign, including conversion rates and total attributed revenue from that specific outreach effort.

**What is the difference between list_subscribers and get_subscriber?**
Use `list_subscribers` when you need a high-level count or summary of your entire base. Use `get_subscriber` when you need deep, specific metadata on one single person's profile.

**How do I check my active webhook connections using list_webhooks?**
It lists all existing webhooks, showing their current status, associated endpoint URLs, and when they were last accessed. This helps you monitor which systems are correctly connected to Postscript.

**What details does the get_account_info tool provide about my Postscript plan?**
This function retrieves high-level account metadata, including your current usage limits, billing cycle status, and overall service tier. You can use it to confirm if you're approaching any capacity restrictions.

**Using list_automations, how do I view the types of SMS automations available?**
It provides a clear roster of your configured flows (like abandoned cart sequences). You get the name, trigger type, and last run date for every automated series you've set up.

**What data must I provide when calling create_subscriber to ensure compliance?**
You must include all required fields specified by Postscript's compliance rules. The tool will flag any missing or improperly formatted mandatory data points before completing the subscription.

**Can my AI automatically find the details for a specific SMS subscriber by providing their ID?**
Yes! Use the `get_subscriber` tool with the Subscriber ID. Your agent will respond with the complete metadata for the profile, including opt-in status and association keywords in seconds.

**How do I find my Postscript Private API Key?**
Log in to your Postscript account, navigate to **Settings** > **API**, and you will find your unique secret Private Key (starting with `sk-`) there.

**Can I use the AI to see my SMS campaigns?**
Absolutely. Use the `list_campaigns` tool to retrieve all your sent and scheduled SMS campaigns, along with their metadata and performance metrics.