MCP tool reference · Stensul Developers

You rarely call these yourself: your AI host picks tools from your prompt. Knowing them helps you write better prompts, set permissions in your host (every write tool changes content), and debug a session. How the host signs in is covered in Authentication.

Sign-in and status

Tool	What it does	Scope	Access
`stensul-check-auth`	Reports whether the current session has a valid sign-in, where the token came from, and what to do next.	none	read
`stensul-get-auth-url`	Starts the OAuth authorization-code flow and returns the sign-in URL the user opens in a browser.	none	write
`stensul-health`	Checks credentials, connectivity and available scopes. Run it first when calls fail with authentication or access errors.	none	read

Libraries

Tool	What it does	Scope	Access
`stensul-get-libraries`	Lists libraries, or returns everything needed to work in one: its modules, variations, Segment Set support, languages, tags and which email settings it enables.	`libraries:read`	read

Emails

Tool	What it does	Scope	Access
`stensul-list-emails`	Lists emails and templates with filters for name, type, library, tags, language, project and status.	`emails:read`	read
`stensul-read-email`	Reads an email or template. The default `plan` view returns its full structure with repeated styles and guardrails deduplicated, which is what you need before building or editing.	`emails:read`	read
`stensul-build-email`	Creates a complete draft in one call: starts from a template or an existing email, sets the settings, uploads images by public URL and writes all the content.	`emails:write`	write
`stensul-create-email`	Creates an empty draft in a library from a list of module keys. Prefer `stensul-build-email` for normal creation.	`emails:write`	write
`stensul-copy-email`	Creates an independent draft copy of an email, keeping all content, modules and layout. The original is never changed.	`emails:write`	write
`stensul-update-email-content`	Edits content inside an existing draft: copy, buttons, images, alt text, visibility, custom-element variables and URL tracking. Anything you leave out stays as it is.	`emails:write`	write
`stensul-update-email-settings`	Changes a draft's name, title, subject line or preheader. The email body is untouched.	`emails:write`	write
`stensul-add-email-module`	Adds one module (a whole section) from the library to a draft, found by what the user called it.	`emails:write`	write
`stensul-delete-email-module`	Removes one module (a whole section) from a draft, or checks what else would go when the user asked to remove a single element.	`emails:write`	write
`stensul-apply-email-variation`	Applies a styling variation to the whole email, one module, or several modules in one call. Content is untouched and the change is reversible.	`emails:write`	write

Images

Tool	What it does	Scope	Access
`stensul-list-gallery-images`	Browses the account's approved image gallery. Use it before asking the user for a file.	`dam:read`	read
`stensul-upload-images`	Uploads up to five images from public URLs to a draft (or to Studio for module backgrounds), or searches the gallery.	`images:write`	write
`stensul-image-upload-session`	The upload path for local images: files the user has, pastes or attaches. Mints a single-use browser upload link, or a small uploader script on hosts with a shell.	`images:write`	write

Preview and quality

Tool	What it does	Scope	Access
`stensul-preview-email`	Renders a read-only visual preview of an email, images included.	`emails:read`	read
`stensul-run-quality-check`	Runs the account's accessibility and quality checks on an email and returns the issues found.	`emails:read`	read

Dynamic content

Tool	What it does	Scope	Access
`stensul-list-segment-sets`	Lists the Segment Sets available for a library: each set's name, segment type and ordered segments.	`dynamic-content:read`	read
`stensul-apply-segment-set`	Applies an existing Segment Set to a module (or one element) and can write each segment's content in the same call.	`dynamic-content:write`	write
`stensul-update-segment-content`	Writes the content of one segment created by `stensul-apply-segment-set`. All of that segment's elements go in one call.	`dynamic-content:write`	write

Resources the server also provides

Besides tools, the server serves reference text that hosts read on demand: the content format (stensul://reference/content-format), a getting-started guide (stensul://guides/getting-started), and the email and enhancements workflows (stensul://workflows/email,stensul://workflows/enhancements). The in-chat preview is an MCP App (ui://stensul/email-preview). The server registers no MCP prompts.