MCP tools reference

An assistant sees only the groups its connection has and the tools its access level allows. The descriptions are in English because they are the text the assistant reads.

Tools	Groups	Package version
135	10	@posty5/mcp 1.0.0

Note

A tool that asks you first does nothing on its first call. It answers with what it would do — and the live price when the action is paid — and acts only when the assistant calls it again after you agree.

Access levels

account

Who the connection is, your credits, and what each action costs

Tool	Access	Asks you first	What it does
account_get_current	read		The Posty5 account this connection acts for.
account_get_credits	read		The account's credit balance and what this period has used.
account_get_credit_usage	read		The credit ledger, newest first.
account_get_operation_costs	read		The live credit price of every paid operation, grouped by module.

short-links

Create, find, edit and delete short links

Tool	Access	Asks you first	What it does
short_link_list	read		Short links, newest first, with their short URL, target and visit count.
short_link_get	read		One short link with its full details.
short_link_create	write		Creates a short link to baseUrl and returns its short URL and QR code URLs.
short_link_update	write		Changes a short link's target or details.
short_link_delete	full	Yes	Deletes a short link.

qr-codes

QR codes of every type, and the templates that style them

Tool	Access	Asks you first	What it does
qr_code_list	read		QR codes, newest first, with their type, landing page URL, image URL and scan count.
qr_code_get	read		One QR code with its full details.
qr_code_list_templates	read		The templates that style a QR code — every QR code needs one.
qr_code_create	write		Creates a QR code of the given type and returns its landing page URL and image URL.
qr_code_update	write		Replaces a QR code's target.
qr_code_delete	full	Yes	Deletes a QR code.

html-hosting

Hosted pages, their variables and their form submissions

