Search Email Templates

Tool name: search-email-editor-templates

Searches the design catalogue the email editor's template browser shows, and returns each design with a number, its id, name, thumbnail and the tags, categories and collections it carries. The number is for pointing at a design; apply takes the id. The three lists are the same three filters this tool takes, so an answer says how to narrow the next call: a category, collection or tag this tool ANSWERED with is always one it accepts back. All three are free text out of the catalogue's own vocabulary, and a value it does not know matches nothing rather than being refused. Paged: twelve per page by default, with total and nextPage. A host that renders MCP Apps shows the designs as pictures; without one, offer the names and let the user pick, because a template is a layout and its name does not describe it. Reads only: this does not create anything and does not change an existing email.

Input schema

tagnull or string, <= 250 characters

Narrow by one look-and-feel tag, e.g. "light", "white", "three-columns"; omit for all

Default:null

categorynull or string, <= 250 characters

Narrow by one category as this tool reports them, e.g. "events", "saas"; omit for all

Default:null

collectionnull or string, <= 250 characters

Narrow by one collection as this tool reports them, e.g. "welcome-series"; omit for all

Default:null

pagenull or integer, >= 1

Which page of the catalogue, from 1; default 1

Default:null

pageSizenull or integer, [ 1 .. 35 ]

How many designs per page, 1-35; default 12

Default:null

accountIdnull or integer, >= 1

User ID of the account; omit for the account the access token works in

Default:null

Input example

{
  "tag": null,
  "category": null,
  "collection": null,
  "page": null,
  "pageSize": null,
  "accountId": null
}

Output schema

tagstring or nullrequired

categorystring or nullrequired

collectionstring or nullrequired

pageintegerrequired

totalintegerrequired

nextPageintegerrequired

countintegerrequired

templatesArray of objectsrequired

htmlstringrequired

Output example

{
  "tag": "string",
  "category": "string",
  "collection": "string",
  "page": 0,
  "total": 0,
  "nextPage": 0,
  "count": 0,
  "templates": [
    {
      "number": 0,
      "id": "string",
      "name": "string",
      "thumbnailUrl": "string",
      "previewUrl": "string",
      "tags": [
        "string"
      ],
      "categories": [
        "string"
      ],
      "collections": [
        "string"
      ]
    }
  ],
  "html": "string"
}