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
73	5	@posty5/mcp 1.3.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_credit_transfer_eligibility	read		Whether this account can send credits to another Posty5 account (Business plan only), how many it can send, and whether it can still receive a transfer on the Free plan.
account_list_credit_transfers	read		Credits this account sent to or received from other Posty5 accounts, 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_get_analytics	read		Visits to one short link over a date range.
short_link_create	write		Creates a short link to baseUrl and returns its short URL and QR code URLs.
short_link_create_many	write	Yes	Creates 1 to 25 short links in one call.
short_link_update	write		Changes a short link's target, details or controls.
short_link_delete	full	Yes	Deletes a short link.
short_link_set_rules	write		Sets a short link's controls.
short_link_list_tags	read		The distinct tags on your short links, sorted, at most 200.
short_link_check_health	write		Queues one health check of the link's destinations.
short_link_campaign_list	read		Link campaigns.
short_link_campaign_get	read		One link campaign with its default UTM, linkCount and totalVisits (the sum of its links' visits).
short_link_campaign_create	write		Creates a link campaign.
short_link_campaign_update	write		Changes a link campaign.
short_link_campaign_delete	full	Yes	Deletes a link campaign.

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, mode (static or dynamic), dynamicSince, landing page URL, image URL and scan count.
qr_code_get	read		One QR code with its full details.
qr_code_render	read		A signed download link for a QR code's image as PNG, SVG or PDF, optionally at a print size (presetId) and, for PNG, a resolution (dpi).
qr_code_check_scannability	read		Checks whether a QR code (qrCodeId) or a template (templateId, from qr_code_list_templates) will scan reliably.
qr_code_get_analytics	read		Visits that reached Posty5 through one QR code over a date range.
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 mode, landing page URL and image URL.
qr_code_create_many	write	Yes	Creates 1 to 25 QR codes in one call; each row takes the same type and fields as qr_code_create, and needs a templateId (or one in defaults).
qr_code_get_bulk_job	read		The status and counters of a QR bulk job started by qr_code_create_many with zip.
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.