deferred-tools

Load MCP tool schemas via ToolSearch before invoking deferred tools.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/shellicar/skills --skill deferred-tools
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deferred-tools
Source: https://github.com/shellicar/skills/tree/main/skills/deferred-tools
Command: npx skills add https://github.com/shellicar/skills --skill deferred-tools

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents Zod parse errors and incorrect parameter typing when calling deferred MCP tools by ensuring callers load the tool schema before invocation.

Core Features & Use Cases

  • Always call ToolSearch first to fetch the tool's schema so parameter shapes are known and validated.
  • Ensures arrays and complex objects are passed as native types rather than JSON-encoded strings, avoiding Zod validation failures.
  • Use Case: When an agent or workflow must call an mcp__* tool for the first time, load the schema via ToolSearch then call the tool with correctly typed parameters.

Quick Start

Call ToolSearch to fetch the tool schema, then invoke the deferred tool with correctly typed parameters such as native arrays and objects.

Frequently Asked Questions about deferred-tools

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why do I get Zod parse errors when calling deferred MCP tools?

Zod parse errors occur with deferred MCP tools because the tool schema is not preloaded. You must call ToolSearch first to fetch the schema and ensure parameters are correctly typed as native arrays and objects.

How do I load the schema for a deferred MCP tool before invocation?

To load a deferred MCP tool schema, call ToolSearch to retrieve the parameter shapes before invocation. This ensures you pass native arrays and complex objects instead of JSON-encoded strings to satisfy Zod validation.

When do I need to use ToolSearch for MCP tool integration workflows?

You need to use ToolSearch for MCP tool integration workflows when calling mcp__* tools or any tool listed as deferred where schemas are not preloaded, ensuring parameter shapes are known and validated before invocation.

Does passing JSON-encoded strings instead of native arrays cause Zod validation failures?

Yes, passing JSON-encoded strings instead of native arrays and complex objects causes Zod validation failures. You must load the tool schema via ToolSearch and pass correctly typed native parameters to avoid parse errors.

What is the best way to prevent parameter typing errors in agent workflows using deferred tools?

The best way to prevent parameter typing errors with deferred tools is to always call ToolSearch first to fetch the tool schema, then invoke the tool with correctly typed native arrays and objects to satisfy Zod validation.

Are deferred MCP tool schemas preloaded in agent workflows?

No, deferred MCP tool schemas are not preloaded in agent workflows. You must explicitly call ToolSearch to retrieve the schema before calling mcp__* tools to ensure parameters are correctly typed and validated.