ts-agent-sdk

Generate typed TypeScript SDKs for MCP servers from Zod schemas.

961|99|Updated Oct 20, 2025
One-click install
npx skills add https://github.com/jezweb/claude-skills --skill ts-agent-sdk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ts-agent-sdk
Source: https://github.com/jezweb/claude-skills/tree/main/skills/ts-agent-sdk
Command: npx skills add https://github.com/jezweb/claude-skills --skill ts-agent-sdk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill eliminates the complexity of manually crafting verbose JSON-RPC curl commands for MCP servers, replacing them with intuitive typed function calls that boost developer productivity.

Core Features & Use Cases

  • Auto-detection: Automatically scans your project for MCP server modules and their tool definitions.
  • Type Safety: Converts Zod schemas to TypeScript interfaces for compile-time validation.
  • Use Case: Imagine you're building an AI agent that needs to interact with multiple MCP servers. Use this Skill to generate fully typed SDK clients that let you call docs.createDocument() instead of writing complex curl commands with error-prone JSON formatting.

Quick Start

Generate a TypeScript SDK for the MCP servers in this project's src/server/modules/mcp*/ directories.

Frequently Asked Questions about ts-agent-sdk

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

FAQPage Schema
How do I generate a TypeScript SDK for MCP servers?

Generate a TypeScript SDK by running this Skill on your project's src/server/modules/mcp*/ directories. It auto-detects MCP server modules, extracts tool definitions, and produces typed interfaces and client modules under scripts/sdk/, replacing manual JSON-RPC calls with clean function calls.

Can I convert Zod schemas to TypeScript interfaces automatically?

Yes. This Skill transforms Zod schemas into TypeScript interfaces during SDK generation, providing compile-time type validation and eliminating manual interface writing for MCP tool definitions.

What does the generated SDK structure look like?

The generated SDK delivers a consistent output structure: types.ts for TypeScript interfaces, client.ts for typed module clients, and index.ts for exports, plus runnable example scripts that demonstrate calling MCP tools programmatically.

Do I need to rerun the SDK generation when MCP tools change?

Yes. The Skill includes a regeneration workflow: when you add, modify, or remove MCP tool definitions, rerun the Skill to update your SDK and keep types synchronized with your server modules.

What's the advantage of typed SDK clients over JSON-RPC curl commands?

Typed SDK clients replace error-prone manual JSON formatting with intuitive function calls like `docs.createDocument()`, reduce bugs through compile-time validation, and boost developer productivity when building AI agents that interact with multiple MCP servers.

Can this Skill work with multiple MCP servers in one project?

Yes. The Skill auto-detects all MCP server modules in src/server/modules/mcp*/ and generates a typed client per tool, allowing you to interact with multiple MCP servers through a unified, strongly-typed interface.