PopMCP
privy_create_Add a new contact.
Privy MCP server for your AI
Ask which popups and flows are earning, look up why someone got a message, tidy tags and consent, and send your own orders and events into Privy, from chat.
PopMCPPrivy
How did my store do in Privy over the last 30 days, compared with the month before?
Supported Privy tools
Every operation in the Privy API, with the everyday contact and reporting tools loaded by default and the rest, from contact imports to store collections, one search away. This is Privy for online stores, the popups, email and SMS platform.
45 tools in the full catalog: 38 read and 7 write. 35 load by default, and the rest are found with tool search.
privy_delete_Ask the person first.
privy_find_Find one person by cus_ id, email or phone number, with their consent, tags, custom fields and which displays they signed up on.
privy_get_Get campaign performance.
privy_get_Get a contact.
privy_get_Get display performance.
privy_get_Get flow performance.
privy_get_Get business report summary.
privy_list_List campaign performance.
privy_list_List a contact's activity.
privy_list_List contacts, newest first.
privy_list_List display performance.
privy_list_List flow performance.
privy_list_List top products.
privy_performance_How is Privy doing? The period's signups, subscribers, attributed revenue and orders, compared with the period before, with the top campaigns, flows and displays.
privy_update_Change a contact.
privy_update_Add or remove a contact's tags without touching the others.
privy_upsert_Add a contact, or update them if they already exist, keeping their other tags and custom fields.
privy_list_List products.
privy_check_Check which read permissions this token really has, since Privy does not list them.
privy_check_Check a coupon code.
privy_get_The Privy account this connection is pinned to: id, name and website.
privy_get_Get account setup.
privy_list_List coupons.
privy_list_List orders.
privy_list_List the people in a segment.
privy_list_List segments.
privy_report_Add or update an order that happened outside a connected store.
privy_get_Get a campaign.
privy_get_Get a display.
privy_get_Get a flow.
privy_list_List campaigns.
privy_list_List displays.
privy_list_List flows.
privy_send_Send a custom event about one contact.
privy_get_Get a product collection.
privy_get_Get a product.
privy_list_List a collection's products.
privy_list_List product collections.
privy_list_List a product's collections.
privy_get_Get a coupon.
privy_get_Get an order.
privy_get_Get a segment.
privy_get_Get a contact import.
privy_list_List contact imports.
Connect Privy to Claude, ChatGPT and Claude Code
Credentials off one Privy screen, then an endpoint your client signs into. Nothing to deploy, and nothing to install.
In the Privy dashboard open Settings, then API Tokens, click Create Token, name it, tick the permissions, choose how long it lasts and paste the token into PopMCP. API access comes with a paid Privy plan, and needs no app or approval. PopMCP lists your account and any subaccounts the token reaches, and locks the connection to the one you choose.
API token
••••••••••••3f7aConnectionVerified
Adding, changing and deleting contacts, reporting orders and sending events are writes and wait until an owner or admin allows write actions; new connections start read-only. The permissions ticked on the token apply as well, and Privy refuses anything outside them.
Reach Privy
Reach other connectors
Teammates on read-only
Drop the PopMCP URL into Claude, ChatGPT, Claude Code, Codex or any other supported client. It signs in through PopMCP with OAuth, so your Privy credential never leaves the server.
app.popmcp.com/mcp
Claude wants to connectApproveAsk for something harmless before the agent changes anything. Writes run as soon as it calls them, so confirm it reads the right account first.
How did my store do in Privy over the last 30 days, compared with the month before?
privy_performance_overviewok
Then just ask for the work
“How did my store do in Privy over the last 30 days, compared with the month before?”
- performance_overview
“Which of my popups brings in the most signups, and which one is not working?”
- list_display_performance
- list_displays
“Why did jane@example.com get that email yesterday?”
- find_contact
“Add the vip tag to jane@example.com without touching her other tags”
- update_contact_tags
“How is my abandoned cart flow doing, step by step?”
- list_flows
- get_flow_performance
“Is my discount code wired to the right popups, and has this code been used?”
- list_coupons
- check_coupon_code
“Send a quiz_finished event for this customer so my flow picks them up”
- send_event
Use Privy from the assistant you already open
One hosted endpoint, registered once per client. The same tools and the same permissions, whichever window the request comes from.
Claude DesktopCustom connector
Add the PopMCP URL under Customize → Connectors and the tools appear in every chat.
Claude WebCustom connector
The same endpoint, registered in the browser. Nothing to install on the machine you are working from.
ChatGPTCustom connector
Register PopMCP as a custom connector, then let ChatGPT read and update the account.
CodexDesktop & CLI
Wire the endpoint into Codex or the Codex CLI when a task needs live business context, not a fixture.
OpenCodeCoding agent
Register the remote MCP server in OpenCode's config for terminal-first and scripted agent runs.
ZCodeDesktop app
Add PopMCP as an MCP server in Z.ai's desktop app and work the account from the same window.
Explore other MCP servers
Every one of them runs on the same hosted endpoint, with the same controls.
FAQ
Privy MCP server questions
What teams ask before putting Privy behind an AI client.
Which Privy is this?
Privy at privy.com, the popups, email and SMS platform for online stores. It is not the crypto wallet company at privy.io, which is a separate business with its own keys. If you paste a key from there, PopMCP tells you so.
What does PopMCP need to connect Privy?
One API token. In the Privy dashboard open Settings, then API Tokens, click Create Token, name it, tick the permissions and choose how long it lasts. Privy shows the token only once, so copy it and paste it into PopMCP, which stores it encrypted. The token never reaches your AI client.
Do I need a paid Privy plan?
Yes. Privy only offers API access on paid accounts and answers api_access_required otherwise. If you are on a paid plan and still see that, Privy's support team can turn it on.
Which permissions should I tick on the token?
All of them if you want everything to work, or only the ones ending in _read for a read-only token. Reports need reports_read on its own, even when the token can read the campaigns and flows being reported on. Privy does not list what a token holds, so privy_check_access tests the read permissions, and a refused call names the one that is missing. To add one, create a new token.
I run several stores as subaccounts. How does that work?
When you create the token, choose which subaccounts it can reach. Privy fixes that when the token is made. PopMCP lists your main account and those subaccounts, and each connection is for one of them. A request for another account is refused, not answered with the wrong store's numbers. To work with several, connect each one.
Can the AI build a popup or send a campaign?
No. Privy's API reads displays, campaigns, flows, segments and coupons but does not create or send them, so those stay in the Privy dashboard. Through the API you can add and change contacts, report orders and send custom events. An event or an order can start a flow you already built, which can message real customers, so the AI should ask first.
Will changing a contact send them anything?
Setting SMS consent to subscribed sends a real welcome text unless send_welcome_sms is false. Only record consent the person really gave. Reporting an order or sending an event can start flows, while initial_sync on an order loads past orders without starting anything.
Do I have to use contact ids?
No. Contact tools take a Privy contact id, an email address or a phone number with its country code, and look up the id for you. Numbers from a dashboard URL are not API ids, and the tool says where to find the right one. A plain update replaces every tag, so update_contact_tags and upsert_contact are there to add or remove one and keep the rest.
Can I stop the AI from changing anything?
Yes. Every connection starts read-only, which keeps contacts, results and everything set up readable and blocks every change. An owner or admin can allow write actions later. A token with only read permissions is a second lock, on Privy's side.
Do I have to run or host the Privy MCP server myself?
No. PopMCP hosts it and gives you a Streamable HTTP MCP URL. There is nothing to deploy, no callback URL to register, and no infrastructure to keep running or patch.
Which AI clients can use this MCP server?
Any client that supports a remote Streamable HTTP MCP server: Claude Desktop, Claude Web, Claude Code, ChatGPT custom connectors, Codex and the Codex CLI, OpenCode and Z.ai's ZCode, as well as editors such as Cursor, Windsurf and Zed. Your client signs in to PopMCP with OAuth; the provider credential never leaves the server.
How do I connect Privy to Claude Code?
Connect Privy in PopMCP first, then run claude mcp add --transport http popmcp https://app.popmcp.com/mcp in a terminal. Inside Claude Code, run /mcp and sign in to PopMCP in the browser window it opens, ticking Privy on the consent screen. The Privy tools are then available in that session, and no Privy credential is stored on your machine.
Why do only 35 of the 45 tools load by default?
Loading 45 tool definitions into every conversation burns context before the work starts. PopMCP loads a curated 35-tool set covering the everyday workflows and keeps the rest searchable, so your AI pulls a specialist tool only when a task needs it. Every tool stays searchable, and on Scale the owner can load the full catalog for a teammate's connection.
What is the difference between a tool and a trigger?
A tool is something your AI calls, and there are 45 here. A trigger is something PopMCP watches for you: 13 Privy events that can start work on the PopMCP side. Triggers never enter your AI client's context, and none of them ask you to paste a callback URL into Privy.
Connect Privy to your AI in minutes
Launch a hosted MCP endpoint for Privy, keep tool access under control, and start testing real workflow prompts right away.