Skip to main content

Scribe signature design

Build valid, render-safe signature layouts through the Scribe MCP server.

When to use

  • Create a signature from a brief, an example, or a screenshot
  • Restyle an existing signature or fix layout and spacing
  • Add a logo, banner, or social-icon row
  • Match a brand’s colors, fonts, and structure
  • Preview rendering before publishing, or read a recipient’s installed HTML
  • Add a reply or internal variant of a signature
  • Organize templates into folders

Workflow

  1. Call get_content_schema first. It returns the block-tree schema, every allowed enum value (including icon names like linkedin-in, facebook-f), and a worked example. Never hand-write a tree or guess enum spellings.
  2. Adapt the example into draft_content and call create_signature or update_signature.
  3. Call preview_signature and read the returned HTML to check layout and spacing while it is still a draft.
  4. Call publish_signature to make it live, or install_signature to install the current live content without publishing.

Variants

A variant is an alternate signature shown on reply emails or on internal (same-domain) emails. Call get_content_schema, stage the variant with update_signature_variant, then publish_signature_variant. Variants need an active Microsoft 365 signatures integration; without it, variant writes return a 409 variants_unavailable.

Tool reference

Access key: Read runs automatically, Write asks for confirmation, Delete is destructive.
ToolAccessWhat it does
get_content_schemaReadReturns the block-tree schema, all enum values, and a worked example. Call before authoring content
list_signaturesReadList signature templates
create_signatureWriteCreate a template, staged as draft until you publish
update_signatureWriteUpdate a template, staged as draft until you publish
preview_signatureReadRender a draft or published template to HTML with placeholder values to check layout
get_signature_htmlReadGet the real installed HTML of a published signature for a specific recipient
publish_signatureWritePublish so the draft becomes live and installs
install_signatureWriteInstall the current live content without publishing
delete_signatureDeleteDelete a template and unassign it
list_signature_variantsReadList a signature’s reply and internal variants
update_signature_variantWriteCreate or update a reply or internal variant, staged as a draft
publish_signature_variantWritePublish a variant so its draft becomes live
delete_signature_variantDeleteReset a variant back to the primary signature
list_foldersReadList signature folders with counts
create_folderWriteCreate a folder to organize templates
update_folderWriteRename a folder
delete_folderDeleteDelete a folder (must be empty first)
list_assetsReadList the image library (logos, banners, pictures)
create_assetWriteUpload an image from base64 or a source URL
update_assetWriteUpdate an asset’s name or role
delete_assetDeleteDelete an asset (in-use assets are soft-deleted)

Rendering notes

  • Keep layouts table-based and inline-styled so they hold up in Outlook, Gmail, and Apple Mail.
  • preview_signature shows placeholder values and needs no recipient, so use it to verify a draft. get_signature_html returns the real installed HTML for one recipient and is empty until the signature is published.
  • An invalid tree returns a 422 that names each offending field. Fix and retry.