Summary
GoodBarber is a no-code app builder, and this server turns your published eCommerce, Community, or Membership app into something Claude can manage through conversation. It uses OAuth against GoodBarber's Public API and exposes tools for catalog management, order processing, customer segmentation, promo campaigns, subscription audits, and push notifications. The real value is in the 41 included skills, markdown files that chain these tools into workflows like RFM segmentation, reorder planning based on sales velocity, or identifying orphaned products not in any collection. If you run a GoodBarber storefront or membership site and want to pull reports, spot inventory gaps, or broadcast a promo without opening the backoffice, this gives you a natural language interface over the whole operation.
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Tools
Public tool metadata for what this MCP can expose to an agent.
80 tools
meta_get_tool_planRetrieve full guidance for one tool name, including the recommended discover/call/verify sequence and failure policy.1 params
Retrieve full guidance for one tool name, including the recommended discover/call/verify sequence and failure policy.
Parameters* required
tool_namestringshop_list_collectionsList shop collections (paginated). Returns count/previous/next/collections.4 params
List shop collections (paginated). Returns count/previous/next/collections.
Parameters* required
keywordstringFilter by collection name, supports comma-separated OR terms.
pageintegerPage number (default 1)
per_pageintegerItems per page
sortstringone of
alpha · alpha_desc · first_added · last_addedshop_get_collectionRetrieve one collection by id. Returns collection object.1 params
Retrieve one collection by id. Returns collection object.
Parameters* required
collection_idintegerCollection identifier
shop_list_optionsList variant options (paginated). Returns count/previous/next/options.3 params
List variant options (paginated). Returns count/previous/next/options.
Parameters* required
pageintegerper_pageintegersearchstringFilter by option name substring
shop_create_optionCreate a new variant option for product variants.1 params
Create a new variant option for product variants.
Parameters* required
namestringOption name (e.g. 'Color', 'Size')
shop_update_optionUpdate the name of a variant option.2 params
Update the name of a variant option.
Parameters* required
namestringoption_idintegershop_delete_optionDelete a specific variant option.1 params
Delete a specific variant option.
Parameters* required
option_idintegershop_list_productsList products (paginated). Returns count/previous/next/products.5 params
List products (paginated). Returns count/previous/next/products.
Parameters* required
collectionarrayList of collection ids. Use [id] for a single collection, [id1, id2, ...] for OR filtering across multiple collections. Always pass an array, even for one collection. Do NOT make multiple calls to...
keywordstringpageintegerper_pageintegerstatusstringone of
DEMO · DRAFT · INVISIBLE · PUBLISHEDshop_create_productCreate a product. Returns created product object.16 params
Create a product. Returns created product object.
Parameters* required
brandstringcollectionsarrayhighlightbooleanmediaintegerSlide id used as product thumbnail
meta_descriptionstringmeta_titlestringproduct_refstringset_custom_similar_productsarrayshow_similar_productsbooleanslugstringstatusstringone of
DRAFT · PUBLISHED · INVISIBLEsummarystringtagsarraytitlestringvisibility_endstringISO datetime
visibility_startstringISO datetime
shop_get_productRetrieve one product by id. Returns product object with variants/slides.1 params
Retrieve one product by id. Returns product object with variants/slides.
Parameters* required
product_idintegershop_update_productUpdate a product in the shop.17 params
Update a product in the shop.
Parameters* required
brandstringcollectionsarrayhighlightbooleanmediaintegermeta_descriptionstringmeta_titlestringproduct_idintegerproduct_refstringset_custom_similar_productsarrayshow_similar_productsbooleanslugstringstatusstringone of
DRAFT · PUBLISHED · INVISIBLEsummarystringtagsarraytitlestringvisibility_endstringISO datetime
visibility_startstringISO datetime
shop_delete_productDelete a specific product from the shop.1 params
Delete a specific product from the shop.
Parameters* required
product_idintegershop_list_paragraphsList product description paragraphs sorted by position.1 params
List product description paragraphs sorted by position.
Parameters* required
product_idintegershop_create_paragraphAdd a description paragraph to a product.5 params
Add a description paragraph to a product.
Parameters* required
contentstringhtmlbooleanparagraph_typestringone of
TEXT · QUOTE · PHOTO · EMBEDpositionintegerOrder index
product_idintegershop_update_paragraphUpdate a product description paragraph.7 params
Update a product description paragraph.
Parameters* required
contentstringhtmlbooleanmedia_idintegerparagraph_idstringparagraph_typestringone of
TEXT · QUOTE · PHOTO · EMBEDpositionintegerproduct_idintegershop_delete_paragraphDelete a specific product description paragraph.2 params
Delete a specific product description paragraph.
Parameters* required
paragraph_idstringproduct_idintegershop_create_paragraph_mediaCreate a media object for a paragraph. For PHOTO: pass media_type=PHOTO and image_file. For EMBED: pass media_type=EMBED and content.6 params
Create a media object for a paragraph. For PHOTO: pass media_type=PHOTO and image_file. For EMBED: pass media_type=EMBED and content.
Parameters* required
contentstringRequired for EMBED. Embed content.
focal_pointstringImage crop focal point, format 40x50.
image_filestringRequired for PHOTO. Image payload. Accepts: (1) a data URI 'data:image/png;base64,...', (2) a raw base64-encoded string of the image bytes, or (3) a public http(s) URL. Do NOT pass a local filesyst...
media_typestringRequired. PHOTO or EMBED.one of
PHOTO · EMBEDparagraph_idstringproduct_idintegershop_get_paragraph_mediaRetrieve the details of a paragraph media object.3 params
Retrieve the details of a paragraph media object.
Parameters* required
media_idintegerparagraph_idstringproduct_idintegershop_update_paragraph_mediaUpdate a paragraph media object (content, type, focal point, and/or image_file).7 params
Update a paragraph media object (content, type, focal point, and/or image_file).
Parameters* required
contentstringfocal_pointstringimage_filestringImage payload. Accepts: (1) a data URI 'data:image/png;base64,...', (2) a raw base64-encoded string of the image bytes, or (3) a public http(s) URL. Do NOT pass a local filesystem path — the server...
media_idintegermedia_typestringone of
PHOTO · EMBEDparagraph_idstringproduct_idintegershop_delete_paragraph_mediaDelete a paragraph media object.3 params
Delete a paragraph media object.
Parameters* required
media_idintegerparagraph_idstringproduct_idintegershop_upload_product_pdfDownload a PDF from a URL and attach it to a product (multipart upload).3 params
Download a PDF from a URL and attach it to a product (multipart upload).
Parameters* required
pdfstringPublic URL of the PDF to download and upload
pdf_namestringDisplay name (default: filename from URL)
product_idintegershop_delete_product_pdfDelete the PDF file associated with a product.1 params
Delete the PDF file associated with a product.
Parameters* required
product_idintegershop_upload_product_slideUpload an image file as a product slide (multipart form-data).4 params
Upload an image file as a product slide (multipart form-data).
Parameters* required
focal_pointstringimage_filestringImage payload. Accepts: (1) a data URI 'data:image/png;base64,...', (2) a raw base64-encoded string of the image bytes, or (3) a public http(s) URL. Do NOT pass a local filesystem path — the server...
positionintegerproduct_idintegershop_update_product_slideUpdate a slide (position, focal_point and/or replacement image via image_file).5 params
Update a slide (position, focal_point and/or replacement image via image_file).
Parameters* required
focal_pointstringimage_filestringImage payload. Accepts: (1) a data URI 'data:image/png;base64,...', (2) a raw base64-encoded string of the image bytes, or (3) a public http(s) URL. Do NOT pass a local filesystem path — the server...
positionintegerproduct_idintegerslide_idintegershop_delete_product_slideDelete a specific product slide.2 params
Delete a specific product slide.
Parameters* required
product_idintegerslide_idintegershop_create_variantCreate a new variant for a product. IMPORTANT: all variants of the same product MUST share the exact same set of option_ids. When you introduce a new option on one variant, you must also add that option (with an appropriate value) to every other existing variant via shop_updat...9 params
Create a new variant for a product. IMPORTANT: all variants of the same product MUST share the exact same set of option_ids. When you introduce a new option on one variant, you must also add that option (with an appropriate value) to every other existing variant via shop_updat...
Parameters* required
compare_atstringmediaintegeroption_valuesarrayList of option/value pairs. Each object has one key: the option_id mapping to the value string. Example: [{"1": "Red"}, {"2": "M"}]
positionintegerpricestringDecimal as string, e.g. '10.50000'
product_idintegerskustringstockintegerweightstringshop_get_variantRetrieve the details of a product variant.2 params
Retrieve the details of a product variant.
Parameters* required
product_idintegervariant_idintegershop_update_variantUpdate the details of a product variant.10 params
Update the details of a product variant.
Parameters* required
compare_atstringmediaintegeroption_valuesarrayList of option/value pairs. Each object has one key: the option_id mapping to the value string. Example: [{"1": "Red"}, {"2": "M"}]
positionintegerpricestringproduct_idintegerskustringstockintegervariant_idintegerweightstringshop_delete_variantDelete a specific product variant.2 params
Delete a specific product variant.
Parameters* required
product_idintegervariant_idintegershop_list_tagsList all tags used in the shop catalog.3 params
List all tags used in the shop catalog.
Parameters* required
pageintegerper_pageintegersortstringone of
alpha · last_created · most_taggedshop_validate_jwtValidate a front-end JWT for a shop customer.2 params
Validate a front-end JWT for a shop customer.
Parameters* required
jwtstringThe JWT to validate
user_idstringTarget user id for token validation
shop_list_customersList customers of the shop.2 params
List customers of the shop.
Parameters* required
pageintegerper_pageintegershop_get_customerRetrieve the details of a specific shop customer.1 params
Retrieve the details of a specific shop customer.
Parameters* required
customer_idintegershop_list_prospectsList prospects (newsletter subscribers) of the shop.2 params
List prospects (newsletter subscribers) of the shop.
Parameters* required
pageintegerper_pageintegershop_get_prospectRetrieve the details of a specific shop prospect.1 params
Retrieve the details of a specific shop prospect.
Parameters* required
user_idstringUnique ID of the user
shop_create_push_broadcastSend a push notification broadcast to all shop app users.3 params
Send a push notification broadcast to all shop app users.
Parameters* required
actionobjectAction performed when the user opens the notification.
messagestringContent of the push notification (max 255 characters).
scheduleobjectSending time. Defaults to immediate send.
shop_create_push_notificationSend a shop push notification with optional user targeting, scheduling, and tap action.4 params
Send a shop push notification with optional user targeting, scheduling, and tap action.
Parameters* required
actionobjectAction performed when the user opens the notification.
messagestringContent of the push notification (max 255 characters).
scheduleobjectSending time. Defaults to immediate send.
targetingobjectOptional user targeting. If omitted, sends to all eligible push recipients.
shop_list_ordersList orders of the shop. Supports filtering by status and date range.7 params
List orders of the shop. Supports filtering by status and date range.
Parameters* required
creation_date_fromstringFilter orders created after this datetime (yyyy-mm-ddThh:MM, UTC)
creation_date_tostringFilter orders created before this datetime (yyyy-mm-ddThh:MM, UTC)
delivery_date_fromstringFilter by delivery slot start after this datetime
delivery_date_tostringFilter by delivery slot end before this datetime
pageintegerper_pageintegerstatusvalueOne status or a list of statuses to OR-filter.
shop_get_orderRetrieve the details of a specific order.1 params
Retrieve the details of a specific order.
Parameters* required
order_idintegerUnique ID of the order
shop_get_order_shippingGet the shipping information (status, tracking number, tracking URL) of an order.1 params
Get the shipping information (status, tracking number, tracking URL) of an order.
Parameters* required
order_idintegershop_update_order_shippingUpdate the shipping information of an order. Status can only go PENDING → FULFILLED → DELIVERED.4 params
Update the shipping information of an order. Status can only go PENDING → FULFILLED → DELIVERED.
Parameters* required
order_idintegershipping_tracking_numstringshipping_tracking_urlstringstatusstringNew order statusone of
FULFILLED · DELIVEREDshop_get_loyaltyRetrieve the loyalty points details of a shop user.1 params
Retrieve the loyalty points details of a shop user.
Parameters* required
user_idintegershop_update_loyaltyUpdate the loyalty points of a shop user.2 params
Update the loyalty points of a shop user.
Parameters* required
points_countintegerNew points total
user_idintegershop_get_promocodeRetrieve the details of a specific promocode.1 params
Retrieve the details of a specific promocode.
Parameters* required
promocode_idintegershop_list_promocodes_amountList promocodes based on order amount.2 params
List promocodes based on order amount.
Parameters* required
pageintegerper_pageintegershop_create_promocode_amountCreate a promocode based on order amount.16 params
Create a promocode based on order amount.
Parameters* required
codestringconditionsstringone of
NONE · PRICE_RANGE · NUMBER_OF_PRODUCTSdiscount_typestringone of
PERCENT · ABSOLUTEend_atstringISO datetime. Use end_date='none' for no expiration.
end_datestringAlias for end_at. Set to 'none' for no expiration.
max_pricenumbermax_usesintegermin_pricenumbermin_quantityintegernamestringone_use_by_userbooleanregistered_onlybooleanspecific_registered_idsarrayList of specific user IDs
specific_registered_onlybooleanstart_atstringISO datetime
valuenumbershop_list_promocodes_collectionsList promocodes based on dedicated collections.2 params
List promocodes based on dedicated collections.
Parameters* required
pageintegerper_pageintegershop_create_promocode_collectionsCreate a promocode based on dedicated collections.17 params
Create a promocode based on dedicated collections.
Parameters* required
codestringcollection_idsarrayList of collection IDs this promocode applies to
conditionsstringone of
NONE · PRICE_RANGE · NUMBER_OF_PRODUCTSdiscount_typestringone of
PERCENT · ABSOLUTEend_atstringISO datetime. Use end_date='none' for no expiration.
end_datestringAlias for end_at. Set to 'none' for no expiration.
max_pricenumbermax_usesintegermin_pricenumbermin_quantityintegernamestringone_use_by_userbooleanregistered_onlybooleanspecific_registered_idsarrayspecific_registered_onlybooleanstart_atstringvaluenumbershop_list_promocodes_productList promocodes based on a dedicated product.2 params
List promocodes based on a dedicated product.
Parameters* required
pageintegerper_pageintegershop_create_promocode_productCreate a promocode based on a dedicated product.17 params
Create a promocode based on a dedicated product.
Parameters* required
codestringconditionsstringone of
NONE · PRICE_RANGE · NUMBER_OF_PRODUCTSdiscount_typestringone of
PERCENT · ABSOLUTEend_atstringISO datetime. Use end_date='none' for no expiration.
end_datestringAlias for end_at. Set to 'none' for no expiration.
max_pricenumbermax_usesintegermin_pricenumbermin_quantityintegernamestringone_use_by_userbooleanproduct_idintegerProduct this promocode applies to
registered_onlybooleanspecific_registered_idsarrayspecific_registered_onlybooleanstart_atstringvaluenumbershop_list_promocodes_tagsList promocodes based on dedicated tags.2 params
List promocodes based on dedicated tags.
Parameters* required
pageintegerper_pageintegershop_create_promocode_tagsCreate a promocode based on dedicated tags.17 params
Create a promocode based on dedicated tags.
Parameters* required
codestringconditionsstringone of
NONE · PRICE_RANGE · NUMBER_OF_PRODUCTSdiscount_typestringone of
PERCENT · ABSOLUTEend_atstringISO datetime. Use end_date='none' for no expiration.
end_datestringAlias for end_at. Set to 'none' for no expiration.
max_pricenumbermax_usesintegermin_pricenumbermin_quantityintegernamestringone_use_by_userbooleanregistered_onlybooleanspecific_registered_idsarrayspecific_registered_onlybooleanstart_atstringtagsarrayList of tags this promocode applies to
valuenumbershop_list_downloadsList app download statistics for the shop.3 params
List app download statistics for the shop.
Parameters* required
end_datestringEnd date (YYYY-MM-DD)
platformstringone of
all · android · ipad · iphonestart_datestringStart date (YYYY-MM-DD)
shop_list_downloads_globalList global (all-time) app download statistics for the shop.1 params
List global (all-time) app download statistics for the shop.
Parameters* required
platformstringone of
all · android · ipad · iphoneshop_list_launchesList app launch statistics for the shop.3 params
List app launch statistics for the shop.
Parameters* required
end_datestringYYYY-MM-DD
platformstringone of
all · android · html5 · ipad · iphonestart_datestringYYYY-MM-DD
shop_list_unique_launchesList unique app launch statistics for the shop.3 params
List unique app launch statistics for the shop.
Parameters* required
end_datestringYYYY-MM-DD
platformstringone of
all · android · html5 · ipad · iphonestart_datestringYYYY-MM-DD
shop_list_page_viewsList page view statistics for the shop.3 params
List page view statistics for the shop.
Parameters* required
end_datestringYYYY-MM-DD
platformstringone of
all · android · html5 · ipad · iphonestart_datestringYYYY-MM-DD
shop_list_page_views_per_weekdayList page views broken down by day of the week for the shop.2 params
List page views broken down by day of the week for the shop.
Parameters* required
end_datestringYYYY-MM-DD
start_datestringYYYY-MM-DD
shop_list_session_timesList session time statistics for the shop.2 params
List session time statistics for the shop.
Parameters* required
end_datestringYYYY-MM-DD
start_datestringYYYY-MM-DD
cms_list_sectionsList app sections for the current app by section type. This generic section catalog can return CMS content sections, content sections powered by other providers, and non-content sections. Use type='commerce' for eCommerce sections because commerce sections are not MCMS section...1 params
List app sections for the current app by section type. This generic section catalog can return CMS content sections, content sections powered by other providers, and non-content sections. Use type='commerce' for eCommerce sections because commerce sections are not MCMS section...
Parameters* required
typestringSection type to discover. The generic section catalog can return any matching app section, including content and non-content sections. Use 'commerce' for eCommerce sections.
cms_list_cms_sectionsList CMS content sections for the current app by CMS content type. Use this to discover CMS-created article, maps, video, photo, agenda, or sound sections before listing CMS content that requires category ids. The response includes each section's id and title and its categorie...1 params
List CMS content sections for the current app by CMS content type. Use this to discover CMS-created article, maps, video, photo, agenda, or sound sections before listing CMS content that requires category ids. The response includes each section's id and title and its categorie...
Parameters* required
typestringCMS content type to discover.one of
article · maps · video · photo · agenda · soundcms_list_articlesList CMS articles for the current app. Optionally filter by one or more category ids (use cms_list_cms_sections first to discover them); omit category to list across every article category. Also filter by publication status, article title search terms, article ids, pagination,...8 params
List CMS articles for the current app. Optionally filter by one or more category ids (use cms_list_cms_sections first to discover them); omit category to list across every article category. Also filter by publication status, article title search terms, article ids, pagination,...
Parameters* required
categoryarrayOptional article category ids returned by cms_list_cms_sections. Omit to list across all categories.
idarrayOptional article ids to filter the list.
orderstringSort order for the article list.one of
ASC · DESCpageintegerPage index.
per_pageintegerNumber of articles per page.
searcharrayOptional title search terms.
sortstringSort field for the article list.one of
recent · alphastatusstringOptional publication status filter. Omit to list every non-deleted item in scope.one of
draft · published · stock · scheduledcms_get_articleRetrieve one CMS article for the current app by article id. Use cms_list_articles first when the article id is unknown. The response fields accessTier and maxFreeParagraphs apply only to in-app-purchase items: maxFreeParagraphs is the number of body paragraphs shown as a free...1 params
Retrieve one CMS article for the current app by article id. Use cms_list_articles first when the article id is unknown. The response fields accessTier and maxFreeParagraphs apply only to in-app-purchase items: maxFreeParagraphs is the number of body paragraphs shown as a free...
Parameters* required
idintegerArticle id returned by cms_list_articles.
cms_create_articleCreate one CMS article for the current app. Use cms_list_cms_sections first to discover article category ids.15 params
Create one CMS article for the current app. Use cms_list_cms_sections first to discover article category ids.
Parameters* required
accessTierstringPaywall tier. 'premium' locks the article behind an in-app purchase; 'free' leaves it open. Applies only to apps that sell in-app purchases.one of
free · premiumauthorstringOptional byline or author display name. If omitted, the app account holder's name is used.
categoriesarrayArticle category ids returned by cms_list_cms_sections.
commentsEnabledbooleanWhether end-user comments are enabled for this article.
datestringOptional editorial date in RFC 3339 format.
displaySummaryInListbooleanWhether the article summary is shown in list views. Writable only when maxFreeParagraphs is 0.
leadinstringOptional article deck HTML.
maxFreeParagraphsintegerNumber of body paragraphs shown as a free preview before purchase, 0 to 5. Applies only to premium in-app-purchase articles.
metaobjectOptional SEO metadata.
pinnedbooleanWhether the article is pinned in its category listing.
publicationEndDatestringOptional future unpublication date in RFC 3339 format.
publishedDatestringOptional future publication date. Requires status='stock' when provided.
slugstringOptional URL slug; the server may normalize it.
statusstringPublication status. Omit to default to published.one of
published · draft · stocktitlestringArticle headline shown in feeds and on the item page.
cms_update_articleUpdate one CMS article for the current app by article id. Provide at least one field to change.16 params
Update one CMS article for the current app by article id. Provide at least one field to change.
Parameters* required
accessTierstringReplacement paywall tier. 'premium' locks the article behind an in-app purchase; 'free' leaves it open. Applies only to apps that sell in-app purchases.one of
free · premiumauthorstringReplacement byline or author display name.
categoriesarrayReplacement article category ids returned by cms_list_cms_sections.
commentsEnabledbooleanWhether end-user comments are enabled for this article.
datestringReplacement editorial date in RFC 3339 format.
displaySummaryInListbooleanWhether the article summary is shown in list views. Writable only when maxFreeParagraphs is 0.
idintegerArticle id returned by cms_list_articles.
leadinstringReplacement article deck HTML.
maxFreeParagraphsintegerNumber of body paragraphs shown as a free preview before purchase, 0 to 5. Applies only to premium in-app-purchase articles.
metaobjectReplacement SEO metadata.
pinnedbooleanWhether the article is pinned in its category listing.
publicationEndDatestringOptional future unpublication date. Send an empty string to clear an existing scheduled unpublication.
publishedDatestringOptional future publication date. Requires status='stock' when provided.
slugstringReplacement URL slug; the server may normalize it.
statusstringReplacement publication status.one of
published · draft · stocktitlestringReplacement article headline shown in feeds and on the item page.
cms_delete_articleDelete one CMS article for the current app by article id. Use cms_get_article or cms_list_articles first to confirm the target.1 params
Delete one CMS article for the current app by article id. Use cms_get_article or cms_list_articles first to confirm the target.
Parameters* required
idintegerArticle id returned by cms_list_articles.
cms_list_article_paragraphsList body paragraphs for one CMS article, sorted by paragraph position.1 params
List body paragraphs for one CMS article, sorted by paragraph position.
Parameters* required
idintegerArticle id returned by cms_list_articles.
cms_create_article_paragraphCreate one body paragraph under a CMS article. Paragraph type must be text, photo, quote, or embed. Required fields depend on the paragraph type.8 params
Create one body paragraph under a CMS article. Paragraph type must be text, photo, quote, or embed. Required fields depend on the paragraph type.
Parameters* required
captionstringOptional caption for photo paragraphs.
contentstringRequired for text and quote paragraphs.
embedUrlstringRequired embed HTML for embed paragraphs. Set an explicit iframe width and height (for example 100%) so the block renders at a visible size.
idintegerArticle id returned by cms_list_articles.
isThumbnailbooleanWhether a photo paragraph should be used as the article thumbnail.
originalThumbnailstringRequired image URL, data URI, or base64 source for photo paragraphs.
positionintegerOptional 1-based insert position; omit to append.
typestringParagraph body-block kind.one of
text · photo · quote · embedcms_get_article_paragraphRetrieve one body paragraph by article id and paragraph id.2 params
Retrieve one body paragraph by article id and paragraph id.
Parameters* required
idintegerArticle id returned by cms_list_articles.
paragraph_idintegerParagraph id returned by cms_list_article_paragraphs.
cms_update_article_paragraphUpdate one body paragraph under a CMS article. Provide at least one paragraph field to change.7 params
Update one body paragraph under a CMS article. Provide at least one paragraph field to change.
Parameters* required
captionstringReplacement caption for photo paragraphs.
contentstringReplacement text HTML or quote body, depending on paragraph type.
embedUrlstringReplacement embed HTML for embed paragraphs. Set an explicit iframe width and height (for example 100%) so the block renders at a visible size.
idintegerArticle id returned by cms_list_articles.
isThumbnailbooleanWhether a photo paragraph should be used as the article thumbnail.
originalThumbnailstringReplacement image URL, data URI, or base64 source for photo paragraphs.
paragraph_idintegerParagraph id returned by cms_list_article_paragraphs.
cms_delete_article_paragraphDelete one body paragraph from a CMS article by article id and paragraph id.2 params
Delete one body paragraph from a CMS article by article id and paragraph id.
Parameters* required
idintegerArticle id returned by cms_list_articles.
paragraph_idintegerParagraph id returned by cms_list_article_paragraphs.
cms_reorder_article_paragraphsReorder all body paragraphs for one CMS article. Pass a full ordered list of paragraph ids.2 params
Reorder all body paragraphs for one CMS article. Pass a full ordered list of paragraph ids.
Parameters* required
idintegerArticle id returned by cms_list_articles.
paragraph_idsarrayFull ordered list of paragraph ids for this article.
cms_list_mapsList CMS map (point of interest) items for the current app. Optionally filter by one or more category ids (use cms_list_cms_sections with type='maps' first to discover them); omit category to list across every map category. Also filter by publication status.8 params
List CMS map (point of interest) items for the current app. Optionally filter by one or more category ids (use cms_list_cms_sections with type='maps' first to discover them); omit category to list across every map category. Also filter by publication status.
Parameters* required
categoryarrayOptional map category ids returned by cms_list_cms_sections. Omit to list across all categories.
idarrayOptional map item ids to filter the list.
orderstringSort order for the map list.one of
ASC · DESCpageintegerPage index.
per_pageintegerNumber of map items per page.
searcharrayOptional title search terms.
sortstringSort field for the map list.one of
recent · alphastatusstringOptional publication status filter. Omit to list every non-deleted item in scope.one of
draft · published · stock · scheduledcms_get_mapRetrieve one CMS map item for the current app by map item id. Use cms_list_maps first when the map item id is unknown. The response fields accessTier and maxFreeParagraphs apply only to in-app-purchase items: maxFreeParagraphs is the number of body paragraphs shown as a free p...1 params
Retrieve one CMS map item for the current app by map item id. Use cms_list_maps first when the map item id is unknown. The response fields accessTier and maxFreeParagraphs apply only to in-app-purchase items: maxFreeParagraphs is the number of body paragraphs shown as a free p...
Parameters* required
idintegerMap item id returned by cms_list_maps.
cms_create_mapCreate one CMS map (point of interest) item for the current app. Use cms_list_cms_sections with type='maps' first to discover map category ids.17 params
Create one CMS map (point of interest) item for the current app. Use cms_list_cms_sections with type='maps' first to discover map category ids.
Parameters* required
accessTierstringPaywall tier. 'premium' locks the item behind an in-app purchase; 'free' leaves it open. Applies only to apps that sell in-app purchases.one of
free · premiumaddressstringStreet or place address of the point of interest.
categoriesarrayMap category ids returned by cms_list_cms_sections.
commentsEnabledbooleanWhether end-user comments are enabled for this map item.
emailstringOptional contact email for the map point.
latitudenumberLatitude of the point in decimal degrees.
leadinstringOptional map point deck HTML.
longitudenumberLongitude of the point in decimal degrees.
metaobjectOptional SEO metadata.
phoneNumberstringOptional contact phone number for the map point.
publicationEndDatestringOptional future unpublication date in RFC 3339 format.
publishedDatestringOptional future publication date. Requires status='stock' when provided.
slugstringOptional URL slug; the server may normalize it.
statusstringPublication status. Omit to default to published.one of
published · draft · stocktitlestringMap point name shown in feeds and on the item page.
useThumbAsPinIconbooleanWhether the map item thumbnail is used as the map pin icon. On create the server stores this as off; set a thumbnail via a photo paragraph first, then update this flag.
websitestringOptional website URL for the map point.
cms_update_mapUpdate one CMS map item for the current app by map item id. Provide at least one field to change.18 params
Update one CMS map item for the current app by map item id. Provide at least one field to change.
Parameters* required
accessTierstringReplacement paywall tier. 'premium' locks the item behind an in-app purchase; 'free' leaves it open. Applies only to apps that sell in-app purchases.one of
free · premiumaddressstringReplacement street or place address; cannot be cleared.
categoriesarrayReplacement map category ids returned by cms_list_cms_sections.
commentsEnabledbooleanWhether end-user comments are enabled for this map item.
emailstringReplacement contact email for the map point.
idintegerMap item id returned by cms_list_maps.
latitudenumberReplacement latitude in decimal degrees.
leadinstringReplacement map point deck HTML.
longitudenumberReplacement longitude in decimal degrees.
metaobjectReplacement SEO metadata.
phoneNumberstringReplacement contact phone number for the map point.
publicationEndDatestringOptional future unpublication date. Send an empty string to clear an existing scheduled unpublication.
publishedDatestringOptional future publication date. Requires status='stock' when provided.
slugstringReplacement URL slug; the server may normalize it.
statusstringReplacement publication status.one of
published · draft · stocktitlestringReplacement map point name.
useThumbAsPinIconbooleanWhether the map item thumbnail is used as the map pin icon.
websitestringReplacement website URL for the map point.
cms_delete_mapDelete one CMS map item for the current app by map item id. Use cms_get_map or cms_list_maps first to confirm the target.1 params
Delete one CMS map item for the current app by map item id. Use cms_get_map or cms_list_maps first to confirm the target.
Parameters* required
idintegerMap item id returned by cms_list_maps.
cms_list_map_paragraphsList body paragraphs for one CMS map item, sorted by paragraph position.1 params
List body paragraphs for one CMS map item, sorted by paragraph position.
Parameters* required
idintegerMap item id returned by cms_list_maps.
cms_create_map_paragraphCreate one body paragraph under a CMS map item. Paragraph type must be text, photo, quote, or embed. Required fields depend on the paragraph type.8 params
Create one body paragraph under a CMS map item. Paragraph type must be text, photo, quote, or embed. Required fields depend on the paragraph type.
Parameters* required
captionstringOptional caption for photo paragraphs.
contentstringRequired for text and quote paragraphs.
embedUrlstringRequired embed HTML for embed paragraphs. Set an explicit iframe width and height (for example 100%) so the block renders at a visible size.
idintegerMap item id returned by cms_list_maps.
isThumbnailbooleanWhether a photo paragraph should be used as the map item thumbnail.
originalThumbnailstringRequired image URL, data URI, or base64 source for photo paragraphs.
positionintegerOptional 1-based insert position; omit to append.
typestringParagraph body-block kind.one of
text · photo · quote · embedcms_get_map_paragraphRetrieve one body paragraph by map item id and paragraph id.2 params
Retrieve one body paragraph by map item id and paragraph id.
Parameters* required
idintegerMap item id returned by cms_list_maps.
paragraph_idintegerParagraph id returned by cms_list_map_paragraphs.
GoodBarber Skills
44 AI-powered skills to manage your GoodBarber app with any MCP-compatible client — eCommerce, Community, Membership, and CMS.
Listed on Smithery.
These skills connect to the GoodBarber MCP server and give your AI assistant structured workflows to manage your products, orders, customers, promotions, subscriptions, content, analytics, and more — all from a conversational interface.
What are Skills?
Skills are instruction files (.md) that teach an AI assistant how to perform specific tasks using your GoodBarber app's API via MCP (Model Context Protocol). Instead of manually calling API tools one by one, a skill orchestrates the full workflow — from data retrieval to formatted report — in a single natural-language request.
For example, asking "Show me my best sellers this month" triggers the shop-best-sellers skill, which automatically fetches your orders and catalog, computes rankings, and returns a formatted report.
Quick Start
Option A — Install as a Claude Code plugin
The repo is a Claude Code plugin: it ships the GoodBarber MCP server (.mcp.json) and the 44 skills in one package.
git clone https://github.com/goodbarber/goodbarber-skills.git
claude --plugin-dir ./goodbarber-skills
Once the plugin is listed in the community marketplace, install it from any session instead:
/plugin marketplace add anthropics/claude-plugins-community
/plugin install goodbarber@claude-community
On the first GoodBarber tool call, Claude Code opens the authorization page: paste your Public API key and validate. Details in SETUP.md.
Option B — Manual setup (any MCP client)
1. Connect the GoodBarber MCP
You need to add the GoodBarber MCP server as a custom connector in your client. The server implements the MCP 2026-07-28 protocol over Streamable HTTP (earlier handshake-era clients still connect). The /mcp/sse path name is historical and kept only for backward compatibility.
MCP Server URLs:
| Setup | URL |
|---|---|
| Single app | https://mcp.goodbarber.dev/mcp/sse |
| Multiple apps | https://mcp.goodbarber.dev/<app_id>/mcp/sse |
Replace <app_id> with your GoodBarber app ID if you manage multiple apps.
Authentication: the GoodBarber MCP server uses a browser-based OAuth flow.
When your MCP client connects to the MCP endpoint, it may open an authorization page on
mcp.goodbarber.dev. On that page, you will be asked to paste your GoodBarber Public API key and validate the authorization. Generate your Public API key from your app's GoodBarber backoffice, on the Public API / MCP server page.Important:
- Do not open the
/authorizeURL manually in your browser.- Start from the MCP client by connecting to the MCP endpoint.
- The client generates the full authorization request parameters automatically (
redirect_uri,client_id,state,code_challenge, etc.).If you open the authorization page manually without those parameters, the authentication will fail.
Claude Desktop (Cowork):
- Open Settings > Connectors
- Click Add custom connector
- Enter the MCP server URL above
- The connector opens the GoodBarber authorization page — paste your Public API key there and validate
Claude Code (CLI):
# Single app
claude mcp add goodbarber --transport http https://mcp.goodbarber.dev/mcp/sse
# Multiple apps
claude mcp add goodbarber --transport http https://mcp.goodbarber.dev/<app_id>/mcp/sse
Then start a Claude Code session — on the first GoodBarber tool call, the CLI will open the GoodBarber authorization page in your browser. Paste your Public API key there and validate to complete the OAuth flow.
Cursor / VS Code / Windsurf:
Add to your MCP configuration file (.cursor/mcp.json, .vscode/mcp.json, etc.):
{
"mcpServers": {
"goodbarber": {
"url": "https://mcp.goodbarber.dev/mcp/sse"
}
}
}
The first connection from your client triggers the OAuth flow in your browser — paste your Public API key on the GoodBarber authorization page and validate.
Cline:
Open MCP Servers in Cline, choose "Remote server", transport Streamable HTTP, URL https://mcp.goodbarber.dev/mcp/sse, or add this to cline_mcp_settings.json:
{
"mcpServers": {
"goodbarber": {
"type": "streamableHttp",
"url": "https://mcp.goodbarber.dev/mcp/sse",
"disabled": false,
"autoApprove": []
}
}
}
On the first connection Cline opens the GoodBarber authorization page in your browser — paste your Public API token there and validate. No API key in the config, no environment variable. Agents can also follow llms-install.md.
Any other MCP-compatible client:
Point your client to the MCP endpoint above (Streamable HTTP). The GoodBarber MCP server follows the standard MCP protocol and works with any compliant client.
2. Install the skills
Clone this repo and copy only the skills for your app type:
git clone https://github.com/goodbarber/goodbarber-skills.git
Note: the examples below use Claude's local skills directory (
~/.claude/skills/). If you use another client, copy the skill folders to the directory expected by that client.
eCommerce app:
cp -r goodbarber-skills/skills/ecommerce/* ~/.claude/skills/
Community app:
cp -r goodbarber-skills/skills/community/* ~/.claude/skills/
Membership app:
cp -r goodbarber-skills/skills/membership/* ~/.claude/skills/
CMS / Content (any app with content sections):
cp -r goodbarber-skills/skills/cms/* ~/.claude/skills/
Tip: CMS skills are cross-cutting — install them alongside any app type that has content sections (articles, agenda, maps, galleries, videos, sounds).
Tip: If your GoodBarber app combines multiple types (e.g. eCommerce + Membership), install skills from both directories.
Note: skill directory names carry their family prefix (
shop-,community-,membership-,cms-) and are unique, so skills from several families can live in the same destination without collisions.
3. Verify
Ask your AI assistant: "What skills do you have?" — it should list the installed GoodBarber skills.
Option C — Install in Grok Build
The same package is a Grok Build plugin: .grok-plugin/plugin.json lists the 44 skills and .mcp.json declares the GoodBarber MCP server.
grok plugin install goodbarber/goodbarber-skills --trust
Once the plugin is listed in the xAI plugin marketplace, install it by name instead (grok plugin install goodbarber --trust) or pick it in /marketplace.
On the first GoodBarber tool call, Grok opens the authorization page in your browser: paste your Public API key and validate. Use /mcps to check the connection and /skills to list the 44 skills. Details in SETUP.md.
Skills by App Type
eCommerce (18 skills)
Catalog & Products
| Skill | Description |
|---|---|
shop-best-sellers | Rank products by sales volume and revenue over a given period |
shop-catalog-audit | Detect incomplete product sheets (missing images, descriptions, variants) |
shop-low-performers | Identify products with zero or very low sales |
shop-orphan-products | Find products not assigned to any collection |
shop-product-launch | Guided creation of a full product with variants, images, and SEO |
shop-stock-check | Audit stock levels — flag out-of-stock and low-stock items |
shop-reorder-planner | Generate a supplier-ready replenishment queue based on sales velocity |
Orders & Customers
| Skill | Description |
|---|---|
shop-order-followup | To-do list of orders to process (pending, to ship, to deliver) |
shop-customer-insights | Segment customers into VIP, loyal, dormant, and one-shot profiles |
shop-rfm-segmentation | Recency / Frequency / Monetary customer segmentation |
shop-prospect-nurture | Prioritize prospects and suggest conversion actions |
Promotions
| Skill | Description |
|---|---|
shop-promo-campaign | Create a promo code + send an announcement push in one workflow |
shop-promo-performance-review | Analyze promo impact: before, during, and after the campaign |
Analytics & Communication
| Skill | Description |
|---|---|
shop-traffic-report | App-level analytics: page views, launches, sessions, platforms |
shop-kpi-monitor | Threshold-based daily/weekly KPI health alerts |
shop-weekly-digest | Automated weekly business recap |
shop-push-broadcast | Compose, preview, schedule, and send a push notification to all customers |
shop-push-targeted | Compose, preview, schedule, and send a push to specific customers or prospects |
Community (5 skills)
| Skill | Description |
|---|---|
community-traffic-report | App analytics: page views, launches, sessions by platform |
community-push-broadcast | Send a push to everyone or to specific community groups |
community-push-targeted | Send a push to specific community users |
community-device-landscape | Platform distribution, top devices, OS versions |
community-weekly-digest | Weekly community activity recap |
Membership (10 skills)
Subscriptions
| Skill | Description |
|---|---|
membership-subscription-audit | Active vs expired, churn rate, at-risk subscribers, winback opportunities |
membership-expiration-calendar | Upcoming subscription expirations timeline |
membership-longest-subscribers | Identify your most loyal long-term subscribers |
membership-internal-subscription-grant | Create, update, or revoke internal subscriptions |
Users & Analytics
| Skill | Description |
|---|---|
membership-prospect-followup | Prioritize membership prospects for conversion |
membership-traffic-report | App analytics: page views, launches, sessions by platform |
membership-push-broadcast | Send a push notification to all eligible users |
membership-push-targeted | Send a push to specific users or subscription-status audiences |
membership-device-landscape | Platform distribution, top devices, OS versions |
membership-weekly-digest | Weekly membership business recap |
CMS / Content (11 skills)
Skills for managing editorial content — articles, agenda events, map points of interest, photo galleries, videos, and sounds. Work with any GoodBarber app that has CMS content sections.
Authoring & Publishing
| Skill | Description |
|---|---|
cms-article-publish | Guided creation of a full article: body paragraphs, category, slug, scheduling, paywall |
cms-event-publish | Create an agenda event with start/end datetime, location, and body content |
cms-place-publish | Create a map point of interest (address + coordinates) with description |
cms-gallery-builder | Batch-upload images into a photo gallery and set titles/status |
cms-article-restructure | Reorder, clean, and fix the body paragraphs of an existing article |
Quality & Governance
| Skill | Description |
|---|---|
cms-content-audit | Detect incomplete content across all types (no cover, empty body, missing dates/coords) |
cms-draft-review | Surface stale drafts and unfinished content with a recommended next step |
cms-paywall-audit | IAP apps: check premium content has a coherent free preview (accessTier, maxFreeParagraphs) |
cms-stale-content-refresh | Rank aging articles as refresh, re-promote, or retire candidates |
Planning & Recap
| Skill | Description |
|---|---|
cms-editorial-calendar | Forward view: scheduled publications, upcoming events, expiring content |
cms-weekly-digest | What published this week + what's scheduled next week, by content type |
Note:
weekly-digest,traffic-report,push-broadcast, andpush-targetednames recur across app types. The CMS skills are namespaced by acms-prefix in their frontmatter (e.g.cms-weekly-digest) to avoid collisions — keep them in a separate folder if you install skills from multiple directories.
Usage Examples
"Show me my best sellers this month"
→ best-sellers
"Any products running low on stock?"
→ stock-check
"Create a 20% promo code for summer and notify everyone"
→ promo-campaign
"How's my churn rate looking?"
→ subscription-audit
"Send a push to the Paris group: meetup Friday at 7pm"
→ push-broadcast (community)
"Send a push to Marie and Alex: your item is back in stock"
→ push-targeted (eCommerce)
"Notify expired subscribers about the renewal offer tomorrow at 9am"
→ push-targeted (membership)
"Give me my weekly digest"
→ weekly-digest
"Write and publish an article about our new opening hours"
→ article-publish (cms)
"What content is scheduled to go live next week?"
→ editorial-calendar (cms)
"Audit my content for missing covers and empty posts"
→ content-audit (cms)
Design Principles
All skills follow these rules:
- Pagination-aware — Large datasets are filtered server-side, not blindly paginated
- Fuzzy matching — Mention a product or collection by name; the skill resolves it
- Workflow chaining — Every skill suggests 2–3 related skills to run next
- No destructive actions without confirmation — Mutations always require explicit user validation
- Structured output — Every skill returns a formatted report, not a one-liner
Compatibility
These skills work with any MCP-compatible AI client, including:
- Claude Desktop (Cowork)
- Claude Code (CLI)
- Cursor
- VS Code (Copilot, Claude, Cline, etc.)
- Windsurf
- Codex CLI
- Gemini CLI
- Grok Build (CLI)
- Any client supporting the Model Context Protocol
Repo Structure
goodbarber-skills/
├── .claude-plugin/plugin.json
├── .grok-plugin/plugin.json # Grok Build manifest (lists the 44 skills)
├── .mcp.json
├── README.md
├── SETUP.md
├── server.json # manifest published to the official MCP registry (dev.goodbarber/goodbarber-public-mcp)
└── skills/
├── ecommerce/
│ ├── shop-best-sellers/SKILL.md
│ ├── shop-catalog-audit/SKILL.md
│ ├── shop-customer-insights/SKILL.md
│ ├── shop-kpi-monitor/SKILL.md
│ ├── shop-low-performers/SKILL.md
│ ├── shop-order-followup/SKILL.md
│ ├── shop-orphan-products/SKILL.md
│ ├── shop-product-launch/SKILL.md
│ ├── shop-promo-campaign/SKILL.md
│ ├── shop-promo-performance-review/SKILL.md
│ ├── shop-prospect-nurture/SKILL.md
│ ├── shop-push-broadcast/SKILL.md
│ ├── shop-push-targeted/SKILL.md
│ ├── shop-reorder-planner/SKILL.md
│ ├── shop-rfm-segmentation/SKILL.md
│ ├── shop-stock-check/SKILL.md
│ ├── shop-traffic-report/SKILL.md
│ └── shop-weekly-digest/SKILL.md
├── community/
│ ├── community-device-landscape/SKILL.md
│ ├── community-push-broadcast/SKILL.md
│ ├── community-push-targeted/SKILL.md
│ ├── community-traffic-report/SKILL.md
│ └── community-weekly-digest/SKILL.md
├── membership/
│ ├── membership-device-landscape/SKILL.md
│ ├── membership-expiration-calendar/SKILL.md
│ ├── membership-internal-subscription-grant/SKILL.md
│ ├── membership-longest-subscribers/SKILL.md
│ ├── membership-prospect-followup/SKILL.md
│ ├── membership-push-broadcast/SKILL.md
│ ├── membership-push-targeted/SKILL.md
│ ├── membership-subscription-audit/SKILL.md
│ ├── membership-traffic-report/SKILL.md
│ └── membership-weekly-digest/SKILL.md
└── cms/
├── cms-article-publish/SKILL.md
├── cms-article-restructure/SKILL.md
├── cms-content-audit/SKILL.md
├── cms-draft-review/SKILL.md
├── cms-editorial-calendar/SKILL.md
├── cms-event-publish/SKILL.md
├── cms-gallery-builder/SKILL.md
├── cms-paywall-audit/SKILL.md
├── cms-place-publish/SKILL.md
├── cms-stale-content-refresh/SKILL.md
└── cms-weekly-digest/SKILL.md
Install with the skills CLI
The skills CLI installs these skills into any supported agent (Claude Code, Cursor, Codex, GitHub Copilot, Windsurf, Gemini CLI, Antigravity, Cline and more) in one command:
npx skills add goodbarber/goodbarber-skills
Pick the skills you need from the list, or install all 44 with --all. The skills call the GoodBarber MCP server, so connect it first (see "Install the MCP server" above).
Contributing
Want to add a skill? Create a folder in skills/<app-type>/ with a SKILL.md file. Follow the existing format: YAML frontmatter (name, description, compatibility) + markdown instructions with tool workflow, input/output contracts, and guardrails.
License
The Unlicense — public domain, no restrictions.
Featured
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →