Scribe MCP tools reference

Every tool the Scribe MCP server exposes to your AI assistant, grouped by area, with read, write, and delete access marked.

These are the tools your AI assistant can call once you connect the Scribe MCP server. The server exposes 57 tools across 15 areas. To connect an assistant, see the AI agents overview.

How access works

Read tools run automatically and never change your data. Write tools (create, update, publish, and similar) ask you to confirm first. Delete tools also ask you to confirm and are destructive. Every action is scoped to your own workspace.

Schema

Tool	Access	What it does
get_content_schema	Read	Returns the signature block-tree schema, all enum values, and a worked example. Call before authoring content

Signatures

Tool	Access	What it does
list_signatures	Read	List signature templates (block trees omitted unless you pass include_content)
create_signature	Write	Create a template, staged as draft_content until you publish
update_signature	Write	Update a template by id, staged as a draft until you publish
preview_signature	Read	Render a draft or published template to HTML with placeholder values to check layout
get_signature_html	Read	Get the real installed HTML of a published signature for a specific recipient
publish_signature	Write	Publish a template so the draft becomes live and installs
install_signature	Write	Install the current live content without publishing
delete_signature	Delete	Delete a template and unassign it from teammates

Signature variants

A variant is an alternate signature shown on reply emails or on internal (same-domain) emails. Variants require an active Microsoft 365 signatures integration; without it, variant writes return a 409 variants_unavailable.

Tool	Access	What it does
list_signature_variants	Read	List a signature’s reply and internal variants with their state and content
update_signature_variant	Write	Create or update a reply or internal variant, staged as a draft until you publish
publish_signature_variant	Write	Publish a variant so its draft becomes live and redeploys
delete_signature_variant	Delete	Reset a variant back to the primary signature (the record is kept)

Signature recipients

Tool	Access	What it does
list_signature_recipients	Read	List who a signature is assigned to, with the targeting rules
add_signature_recipients	Write	Assign a signature to a batch of teammate emails
remove_signature_recipients	Write	Remove manually assigned recipients from a signature
set_signature_recipient_rules	Write	Set auto-assign and the smart-field condition rules
add_signature_recipient_entities	Write	Target a signature at directory org units or groups
remove_signature_recipient_entities	Write	Untarget directory org units or groups

Teammates

Tool	Access	What it does
list_teammates	Read	List teammates with their emails and smart-field values
create_teammate	Write	Add a teammate from an email and optional field values
update_teammate	Write	Set a teammate’s smart-field values
delete_teammate	Delete	Soft-delete a teammate

Emails

Tool	Access	What it does
list_emails	Read	List teammate emails (primary and aliases)
create_email	Write	Add an alias email to a teammate
update_email	Write	Change an email address
delete_email	Delete	Soft-delete an alias email (a primary email cannot be deleted)

Smart fields

Tool	Access	What it does
list_smart_fields	Read	List smart-field definitions with kind and data source
create_smart_field	Write	Define a custom field, optionally synced from an integration
update_smart_field	Write	Update a custom field or its integration link
delete_smart_field	Delete	Delete a custom field and its values on every teammate

Folders

Tool	Access	What it does
list_folders	Read	List signature folders with their signature counts
create_folder	Write	Create a folder to organize templates
update_folder	Write	Rename a folder
delete_folder	Delete	Delete a folder (it must be empty first)

Assets

Tool	Access	What it does
list_assets	Read	List the image library (logos, banners, pictures)
create_asset	Write	Upload an image from base64 or a source URL
update_asset	Write	Update an asset’s name or role
delete_asset	Delete	Delete an asset (in-use assets are soft-deleted so they keep rendering)

Integrations

Tool	Access	What it does
list_integrations	Read	List active integrations with status and any error details
list_integration_entities	Read	List directory org units and groups to target a signature at

Financial documents

Tool	Access	What it does
list_financial_documents	Read	List invoices and credit notes with downloadable PDF links

Workspace

Tool	Access	What it does
get_workspace	Read	Read the workspace plan, status, and invoiced seat count

Analytics

There is no clickthrough-rate field. Pair get_analytics_views with get_analytics_clicks and compute clicks divided by views.

Tool	Access	What it does
get_analytics_views	Read	Signature views over a date range, as a time series or a ranked breakdown
get_analytics_clicks	Read	Signature clicks over a date range, as a time series or a ranked breakdown
get_analytics_events_summary	Read	Aggregated conversion and revenue numbers, as a time series or a ranked breakdown
list_analytics_events	Read	List the raw recorded conversion events behind the analytics

Visitors

Visitors are the workspace’s own identified end-users (from identify calls), not Scribe teammates.

Tool	Access	What it does
list_visitors	Read	List identified visitors with traits and first-touch attribution
get_visitor	Read	Get one identified visitor with traits, attribution, and lifetime engagement
get_visitor_breakdown	Read	Rank which signature or teammate acquired the most identified visitors

Marketing campaigns

Tool	Access	What it does
list_marketing_campaigns	Read	List campaigns with status, targeting, and content
create_marketing_campaign	Write	Create a campaign draft with a name and time window
update_marketing_campaign	Write	Update a campaign by id
schedule_marketing_campaign	Write	Activate or schedule a draft or paused campaign
pause_marketing_campaign	Write	Pause an active campaign
resume_marketing_campaign	Write	Resume a paused campaign
delete_marketing_campaign	Delete	Delete a campaign (an active one stops first)

Connect your assistant

Ready to connect? Follow the per-assistant steps on the AI agents overview.