@charisol/plexo-mcp 1.1.1 β 1.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +3 -1
- package/dist/pageToolDefs.js +87 -0
- package/package.json +1 -1
- package/src/pageToolDefs.ts +87 -0
package/README.md
CHANGED
|
@@ -8,7 +8,7 @@ Connect **Claude Desktop**, **Claude Web**, **ChatGPT**, **Cursor**, **Windsurf*
|
|
|
8
8
|
|
|
9
9
|
## Capabilities & Tools
|
|
10
10
|
|
|
11
|
-
- π§± **Building pages (V2)** β `page_create_from_template`, `page_describe`, `page_edit`, `page_publish`, `blog_layout_describe`, `blog_layout_edit`: visual pages and sites the owner can keep editing in Plexo's visual editor. See [Building pages (V2)](#building-pages-v2).
|
|
11
|
+
- π§± **Building pages (V2)** β `page_create_from_template`, `page_describe`, `page_edit`, `page_publish`, `sell_product_on_page`, `blog_layout_describe`, `blog_layout_edit`: visual pages and sites the owner can keep editing in Plexo's visual editor. See [Building pages (V2)](#building-pages-v2).
|
|
12
12
|
- π **`publish_landing_page`** *(deprecated)*: Creates, compiles, and publishes a landing page (JSON schema + HTML) to a subdomain or custom domain in 1 step.
|
|
13
13
|
- βοΈ **`create_email_template`**: Creates and saves a responsive email template (same JSON schema as landing pages, no domain).
|
|
14
14
|
- βοΈ **`update_template`**: Edits an existing landing page or email template in place, under the same template ID.
|
|
@@ -77,6 +77,8 @@ Everything visual an assistant builds with Plexo β landing pages, whole sites,
|
|
|
77
77
|
3. **`page_edit`** `{ templateId, commands[], slug? }` β section commands: `addSection`, `updateSection`, `removeSection`, `moveSection`, `duplicateSection`, `setBrand`, `renamePage`. Each command is checked on its own (good ones are saved, bad ones come back with a plain-English reason). Changes are saved as the page's working copy, exactly like the editor's autosave.
|
|
78
78
|
4. **`page_publish`** `{ templateId, domain?, type? }` β puts the latest changes live; for a site's home page pass a `domain` (a short subdomain or the owner's own). If the site has no address yet the reply lists `suggestedDomains`.
|
|
79
79
|
|
|
80
|
+
5. **`sell_product_on_page`** `{ siteId, productId? | name + price, deliveryUrl?, pageId?, convertLinks?, paymentLink?, β¦ }` β makes a page sell one product end to end; every purchase is recorded as an order in Commerce. One call does whatever is still missing: creates the product from `name` + `price` (a course or download; `deliveryUrl` is where buyers get it after paying), turns Commerce on with Plexo's own Paystack (no keys needed), and either switches the page's existing hosted payment links (Flutterwave, Paystack, Selar, Stripe payment links, Gumroadβ¦) to Plexo's on-page checkout β so the page keeps its design β or adds a buy card when there is none. Works on visual pages, classic pages, hand-written HTML pages and React apps (where it returns what to place and which link to change). Any button can open the checkout with `href="#plexo-buy-<productId>"`. Safe to repeat; if the page has several different payment links it leaves them and asks which one (`paymentLink`).
|
|
81
|
+
|
|
80
82
|
Blog post and listing layouts use **`blog_layout_describe`** / **`blog_layout_edit`** `{ templateId, kind: "post" | "listing", commands[] }` the same way.
|
|
81
83
|
|
|
82
84
|
Write real, specific copy for the business β never placeholder text. Email templates are unchanged and still use `create_email_template` / `update_template`.
|
package/dist/pageToolDefs.js
CHANGED
|
@@ -144,6 +144,93 @@ exports.PAGE_TOOL_DEFS = [
|
|
|
144
144
|
]
|
|
145
145
|
}
|
|
146
146
|
},
|
|
147
|
+
{
|
|
148
|
+
"name": "sell_product_on_page",
|
|
149
|
+
"title": "Sell a Product on a Page",
|
|
150
|
+
"annotations": {
|
|
151
|
+
"readOnlyHint": false,
|
|
152
|
+
"destructiveHint": false,
|
|
153
|
+
"idempotentHint": true,
|
|
154
|
+
"openWorldHint": false
|
|
155
|
+
},
|
|
156
|
+
"description": "Makes a page SELL one product, end to end β the one call to use whenever someone wants to sell a course, ebook, download or product from a page (never a hand-made payment link). Every purchase is recorded as an order in Commerce. It does whatever is still missing: (1) no product yet β creates it from name + price (a digital product; pass deliveryUrl β where buyers get the course/files after paying β if you know it, otherwise buyers are told the owner will email access and the reply warns the owner to add the link); (2) Commerce off or no way to be paid β turns it on with Plexo's own Paystack, which needs no keys; (3) the page already has a hosted pay link (Flutterwave, Paystack, Selar, a Stripe payment link, Gumroadβ¦) β switches that link to open Plexo's checkout on the same page, so the page keeps its design and only the payment changes; (4) otherwise β adds a buy card. A buy card opens a checkout over the page and brings the buyer back to it, so it needs no checkout page and works on the Free plan's home page for digital products. Works on whatever the page is made of: a visual page (published for you when nothing else is waiting in its working copy), a classic page, a hand-written HTML page, and for a React app it returns what to place and which link to change (use the app tools to make that edit, then publish the app). Any button anywhere can also open the checkout with href=\"#plexo-buy-<productId>\" (the reply's buyLink) or data-plexo-buy=\"<productId>\". Safe to repeat. If the page has several different payment links it leaves them alone and lists them in unclearLinks β ask which one is this product's and pass part of its URL as paymentLink. Pass the reply's warnings on to the owner in plain words.",
|
|
157
|
+
"inputSchema": {
|
|
158
|
+
"type": "object",
|
|
159
|
+
"properties": {
|
|
160
|
+
"siteId": {
|
|
161
|
+
"type": "string",
|
|
162
|
+
"description": "The site's home page id (list_landing_pages shows it)."
|
|
163
|
+
},
|
|
164
|
+
"productId": {
|
|
165
|
+
"type": "string",
|
|
166
|
+
"description": "An existing product to sell (list_commerce_products). Services are booked, not bought β they can't be used here. Leave out to create one with name + price."
|
|
167
|
+
},
|
|
168
|
+
"name": {
|
|
169
|
+
"type": "string",
|
|
170
|
+
"description": "Creates the product: its name, e.g. \"AI Video Creation Course\"."
|
|
171
|
+
},
|
|
172
|
+
"price": {
|
|
173
|
+
"type": "number",
|
|
174
|
+
"description": "Creates the product: price in whole currency units, e.g. 5000 for β¦5,000 (the site's currency)."
|
|
175
|
+
},
|
|
176
|
+
"description": {
|
|
177
|
+
"type": "string",
|
|
178
|
+
"description": "Creates the product: a short description shown on the buy card."
|
|
179
|
+
},
|
|
180
|
+
"imageUrl": {
|
|
181
|
+
"type": "string",
|
|
182
|
+
"description": "Creates the product: a picture for the buy card."
|
|
183
|
+
},
|
|
184
|
+
"deliveryUrl": {
|
|
185
|
+
"type": "string",
|
|
186
|
+
"description": "Creates the product: the link buyers are sent after paying (the course, a drive folder, a members' area)."
|
|
187
|
+
},
|
|
188
|
+
"deliveryInstructions": {
|
|
189
|
+
"type": "string",
|
|
190
|
+
"description": "Creates the product: instructions emailed to buyers instead of a link."
|
|
191
|
+
},
|
|
192
|
+
"fileUrl": {
|
|
193
|
+
"type": "string",
|
|
194
|
+
"description": "Creates the product: a file already uploaded to Plexo that buyers can download."
|
|
195
|
+
},
|
|
196
|
+
"pageId": {
|
|
197
|
+
"type": "string",
|
|
198
|
+
"description": "Optional: put it on this page of the site instead of the home page."
|
|
199
|
+
},
|
|
200
|
+
"convertLinks": {
|
|
201
|
+
"type": "boolean",
|
|
202
|
+
"description": "Switch the page's existing hosted payment links to the new checkout. Default true."
|
|
203
|
+
},
|
|
204
|
+
"paymentLink": {
|
|
205
|
+
"type": "string",
|
|
206
|
+
"description": "When the page has several different payment links: part of the URL of the one that is this product's (e.g. \"aivideocreationcourse\")."
|
|
207
|
+
},
|
|
208
|
+
"addCard": {
|
|
209
|
+
"type": "boolean",
|
|
210
|
+
"description": "Also add a buy card. Default: only when the page had no payment link to switch."
|
|
211
|
+
},
|
|
212
|
+
"heading": {
|
|
213
|
+
"type": "string",
|
|
214
|
+
"description": "Visual pages: the heading above the buy card. Default: the product's name."
|
|
215
|
+
},
|
|
216
|
+
"text": {
|
|
217
|
+
"type": "string",
|
|
218
|
+
"description": "Visual pages: one line of text under the heading."
|
|
219
|
+
},
|
|
220
|
+
"buttonLabel": {
|
|
221
|
+
"type": "string",
|
|
222
|
+
"description": "Text on the buy card's button. Default \"Buy now\"."
|
|
223
|
+
},
|
|
224
|
+
"publish": {
|
|
225
|
+
"type": "boolean",
|
|
226
|
+
"description": "Visual pages: publish too. Default true β skipped automatically if the page has other unpublished edits."
|
|
227
|
+
}
|
|
228
|
+
},
|
|
229
|
+
"required": [
|
|
230
|
+
"siteId"
|
|
231
|
+
]
|
|
232
|
+
}
|
|
233
|
+
},
|
|
147
234
|
{
|
|
148
235
|
"name": "blog_layout_describe",
|
|
149
236
|
"description": "Shows a blog's custom post page or listing (index) page layout built with the visual editor: its sections, the brand and the catalog (the blogArticle section is the post body, blogList the list of posts). If the blog has no custom layout yet it says so and what blog_layout_edit will start from. Use before blog_layout_edit.",
|
package/package.json
CHANGED
package/src/pageToolDefs.ts
CHANGED
|
@@ -141,6 +141,93 @@ export const PAGE_TOOL_DEFS = [
|
|
|
141
141
|
]
|
|
142
142
|
}
|
|
143
143
|
},
|
|
144
|
+
{
|
|
145
|
+
"name": "sell_product_on_page",
|
|
146
|
+
"title": "Sell a Product on a Page",
|
|
147
|
+
"annotations": {
|
|
148
|
+
"readOnlyHint": false,
|
|
149
|
+
"destructiveHint": false,
|
|
150
|
+
"idempotentHint": true,
|
|
151
|
+
"openWorldHint": false
|
|
152
|
+
},
|
|
153
|
+
"description": "Makes a page SELL one product, end to end β the one call to use whenever someone wants to sell a course, ebook, download or product from a page (never a hand-made payment link). Every purchase is recorded as an order in Commerce. It does whatever is still missing: (1) no product yet β creates it from name + price (a digital product; pass deliveryUrl β where buyers get the course/files after paying β if you know it, otherwise buyers are told the owner will email access and the reply warns the owner to add the link); (2) Commerce off or no way to be paid β turns it on with Plexo's own Paystack, which needs no keys; (3) the page already has a hosted pay link (Flutterwave, Paystack, Selar, a Stripe payment link, Gumroadβ¦) β switches that link to open Plexo's checkout on the same page, so the page keeps its design and only the payment changes; (4) otherwise β adds a buy card. A buy card opens a checkout over the page and brings the buyer back to it, so it needs no checkout page and works on the Free plan's home page for digital products. Works on whatever the page is made of: a visual page (published for you when nothing else is waiting in its working copy), a classic page, a hand-written HTML page, and for a React app it returns what to place and which link to change (use the app tools to make that edit, then publish the app). Any button anywhere can also open the checkout with href=\"#plexo-buy-<productId>\" (the reply's buyLink) or data-plexo-buy=\"<productId>\". Safe to repeat. If the page has several different payment links it leaves them alone and lists them in unclearLinks β ask which one is this product's and pass part of its URL as paymentLink. Pass the reply's warnings on to the owner in plain words.",
|
|
154
|
+
"inputSchema": {
|
|
155
|
+
"type": "object",
|
|
156
|
+
"properties": {
|
|
157
|
+
"siteId": {
|
|
158
|
+
"type": "string",
|
|
159
|
+
"description": "The site's home page id (list_landing_pages shows it)."
|
|
160
|
+
},
|
|
161
|
+
"productId": {
|
|
162
|
+
"type": "string",
|
|
163
|
+
"description": "An existing product to sell (list_commerce_products). Services are booked, not bought β they can't be used here. Leave out to create one with name + price."
|
|
164
|
+
},
|
|
165
|
+
"name": {
|
|
166
|
+
"type": "string",
|
|
167
|
+
"description": "Creates the product: its name, e.g. \"AI Video Creation Course\"."
|
|
168
|
+
},
|
|
169
|
+
"price": {
|
|
170
|
+
"type": "number",
|
|
171
|
+
"description": "Creates the product: price in whole currency units, e.g. 5000 for β¦5,000 (the site's currency)."
|
|
172
|
+
},
|
|
173
|
+
"description": {
|
|
174
|
+
"type": "string",
|
|
175
|
+
"description": "Creates the product: a short description shown on the buy card."
|
|
176
|
+
},
|
|
177
|
+
"imageUrl": {
|
|
178
|
+
"type": "string",
|
|
179
|
+
"description": "Creates the product: a picture for the buy card."
|
|
180
|
+
},
|
|
181
|
+
"deliveryUrl": {
|
|
182
|
+
"type": "string",
|
|
183
|
+
"description": "Creates the product: the link buyers are sent after paying (the course, a drive folder, a members' area)."
|
|
184
|
+
},
|
|
185
|
+
"deliveryInstructions": {
|
|
186
|
+
"type": "string",
|
|
187
|
+
"description": "Creates the product: instructions emailed to buyers instead of a link."
|
|
188
|
+
},
|
|
189
|
+
"fileUrl": {
|
|
190
|
+
"type": "string",
|
|
191
|
+
"description": "Creates the product: a file already uploaded to Plexo that buyers can download."
|
|
192
|
+
},
|
|
193
|
+
"pageId": {
|
|
194
|
+
"type": "string",
|
|
195
|
+
"description": "Optional: put it on this page of the site instead of the home page."
|
|
196
|
+
},
|
|
197
|
+
"convertLinks": {
|
|
198
|
+
"type": "boolean",
|
|
199
|
+
"description": "Switch the page's existing hosted payment links to the new checkout. Default true."
|
|
200
|
+
},
|
|
201
|
+
"paymentLink": {
|
|
202
|
+
"type": "string",
|
|
203
|
+
"description": "When the page has several different payment links: part of the URL of the one that is this product's (e.g. \"aivideocreationcourse\")."
|
|
204
|
+
},
|
|
205
|
+
"addCard": {
|
|
206
|
+
"type": "boolean",
|
|
207
|
+
"description": "Also add a buy card. Default: only when the page had no payment link to switch."
|
|
208
|
+
},
|
|
209
|
+
"heading": {
|
|
210
|
+
"type": "string",
|
|
211
|
+
"description": "Visual pages: the heading above the buy card. Default: the product's name."
|
|
212
|
+
},
|
|
213
|
+
"text": {
|
|
214
|
+
"type": "string",
|
|
215
|
+
"description": "Visual pages: one line of text under the heading."
|
|
216
|
+
},
|
|
217
|
+
"buttonLabel": {
|
|
218
|
+
"type": "string",
|
|
219
|
+
"description": "Text on the buy card's button. Default \"Buy now\"."
|
|
220
|
+
},
|
|
221
|
+
"publish": {
|
|
222
|
+
"type": "boolean",
|
|
223
|
+
"description": "Visual pages: publish too. Default true β skipped automatically if the page has other unpublished edits."
|
|
224
|
+
}
|
|
225
|
+
},
|
|
226
|
+
"required": [
|
|
227
|
+
"siteId"
|
|
228
|
+
]
|
|
229
|
+
}
|
|
230
|
+
},
|
|
144
231
|
{
|
|
145
232
|
"name": "blog_layout_describe",
|
|
146
233
|
"description": "Shows a blog's custom post page or listing (index) page layout built with the visual editor: its sections, the brand and the catalog (the blogArticle section is the post body, blogList the list of posts). If the blog has no custom layout yet it says so and what blog_layout_edit will start from. Use before blog_layout_edit.",
|