What is MCP?
MCP means Model Context Protocol. It is a safe way for an AI assistant to work with your PushOwl account. The AI can only do what you turn on. It only works for your shop.
Before you start
Sign in to PushOwl with your usual account. Go to Settings, then Global, and look for the MCP tab.
Step 1 - Open MCP settings
Go to Settings, open Global, and click MCP.
You will either see "No MCP credentials" or a list of credentials you already made.
Step 2 - Create a credential
A credential is how PushOwl knows which AI app you are connecting. You can have up to five at a time. If you are at the limit, revoke one you no longer use.
Click Create credential. Give it a label you will recognise later, like Claude or ChatGPT.
Redirect URIs are optional. Only fill it in if your AI app's help page tells you to. Most people can leave it blank.
Click Create credential again to finish.
Step 3 - Copy the details into your AI app
After you create the credential, you will see a summary with two things:
MCP Server URL - where your AI app connects to PushOwl (shown when your store is set up for it).
Client ID - a long code that identifies this credential.
Use the copy buttons so you do not mistype anything. Paste both values into your AI app's MCP or connector settings. If you are not sure where those fields are, check your AI app's own setup guide.
In this guide, we’ll use Claude. Visit Claude.ai, go to Settings → Customise → Connectors → Add Custom Connectors. Click on Add after filling the credentials and proceed to Connect.
Step 4 - Approve the connection
When the AI app tries to connect, your browser will open a PushOwl page. Click Allow to finish the setup.
If you see a warning about an unregistered redirect URI, the AI app wants to send you to a web address that was not on your credential yet. Approve it after you veirfy that it matches your AI provider's docs.
Step 5 - Choose what the AI can do (recommended)
On the MCP list, open Allowed tools for that credential. Pick the actions you are comfortable with. You can search, pick whole categories, or use Select all or Clear.
Restricting access to only what’s needed for everyday use is one of the most effective ways to improve security and reduce unnecessary risk.
If you leave Allowed tools empty, the AI cannot do anything, even after you approved the connection.
What can the AI do?
These tool names are the same ones listed under Allowed tools in Settings, Global, MCP. Some tools only view your numbers and reports. Others actually change something in your store. When a tool can change things, PushOwl usually shows you a preview first and asks you to confirm before it saves anything.
Automations
View All Automations - See all automation types, status, and performance.
View Automation - See one automation in detail.
Toggle Automation - Turn an automation on or off.
Tune Automation - Change automation settings like timing or rules.
Channel dashboards
View Email Dashboard - Email subscribers, click rate, and revenue.
View SMS Dashboard - SMS subscribers, revenue, and campaigns sent.
View Webpush Dashboard - Webpush subscribers and revenue.
Webpush
View Webpush Subscribers - How many subscribers you have and revenue.
View Webpush Campaign Analytics - List campaigns with revenue, orders, and conversion.
View Webpush Campaign Detail - Stats for one campaign.
View Campaign Order Match - Check webpush orders against Shopify orders.
Compare Channel Revenue - Compare revenue across webpush, email, SMS, and your store.
Schedule Webpush Campaign - Send or schedule a webpush with title, message, and link.
Opt-in and popups (v1)
View Optin Analytics - Opt-in funnel for a date range.
View Optin Flow Analytics - Stats for specific opt-in flows.
Create Optin Form - Add an embedded opt-in form on your store.
Create Popup - Add a popup opt-in on your store.
View Popup Analytics - How your popups performed.
View Popup Step Funnel - Step-by-step stats for one popup.
Email and SMS (Brevo)
View Email Campaign Summary - Email KPIs and recent sends.
View Email Campaign Analytics - List email campaigns with opens and clicks.
View SMS Campaign Summary - SMS totals and last send.
View SMS Campaign Analytics - List SMS campaigns.
View Contact Counts - How many email and SMS contacts you have.
View Brevo Lists - Your Brevo contact lists.
View Revenue Attribution - Revenue attributed to Brevo campaigns.
Save Template to Brevo - Save an email template to Brevo.
Some email and SMS numbers come from data synced in PushOwl. Others come live from Brevo. A few attribution fields only show when synced data is available.
Managing credentials later
To see the Server URL and Client ID again, click the credential row (not Revoke). The summary opens again.
To disconnect an AI app, click Revoke. You cannot undo this. The app will stop working until you create a new credential and connect again.
You can only have five active credentials. Remove one before adding another if you are at the limit.
Something not working?
Authorisation failed or unknown client - You might be on the wrong shop, or the credential was revoked. Sign in to the right account or create a new credential.
AI says it cannot do something - Open Allowed tools for that credential and turn on the action you need.
Staying safe
Revoke any credential you no longer use.
Your AI may ask you to approve again after a while. That is normal.