Skip to main content

Scribe

Manage a Scribe workspace through the Scribe MCP server: signatures, teammates, smart fields, folders, assets, integrations, marketing campaigns, and analytics.

When to use this skill

Use it whenever the user wants to:
  • create, edit, publish, install, or audit email signatures
  • assign signatures to teammates, org units, or rule-based audiences
  • add, update, or look up teammates and their email aliases
  • read or set smart fields (the merge fields that populate signatures)
  • organize folders or upload assets (logos, banners, pictures)
  • create, schedule, pause, or report on marketing campaigns
  • pull signature analytics (views, clicks, clickthrough rate)

Connection

  • Endpoint: https://mcp.scribe-mail.com/mcp
  • Auth: OAuth sign-in as the user. No API keys are pasted into the client.
  • Scope: one user in one workspace. Read tools run automatically. Write tools (create, update, delete, publish) ask the user for confirmation in the app.

Core workflow: create a signature in the fewest calls

From a cold session, a complete signature takes three calls:
  1. Call get_content_schema first. In one response it returns the strict block-tree schema, a flat lookup of every allowed enum value (including the non-obvious icon names such as linkedin-in, facebook-f), and a complete worked example with a populated social-icon row.
  2. Adapt that example into a draft_content block tree and call create_signature with a name and the draft_content.
  3. Call publish_signature to copy the draft into the live content and trigger installation.
Do not hand-write a block tree or guess enum spellings. Always call get_content_schema before any create_signature, update_signature, or marketing-campaign content write. An invalid tree returns a 422 that names each offending field.

Common patterns

  • Audit installs: list_signatures (which templates are published and activated), then list_signature_recipients (who each one covers), then list_integrations (any failing connections).
  • Look up teammate data: list_teammates (emails and smart-field values), with list_smart_fields for the field catalog.
  • Fill gaps: read with list_teammates, then set values with update_teammate.
  • Target a signature: set_signature_recipient_rules for auto-assign and conditions, add_signature_recipients for specific emails, or add_signature_recipient_entities for directory org units and groups.
  • Run a campaign: create_marketing_campaign, then schedule_marketing_campaign.
  • Report: get_analytics_overview for totals and a time series, get_analytics_breakdown to rank signatures, teammates, campaigns, or countries.

Tool reference

Access key: Read runs automatically, Write asks for confirmation, Delete asks for confirmation and is destructive.

Schema

ToolAccessWhat it does
get_content_schemaReadReturns the signature block-tree schema, all enum values, and a worked example. Call before authoring content

Signatures

ToolAccessWhat it does
list_signaturesReadList signature templates (block trees omitted unless you pass include_content)
create_signatureWriteCreate a template, staged as draft_content until you publish
update_signatureWriteUpdate a template by id, staged as a draft until you publish
publish_signatureWritePublish a template so the draft becomes live and installs
install_signatureWriteInstall the current live content without publishing
delete_signatureDeleteDelete a template and unassign it from teammates

Signature recipients

ToolAccessWhat it does
list_signature_recipientsReadList who a signature is assigned to, with the targeting rules
add_signature_recipientsWriteAssign a signature to a batch of teammate emails
remove_signature_recipientsWriteRemove manually assigned recipients from a signature
set_signature_recipient_rulesWriteSet auto-assign and the smart-field condition rules
add_signature_recipient_entitiesWriteTarget a signature at directory org units or groups
remove_signature_recipient_entitiesWriteUntarget directory org units or groups

Teammates

ToolAccessWhat it does
list_teammatesReadList teammates with their emails and smart-field values
create_teammateWriteAdd a teammate from an email and optional field values
update_teammateWriteSet a teammate’s smart-field values
delete_teammateDeleteSoft-delete a teammate

Emails

ToolAccessWhat it does
list_emailsReadList teammate emails (primary and aliases)
create_emailWriteAdd an alias email to a teammate
update_emailWriteChange an email address
delete_emailDeleteSoft-delete an alias email (a primary email cannot be deleted)

Smart fields

ToolAccessWhat it does
list_smart_fieldsReadList smart-field definitions with kind and data source
create_smart_fieldWriteDefine a custom field, optionally synced from an integration
update_smart_fieldWriteUpdate a custom field or its integration link
delete_smart_fieldDeleteDelete a custom field and its values on every teammate

Folders

ToolAccessWhat it does
list_foldersReadList signature folders with their signature counts
create_folderWriteCreate a folder to organize templates
update_folderWriteRename a folder
delete_folderDeleteDelete a folder (it must be empty first)

Assets

ToolAccessWhat it does
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 so they keep rendering)

Integrations

ToolAccessWhat it does
list_integrationsReadList active integrations with status and any error details
list_integration_entitiesReadList directory org units and groups to target a signature at

Financial documents

ToolAccessWhat it does
list_financial_documentsReadList invoices and credit notes with downloadable PDF links

Analytics

ToolAccessWhat it does
get_analytics_overviewReadViews and clicks over a date range, with totals and a time series
get_analytics_breakdownReadRank a dimension by views, clicks, or clickthrough rate

Marketing campaigns

ToolAccessWhat it does
list_marketing_campaignsReadList campaigns with status, targeting, and content
create_marketing_campaignWriteCreate a campaign draft with a name and time window
update_marketing_campaignWriteUpdate a campaign by id
schedule_marketing_campaignWriteActivate or schedule a draft or paused campaign
pause_marketing_campaignWritePause an active campaign
resume_marketing_campaignWriteResume a paused campaign
delete_marketing_campaignDeleteDelete a campaign (an active one stops first)

Important notes

  • Always call get_content_schema before writing any signature draft_content or campaign content. It is the fastest path to a valid block tree.
  • Writes are staged. create_signature and update_signature set draft_content; the live content changes only when you call publish_signature.
  • Some actions are blocked when a directory integration (Google Workspace or Microsoft Entra ID) manages the team list. Creating or deleting teammates and emails then returns a 409.
  • Default and integration-synced fields are read-only. Setting them is skipped or returns a 422.
  • List tools are paginated with cursor and limit (1 to 100), plus a bounded auto_paginate and max_pages (cap 20).
  • Every write asks the user to confirm in the connected app, and every action is scoped to the user’s own workspace.