Which integrations are available for this server?

Allows AI agents to manage SMS marketing for Shopify stores via Postscript, with tools to query subscribers, look up opt-in keyword IDs, add subscribers with consent, list campaigns, and check audience segment sizes.

How do I use postscript-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@postscript-mcp check the size of my VIP segment" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

postscript-mcp

License: MIT Python MCP

MCP server for Postscript, the SMS marketing platform for Shopify e-commerce stores. 5 tools for AI copywriting and marketing agents to query subscribers, look up opt-in keyword IDs, add new subscribers (with proper consent flow), list active SMS campaigns, and check audience segment sizes before drafting SMS blasts.

As of May 2026, Postscript does not have an official MCP server. The community attempt is a zero-star placeholder. This is the production-quality rail to fill that gap.

The 5 tools

Tool	Purpose
`list_subscribers`	Query the active SMS subscriber list
`get_keyword_id`	Look up SMS opt-in keyword IDs (required for compliant subscriber creation)
`add_subscriber`	Add a new phone number to a list, tied to a documented consent flow
`list_campaigns`	Retrieve recent SMS campaigns and their deployment status
`check_segment_size`	Look up audience segments and their subscriber counts

Install

pip install postscript-mcp

Configure

export POSTSCRIPT_API_KEY="your-postscript-private-api-key"

Get a Postscript Private API Key in your Postscript dashboard under Apps -> API. The key is sent as a Bearer token; vault it server-side only.

Use with Claude Desktop

{
  "mcpServers": {
    "postscript": {
      "command": "postscript-mcp",
      "env": {
        "POSTSCRIPT_API_KEY": "your-postscript-private-api-key"
      }
    }
  }
}

Restart Claude Desktop. The 5 Postscript tools are now available.

Use case: AI SMS marketing assistant

Typical agent flow:

Call check_segment_size() to see which audience segments exist and how many subscribers each contains. Pick the right one for the campaign.
Call list_campaigns() to see what has already been sent and avoid sending a duplicate.
(For subscriber growth flows) Call get_keyword_id() to find the consent-flow keyword for the right list, then add_subscriber(phone_number, keyword_id) to add a new opt-in.
Drafting an SMS: use the segment + subscriber data to scope the message correctly before passing it to a downstream SMS-send tool (Postscript send endpoints are intentionally NOT in this MCP to keep the rail safe).

Compliance note

SMS subscriber creation is regulated under TCPA (US) and CTIA carrier requirements. The add_subscriber tool always requires a keyword_id, which ties every new subscription to a documented consent flow you previously configured in Postscript. This MCP does not provide a way to add subscribers without a keyword_id. Do not attempt to bypass this; non-consented subscribers are a compliance and legal risk for the merchant.

Architecture

Public MIT-licensed wrapper around the Postscript REST API v2
Async HTTP via httpx
pydantic v2 input validation
Bearer token auth, server-side only
Rate-limit aware (429 returns a clean error)

Development

git clone https://github.com/NoBanks/postscript-mcp.git
cd postscript-mcp
pip install -e ".[dev]"
pytest

License

MIT. See LICENSE.

Author

Ryan Hammer (NoBanks). Solo founder + engineer. Built this and 10 other MCP servers as part of a sprint to expose AI agent rails for the products and platforms shipping daily.