search_library

Type: Read · Required scope: decks:read · Cost: Free

Searches the Decky slide library: professionally designed slide templates (KPIs, processes, timelines, matrices, comparisons, charts, agendas …) and template decks (whole storylines, such as a board review). Use it to show the user what fits, then pass a deck_id or template_ids to fill_templates.

You don’t need this tool for a normal deck. create_deck already builds slides from library templates on its own where one fits.

Parameters

string

required

What the slide or deck should be: its form and purpose. For example "budget vs actual by month", "five-step process", or "board strategy review".

string

default:"any"

"template" (single slides), "deck" (template decks), or "any" (both).

integer

default:"6"

Maximum results per kind. Range: 1–10.

boolean

default:"true"

Attach a small thumbnail image for each result.

What it searches

Kind	Where results come from	How they match
`template`	Decky’s built-in library of designed slide templates	By meaning and words of the query
`deck`	Decky’s built-in template decks, your own library decks, and, for work accounts, your organization’s shared decks	By the words of the query. With `kind: "deck"`, if no deck matches, the available decks are listed with a `note`.

Only template slides can be filled. A deck’s fillable_slides tells you how many of its slides fill_templates can use.

Response

The result is one JSON text block. When thumbnails is true, the available thumbnails follow it. Each thumbnail is a text line (Thumbnail: template <id> — <title> or Thumbnail: deck <id> — <title>) followed by a PNG image.

object[]

The matches. Each has a kind, "template" or "deck".

Show Template fields

string

Pass it in template_ids to fill_templates.

string

The template’s name.

string | null

The template’s category, such as kpi.

string

When to use the template.

string

What the template can hold: title length, text slots, repeating groups (with their minimum and maximum count), charts and pictures. A chart needs real data.

number | null

How closely the template matches the query.

string | null

A link to a larger preview image. It works for one hour.

Show Deck fields

string

Pass it as deck_id to fill_templates.

string

The deck’s name.

string

What the deck is for.

integer

Number of slides in the deck.

integer

Number of those slides that are templates and can be filled.

string

builtin (Decky’s library), personal (yours), or org (shared in your organization).

string

Present when no deck matched the query and the available decks are listed instead.

string | null

For built-in decks: a link to the deck’s thumbnail. It works for one hour.

string

What to do next: fill a deck or chosen templates (1 credit per slide), or build from scratch with create_deck when nothing fits.

Show Example response (JSON block)

{
  "results": [
    {
      "kind": "template",
      "id": "5d2f8a61-3c4b-4e7a-9f10-2b6c8d4e1a73",
      "title": "KPI overview with trend",
      "category": "kpi",
      "usage": "Four headline figures with a short trend chart for a monthly review.",
      "holds": "title ≤ 60 chars, 2 text slot(s), kpis ×3–4, bar chart (needs real data)",
      "similarity": 0.71,
      "preview_url": "https://…"
    },
    {
      "kind": "deck",
      "id": "a8c1e4f2-6b7d-4d3e-8a91-0f5b2c7e9d64",
      "title": "Board strategy review",
      "about": "Storyline for a board meeting: context, performance, options, recommendation, next steps.",
      "slides": 14,
      "fillable_slides": 14,
      "scope": "builtin",
      "preview_url": "https://…"
    }
  ],
  "next": "fill_templates(deck_id=…) fills a whole deck, fill_templates(template_ids=[…]) chosen templates — 1 credit per slide. Templates need real data for their charts."
}

In clients that show interactive cards (MCP Apps), such as claude.ai and Claude Desktop, the result appears as an interactive library picker with slide previews. The user picks a deck or single slides there, and the assistant continues with fill_templates. See Interactive cards.

Example

“Show me template decks in the Decky library for a quarterly board review.”

The assistant calls:

{ "query": "quarterly board review", "kind": "deck" }

Errors

Error	Cause
`query must not be empty.`	The query was blank

Get Started

Authentication

Guides

Tool Reference

Help

Parameters

What it searches

Response

Example

Errors

​Parameters

​What it searches

​Response

​Example

​Errors

Parameters

What it searches

Response

Example

Errors