{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-ai-mcp/smartsheet/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Smartsheet MCP server toolsets","siteUrl":"https://developers.smartsheet.com","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"smartsheet-mcp-server-toolsets","__idx":0},"children":["Smartsheet MCP server toolsets"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Smartsheet MCP server groups related tools into ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["toolsets"]}," — logical collections of tools that share a common resource domain. Toolsets enable progressive tool loading, so that your AI client only discovers and loads the tools it needs for a given task."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Required plan:"]},"  Business, Enterprise, or Advanced Work Management"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"why-toolsets-matter","__idx":1},"children":["Why toolsets matter"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["AI language models have a limited context window — the maximum amount of text they can process at once. Every tool definition loaded into an AI client consumes tokens from that window."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Without toolsets, the MCP server exposes every tool at once. As the number of tools grows, this creates problems:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Context pressure"]}," — Tool definitions compete with your conversation for space in the context window, leaving less room for the AI to reason about your data."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Decision fatigue"]}," — The more tools available at once, the harder it is for the model to choose the right one, increasing the chance of errors or irrelevant tool calls."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Slower responses"]}," — Processing a large tool list adds latency to every interaction, even when only a handful of tools are relevant."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Toolsets solve these problems by letting the AI client load tools on demand, keeping the active tool set small and focused."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-toolsets-work","__idx":2},"children":["How toolsets work"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Toolset-based tool loading follows a two-step ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["search-then-execute"]}," pattern:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-1-discover-tools-with-search_tools","__idx":3},"children":["Step 1: Discover tools with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search_tools"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the AI client determines it needs tools from a particular domain, it calls the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search_tools"]}," tool with:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["toolset"]}]}," — The name of the toolset to search."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["access_type"]}]}," (optional) — Filter by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["read"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["write"]}," to narrow results further."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search_tools"]}," tool returns a list of tool definitions within that toolset, including each tool's name, description, parameters, and which executor to use."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-2-run-tools-via-the-executor","__idx":4},"children":["Step 2: Run tools via the executor"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Instead of calling tools by name directly, the AI client calls the toolset's ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["executor"]}," — a single entry point for all tools in the group. Each toolset has up to two executors:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Read executor"]}," (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["execute_{toolset}_read"]},") — For read-only operations that retrieve data without modifying it."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Write executor"]}," (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["execute_{toolset}_write"]},") — For operations that create, update, or delete data."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The executor takes:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tool_name"]}]}," — Which tool to run within the toolset."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["arguments"]}]}," — The tool's parameters, passed as a JSON object."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The executor validates the tool name, routes the call to the correct tool, and returns the result — all through a single tool invocation."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"benefits","__idx":5},"children":["Benefits"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"for-ai-clients","__idx":6},"children":["For AI clients"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Reduced context usage"]}," — Only the tools relevant to the current task are loaded into the context window. A conversation about charts doesn't need to carry sheet-editing or portfolio tools."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Better tool selection"]}," — With fewer tools visible at once, the model makes more accurate choices and produces fewer erroneous tool calls."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Faster interactions"]}," — Smaller tool lists mean less processing overhead per turn."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"for-users","__idx":7},"children":["For users"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["More room for conversation"]}," — With less context consumed by tool definitions, you can have longer, more detailed conversations before hitting model limits."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["More reliable results"]}," — Focused tool visibility means the AI is less likely to call the wrong tool or misinterpret parameters."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Consistent experience"]}," — As new tools are added to the server, they're organized into toolsets automatically, so the active context doesn't grow unboundedly."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-content","__idx":8},"children":["Related content"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ai-mcp/smartsheet/mcp-server-tools"},"children":["MCP server tools"]}," — Detailed reference for each tool, tagged with its toolset"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ai-mcp/smartsheet/load-server-side-skills-using-the-get-resource-guide"},"children":["Load server-side skills"]}," — How to load skills that orchestrate multiple tools"]}]}]},"headings":[{"value":"Smartsheet MCP server toolsets","id":"smartsheet-mcp-server-toolsets","depth":1},{"value":"Why toolsets matter","id":"why-toolsets-matter","depth":2},{"value":"How toolsets work","id":"how-toolsets-work","depth":2},{"value":"Step 1: Discover tools with search_tools","id":"step-1-discover-tools-with-search_tools","depth":3},{"value":"Step 2: Run tools via the executor","id":"step-2-run-tools-via-the-executor","depth":3},{"value":"Benefits","id":"benefits","depth":2},{"value":"For AI clients","id":"for-ai-clients","depth":3},{"value":"For users","id":"for-users","depth":3},{"value":"Related content","id":"related-content","depth":2}],"frontmatter":{"seo":{"title":"Smartsheet MCP server toolsets"}},"lastModified":"2026-09-01T12:32:20.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ai-mcp/smartsheet/mcp-server-toolsets","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}