Simplero MCP server
27 operations0 webhooks
Email marketing and online courses from Simplero - manage contacts, email lists, tags and products, read purchases and subscriptions, and tag contacts or unsubscribe them from a list.
Try Simplero with your agent
Connect Simplero, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in Simplero on my account, then run one read-only example and show me the result.
Simplero tools and triggers
Tools are what your agent can do in Simplero through Corsair's MCP server. Triggers are the Simplero events a routine can start from.
Customers
- Add TagWrite
Add one tag or a list of tags to a contact, which can start the automations that tag is attached to
customers.addTag
- Adjust Lead ScoreWrite
Add to a contact's lead score and record the change in their history; customers.update replaces the score instead
customers.adjustLeadScore
- CreateWrite
Create a contact. Email and lead score are the required pair; a score sent here replaces rather than adds
customers.create
- GetRead-only
Read one contact: their name, email, phone, locale, consent flags, lead score and lifetime value
customers.get
- ListRead-only
List contacts with filters for name, email, tag, segment, list, product and stage; page by number or continue with `after`
customers.list
- Remove TagWrite
Remove one tag or a list of tags from a contact, which can stop the automations that tag is attached to
customers.removeTag
- UpdateWrite
Change part of a contact. Only the fields sent change, so an omitted field keeps its stored value
customers.update
Subscriptions
- GetRead-only
Read one subscription with whether it is active and confirmed, and when it was unsubscribed or suspended
subscriptions.get
- ListRead-only
List list subscriptions with filters for state, list, tag, email and the unsubscribe date
subscriptions.list
- ResubscribeWrite
Put an unsubscribed contact back on a list, so they receive its mailings again
subscriptions.resubscribe
- UnsubscribeWrite
Unsubscribe a contact from a list; they stop receiving its mailings. Resubscribe puts them back
subscriptions.unsubscribe
- UpdateWrite
Change a subscription's tracking data. Whether a contact is subscribed changes through unsubscribe or resubscribe, not this body
subscriptions.update
Lists
- CreateWrite
Create an email list. Name and internal name are both required by Simplero
lists.create
- GetRead-only
Read one list with its sender, confirmation settings and labels
lists.get
- ListRead-only
List the email lists on the account with their names and handles
lists.list
- UpdateWrite
Change part of a list, such as its name, sender or whether signups need confirmation
lists.update
Products
- CreateWrite
Create a product. Name and internal name are both required by Simplero
products.create
- GetRead-only
Read one product with its descriptions, listing type and product type
products.get
- ListRead-only
List the products on the account, filtered by name, listing type or whether they recur
products.list
- UpdateWrite
Change part of a product, such as its name, summary or listing type
products.update
Tags
- CreateWrite
Create a tag, which contacts can then be tagged with
tags.create
- GetRead-only
Read one tag with its colour, owner and how many contacts carry it
tags.get
- ListRead-only
List the tags on the account, optionally only those one owner created
tags.list
- UpdateWrite
Change part of a tag, such as its name, description or colour
tags.update
Purchases
- GetRead-only
Read one purchase with its state, amounts, buyer details and dates
purchases.get
- ListRead-only
List purchases with filters for state, customer, product, price and the purchase, cancel and refund dates
purchases.list
- UpdateWrite
Change a purchase's buyer details and marketing preferences. Money movements (refund, cancel, capture, change price) are separate actions and are not wrapped
purchases.update
Connect Simplero to Claude, ChatGPT or Cursor
- 1
Connect Simplero in Corsair
Add your Simplero API key once in Corsair. Corsair stores the credential encrypted and makes the Simplero API calls for your agent, so it never goes into a prompt or a config file. Connect Simplero
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs Simplero. On a ChatGPT personal plan, connect Simplero here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. None of Simplero's operations are destructive, so in the default Cautious mode they all run right away. Strict mode asks before each of its 15 writes, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/simplero, add the Simplero plugin, and connect with an API key. Then call methods like corsair.simplero.api.customers.addTag() from your app. Corsair keeps each tenant isolated.
Yes. Simplero requires an API key from your Simplero account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit Simplero, GitHub, Notion, Stripe, and the rest. Trigger Simplero from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for email marketing and online courses from Simplero - manage contacts, email lists, tags and products, read purchases and subscriptions, and tag contacts or unsubscribe them from a list. Common builds include sync jobs, admin tooling, and agents that call Simplero APIs from your backend.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per Simplero API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/simplero in the open repo. When Simplero ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your Simplero data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store Simplero data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put Simplero on a link in Strict mode and every write waits for your approval, while destructive actions are refused. None of the Simplero operations are destructive, so the default Cautious mode runs them all without asking. You can change a link's mode at hub.corsair.dev/me.