Tool	Access	Asks you first	What it does
html_page_list	read		Hosted HTML pages, newest first, with their URL, source (file or GitHub), status, visits and form submission count.
html_page_get	read		One hosted page with its full details.
html_page_lookup	read		Every page's _id, name and short code in one light list — for finding a page's id.
html_page_list_forms	read		The forms Posty5 found on a page, with each form's formId and field names.
html_page_create_from_html	write		Publishes the given HTML as a new hosted page (uploaded as index.html) and returns its _id and URL.
html_page_create_from_github	write		Publishes an HTML file from a public GitHub repository as a new hosted page and returns its _id and URL.
html_page_update_from_html	write		Replaces a hosted page's content with the given HTML.
html_page_update_from_github	write		Replaces a hosted page's content with an HTML file from a public GitHub repository.
html_page_clean_cache	write		Clears the cached copy of a hosted page so visitors get its latest content at once.
html_page_delete	full	Yes	Deletes a hosted page.
html_variable_list	read		Runtime variables.
html_variable_get	read		One runtime variable.
html_variable_create	write		Creates a runtime variable hosted pages can read by its key (which must start with "pst5_").
html_variable_update	write		Changes a runtime variable.
html_variable_delete	full	Yes	Deletes a runtime variable.
form_submission_list	read		What visitors submitted through one hosted page's forms, newest first, with each submission's data and status.
form_submission_get	read		One form submission with its data, status history, page and form.
form_submission_get_adjacent	read		The ids and numbers of the submissions just before and after this one on the same page, for stepping through them.
form_submission_change_status	write		Moves a form submission to a new status (e.g.
form_submission_delete	full	Yes	Deletes one form submission.

social-publisher

Workspaces, connected accounts, and posts to every platform

Tool	Access	Asks you first	What it does
social_workspace_list	read		Social publishing workspaces, newest first.
social_workspace_get	read		One workspace with the account connected to it on each platform.
social_workspace_get_for_new_post	read		A workspace's connected accounts per platform, as a new post sees them.
social_account_list	read		Social accounts connected to Posty5, with platform and status.
social_account_get	read		One connected account.
social_workspace_create	write		Creates an empty workspace and returns its workspaceId.
social_workspace_update	write		Changes a workspace's name or description.
social_workspace_delete	full	Yes	Deletes a workspace.
social_post_list	read		Posts, newest first, with caption, status, schedule and target.
social_post_get_status	read		One post's progress on each platform.
social_post_get_default_settings	read		The default publishing settings saved for this Posty5 account — use them to fill platform blocks the user did not specify.
social_post_get_adjacent	read		The ids of the posts just before and after this one, for stepping through them.
social_post_publish_image	write		Publishes one image, from a public URL, with a caption — at once or at scheduledAt.
social_post_publish_short_video	write		Publishes a short video (a reel, short or TikTok) from a public URL — at once or at scheduledAt.
social_post_quote_long_video	read		Measures a video of up to 60 minutes from its URL and returns its duration, the credits publishing it would cost, and which platforms accept a video that long.
social_post_publish_long_video	write	Yes	Publishes a video of up to 60 minutes from a public URL — at once or at scheduledAt.
social_post_publish_text	write		Publishes a text-only post — at once or at scheduledAt — to Facebook, Threads and X.
social_post_publish_story	write		Publishes a story — one image or one video, from a public URL, with no caption — at once or at scheduledAt.
social_post_reschedule	write		Moves a post that has not published yet to a new time, or publishes it now ("now"), optionally replacing its caption.
social_post_delete	full	Yes	Deletes a post that has not published yet, with its uploaded media.
social_post_remove_from_platforms	full	Yes	Deletes a published post's media from the platforms it was published to, at once.

store

The stores this connection can manage

Tool	Access	Asks you first	What it does
store_list	read		The online stores this connection can manage — owned or staffed — each as { _id, name } where name is "<slug> - <name>".

store-catalog

Products and tags

Tool	Access	Asks you first	What it does
store_product_search	read		A store's products with their price, stock, SKU and status.
store_product_get	read		One product in full.
store_product_estimate_ai_content	read		What writing a product's landing sections with AI would cost, and whether the account can afford it — for the same arguments store_product_generate_ai_content takes.
store_product_create	write		Creates one product from its name and price, plus any of description, images (by URL), stock, SKU and simple options.
store_product_create_draft	write		Creates a draft product from just a SKU and a name — not on the storefront.
store_product_bulk_create	write		Creates up to 50 products in one call, each with the fields store_product_create takes.
store_product_clone_from_url	write	Yes	Reads a product page on any online shop (Amazon, AliExpress, a brand's own site…) and creates a draft product from it.
store_product_update	write		Changes a product's main fields.
store_product_update_section	write		Writes one part (section) of a product; the other parts are untouched.
store_product_reorder	write		Sets the storefront display position (sortOrder) of up to 500 products at once.
store_product_generate_ai_content	write	Yes	Writes the chosen landing sections of a product (and, if asked, variant groups) with AI from a short brief.
store_product_delete	full	Yes	Deletes a product.
store_tag_search	read		A store's catalogue tags with their product counts.
store_tag_get	read		One tag.
store_tag_resolve_products	read		The products carrying any of the given tags, without duplicates — what a tag-driven storefront section shows.
store_tag_list_products	read		The products assigned to one tag, optionally narrowed by part of the product name.
store_tag_get_product_tags	read		The tags one product carries.
store_tag_create	write		Creates a catalogue tag for grouping products (e.g.
store_tag_update	write		Changes a tag's name, slug, description, status or automatic-removal period.
store_tag_assign_products	write		Adds up to 200 products to a tag.
store_tag_unassign_product	write		Takes one product off one tag.
store_tag_set_product_tags	write		Replaces one product's whole tag list (at most 50).
store_tag_delete	full	Yes	Deletes a tag and takes it off every product that carries it.

store-orders

Orders and customers — includes shoppers' personal data

Tool	Access	Asks you first	What it does
store_order_search	read		A store's orders.
store_order_get	read		One order in full.
store_order_statistics	read		Order figures for a window of days (default the last 30).
store_order_create	write		Records an order the store received outside the storefront (phone, WhatsApp, social media).
store_order_update_status	write		Moves an order along pending → confirmed → processing → shipped → delivered; cancelled or refused can be set from any state that is not final (delivered, cancelled and refused are final).
store_order_add_note	write		Adds a staff-only note to an order.
store_customer_search	read		The people who have ordered from a store, with their order count and spend there.
store_customer_get	read		One customer's profile and their figures for this store.
store_customer_get_addresses	read		The delivery addresses one customer has used with this store, never those used elsewhere.
store_customer_list_orders	read		This store's orders from one customer, never orders placed in other stores.

store-shipping

Shipping countries, routes, profiles and assignments

Tool	Access	Asks you first	What it does
store_shipping_list_countries	read		The countries a store delivers to.
store_shipping_list_country_catalogue	read		The world's countries the store has not opened yet, with their ISO codes — where store_shipping_add_country's iso comes from.
store_shipping_get_country	read		One delivery country.
store_shipping_list_governorates	read		A country's governorates (states, provinces) from the reference catalogue, with the code every route and assignment uses.
store_shipping_list_routes	read		Every governorate of a country (level "governorate", the default), or every city of one governorate (level "city" with governorateCode), each with what it charges today, whether that fee is its own or inherited (inheritedFrom), and whether delivery is allowed.
store_shipping_preview_fee	read		What a destination would be charged for delivery and whether the store delivers there, resolved the way checkout does.
store_shipping_list_profiles	read		The store's package profiles, each with its size (condition) and where it is priced (pricing).
store_shipping_get_profile	read		One package profile.
store_shipping_get_place_prices	read		The parcel-price table of one place (a country, a governorate or a city).
store_shipping_list_parcel_prices	read		Every parcel price the store has set, across countries, governorates and cities, smallest size first.
store_shipping_add_country	write		Opens a country for delivery at a fee.
store_shipping_update_country	write		Opens or pauses a delivery country, changes its fee, or moves it in the list.
store_shipping_upsert_route	write		Sets one governorate's or one city's own fee, or blocks or allows delivery there.
store_shipping_bulk_upsert_routes	write		Sets the fee or delivery block of up to 200 governorates and cities of one country in one call, each row as store_shipping_upsert_route would.
store_shipping_apply_fee	write		Gives every governorate of a country (level "governorate"), or every city of one governorate (level "city" with governorateCode), the same fee — replacing each place's own fee in that scope.
store_shipping_create_profile	write		Creates a package profile — one parcel size.
store_shipping_update_profile	write		Renames or re-describes a package profile, or changes its size.
store_shipping_save_place_prices	write		Sets the parcel prices of one place (a country, a governorate or a city) in one call.
store_shipping_update_parcel_price	write		Changes the fee of one parcel price the store already set.
store_shipping_delete_country	full	Yes	Stops delivering to a country and deletes every governorate and city override under it.
store_shipping_clear_route	full	Yes	Removes one place's own fee or delivery block, putting it back on whatever it inherits (its governorate, the country or the store default).
store_shipping_delete_profile	full	Yes	Deletes a package profile and every parcel price set for it, at every place.
store_shipping_remove_parcel_price	full	Yes	Removes one parcel price.

store-dropshipping

Supplier catalogue, imports, product links and supplier orders

Tool	Access	Asks you first	What it does
store_supplier_catalogue	read		The dropshipping suppliers this store can connect, each with what it can do (browse, order, pay from a balance, cancel, tracking), the countries it ships from and to, and whether it is available.
store_supplier_list	read		The store's supplier connections.
store_supplier_test	read		Checks a supplier connection now by calling the supplier with the stored credentials, and records the outcome as the connection's health.
store_supplier_get_balance	read		The money in the store's account at a supplier, in the supplier's own currency (never converted) — what paying supplier orders spends.
store_supplier_browse_products	read		Browses or searches a connected supplier's catalogue.
store_supplier_get_product	read		One supplier product with every variant (supplierVariantId, options, cost, stock, weight), its images, ships-from countries and delivery estimate.
store_supplier_resolve_url	read		Finds the supplier product behind a product page link on that supplier's site and returns it like store_supplier_get_product.
store_supplier_preview_import	read		Prices the chosen supplier products with the price rule and names duplicates, warnings and errors row by row, with the batch's credit total.
store_supplier_get_import_status	read		The progress of a large import that store_supplier_import queued (it answered a jobId instead of rows), and its rows once state is completed.
store_supplier_list_links	read		The store's product links.
store_supplier_list_orders	read		Supplier orders, newest first.
store_supplier_get_order	read		One supplier order with its lines, costs, the merchant's payment to the supplier, tracking and full event history.
store_supplier_import	write	Yes	Imports supplier products into the store as new products, priced by the price rule and fulfilled by that supplier.
store_supplier_link_create	write		Links a product the store already sells to a supplier product, so its orders are fulfilled by that supplier.
store_supplier_link_update	write		Changes a product link's price rule, what the hourly sync may overwrite (stock, cost, price, images, description), its delivery estimate, or the supplier disclosure shown to shoppers.
store_supplier_link_sync	write		Syncs one product link now.
store_supplier_order_retry	write	Yes	Runs a queued, paused (needsReview) or failed supplier order again through the same checks as the first send.
store_supplier_link_delete	full	Yes	Removes a product link.
store_supplier_order_submit	full	Yes	Sends one supplier part of a store order to its supplier now.
store_supplier_order_pay	full	Yes	Pays a supplier order that was created at the supplier but not paid, from the store's balance at that supplier — real money.
store_supplier_order_cancel	full	Yes	Withdraws a supplier order at the supplier, where the supplier still allows it.
store_fulfilment_group_fulfil_manually	full	Yes	Takes one supplier part of a store order over.