Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.shingleai.com/llms.txt

Use this file to discover all available pages before exploring further.

The ShingleAI MCP server provides 7 tools for managing email templates and using them to send templated emails. These tools are organized into two categories: templates and render & send.

​
Templates

CRUD tools for managing reusable email templates. Templates support Mustache syntax for dynamic content in both subject lines and bodies.

​
createEmailTemplate

Create a new email template with name (max 200 chars), subject (max 1000 chars), body (max 50000 chars), and optional variables. Templates support Mustache syntax for dynamic content. Permission: emailTemplates:write Parameters:
NameTypeRequiredDescription
namestringYesThe name of the email template (1-200 characters)
subjectstringYesThe subject line of the email template (1-1000 characters). Supports Mustache variables.
bodystringYesThe body content of the email template (1-50000 characters). Supports Mustache variables.
descriptionstringNoOptional description of the email template (max 2000 characters)
variablesstring[]NoOptional list of variable names used in the template for documentation
Returns: The created email template object.

​
getEmailTemplate

Get a specific email template by ID, including all template details. Permission: emailTemplates:read Parameters:
NameTypeRequiredDescription
idstring (UUID)YesThe ID of the email template to retrieve
Returns: The email template object, or null if not found.

​
listEmailTemplates

List email templates for the organization with pagination. Supports filtering by status and name. Permission: emailTemplates:read Parameters:
NameTypeRequiredDefaultDescription
limitnumberNo10Number of email templates to return (1-100)
offsetnumberNo0Number of email templates to skip for pagination
statusstringNo-Filter by template status (active or archived)
namestringNo-Filter by name (case-insensitive partial match, max 200 characters)
Returns: 
{
  "emailTemplates": [...],
  "count": 8,
  "limit": 10,
  "offset": 0
}

​
updateEmailTemplate

Update an existing email template with new values for any template fields. Name max 200 chars, subject max 1000 chars, body max 50000 chars. Permission: emailTemplates:write Parameters:
NameTypeRequiredDescription
idstring (UUID)YesThe ID of the email template to update
namestringNoThe name of the email template (1-200 characters)
descriptionstring | nullNoDescription of the email template (max 2000 characters)
subjectstringNoThe subject line of the email template (1-1000 characters)
bodystringNoThe body content of the email template (1-50000 characters)
variablesstring[] | nullNoList of variable names used in the template for documentation
statusstringNoTemplate status (active or archived)
Returns: The updated email template object.

​
deleteEmailTemplate

Delete an email template (soft delete). Permission: emailTemplates:delete Parameters:
NameTypeRequiredDescription
idstring (UUID)YesThe ID of the email template to delete
Returns: The deleted email template object.

​
Render & Send

Tools for rendering templates with variable data and dispatching templated emails through the organization’s email pipeline.

​
renderEmailTemplate

Render an email template by ID with provided data variables using Mustache templating. Returns the rendered subject and body. Permission: emailTemplates:read Parameters:
NameTypeRequiredDescription
templateIdstring (UUID)YesThe ID of the email template to render
dataRecord<string, unknown>YesKey-value pairs of variable data to render into the template
Returns: Object with subject and body strings containing the rendered content.

​
sendTemplatedEmail

Render an email template with data and send it. Fetches the template, renders subject and body with the provided data, and sends the email from the specified email address. Permission: emailTemplates:write Parameters:
NameTypeRequiredDescription
templateIdstring (UUID)YesThe ID of the email template to use
dataRecord<string, unknown>YesTemplate variable data for rendering
tostring[]YesArray of recipient email addresses (at least one)
fromEmailAddressIdstring (UUID)YesThe ID of the email address to send from
ccstring[]NoArray of CC email addresses
bccstring[]NoArray of BCC email addresses
replyTostringNoReply-to email address
Returns: Object with subject, to, from, rendered, and sent fields summarizing the send result.

​
Next Steps

Email Address Tools

Discover which email addresses are available to send from

Authentication

Learn how MCP clients authenticate to the server