myco:mcp-tool-development-lifecycle

Automate MCP tool lifecycle management for schema, handlers, registration, and documentation.

12|2|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/goondocks-co/myco --skill myco-mcp-tool-development-lifecycle
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: myco:mcp-tool-development-lifecycle
Source: https://github.com/goondocks-co/myco/tree/main/.agents/skills/mcp-tool-development-lifecycle
Command: npx skills add https://github.com/goondocks-co/myco --skill myco-mcp-tool-development-lifecycle

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Comprehensive lifecycle for authoring, registering, documenting, and maintaining MCP tools in packages/myco/src/mcp/ — covering schema definition in TOOL_DEFINITIONS arrays, handler implementation with DaemonClient usage, switch-based registration in server.ts, documentation bundling, anti-drift testing patterns, and cloud vs local placement decisions. Essential for maintaining the schema ↔ handler ↔ documentation triad that agents depend on for correct tool invocations, even when the user doesn't explicitly ask for MCP tool development.

Core Features & Use Cases

  • Schema and tool-definition management across local MCP surfaces, including tooling constants and cortex/config metadata.
  • Handler implementation patterns using DaemonClient, strict parameter consumption, and deterministic I/O.
  • Local vs Collective registration and conditional enablement, with tests to verify surface behavior.
  • Documentation bundling at build time to ensure agent-visible docs stay in sync with code.
  • Anti-drift testing patterns to validate alignment between schema, handlers, and docs.
  • Lifecycle discipline for cloud vs local placement decisions to prevent unintended data exposure.

Quick Start

Follow the lifecycle procedures to implement a new MCP tool by editing tool-definitions.ts, creating a handler, registering the tool, and bundling documentation, then run npm run build.

Frequently Asked Questions about myco:mcp-tool-development-lifecycle

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

FAQPage Schema
How do I manage the MCP tool development lifecycle to keep schemas and handlers aligned?

Automating the MCP tool development lifecycle involves enforcing schema definitions, deterministic handler patterns, and documentation bundling to prevent drift. This guarantees agents always have aligned tool invocations by validating the schema-handler-documentation triad during the build process.

What is the best way to prevent documentation drift when building MCP tools?

To prevent documentation drift, bundle agent-visible docs at build time and run anti-drift tests validating schema, handler, and documentation alignment. This catches synchronization errors between tool definitions and server registration before they reach production.

How do I register a new MCP tool in server.ts using a switch-based pattern?

Register an MCP tool in server.ts using a switch-based pattern by mapping tool names to handler implementations. Combine this with TOOL_DEFINITIONS schemas and DaemonClient usage to ensure deterministic I/O across local and collective surfaces.

When should MCP tools be placed in the cloud versus locally?

Choose cloud versus local placement for MCP tools based on data exposure requirements and collective enablement needs. Local placement prevents unintended data exposure, while cloud placement supports broader access when documentation and handler alignment is confirmed.

Do I need DaemonClient to implement deterministic handler patterns for MCP tools?

Yes, deterministic MCP tool handler patterns require DaemonClient to enforce strict parameter consumption. This guarantees deterministic I/O and maintains the schema-handler alignment needed for reliable agent tool invocations across surfaces.

Why does my MCP tool schema drift from its handler implementation?

MCP tool schema drift from handler implementations happens when build-time documentation bundling and anti-drift tests are skipped. Applying lifecycle procedures for schema definitions and server.ts registration prevents this misalignment over time.