Scribe MCP tools reference - Scribe Mail Documentation

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 worksRead 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

Ranked breakdowns (set group_by) return views, clicks, and clickthrough rate on every row. Time series return a single count per bucket, so for a clickthrough rate over time, pair get_analytics_views with get_analytics_clicks and divide clicks 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.

​Schema

​Signatures

​Signature variants

​Signature recipients

​Teammates

​Emails

​Smart fields

​Folders

​Assets

​Integrations

​Financial documents

​Workspace

​Analytics

​Visitors

​Marketing campaigns

​Connect your assistant

Schema

Signatures

Signature variants

Signature recipients

Teammates

Emails

Smart fields

Folders

Assets

Integrations

Financial documents

Workspace

Analytics

Visitors

Marketing campaigns

Connect your assistant