add-mcp-primitive

masseater's avatarfrom masseater

Add new MCP primitives (Tool, Resource, Prompt). Use when asked to add a new tool, resource, or prompt to the MCP server.

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 6, 2026
[Developer Tools]

When & Why to Use This Skill

This Claude skill streamlines the development of Model Context Protocol (MCP) servers by automating the creation and registration of core primitives: Tools, Resources, and Prompts. It significantly enhances developer productivity by generating boilerplate code, defining schemas with Zod, and ensuring proper architectural alignment within the MCP ecosystem.

Use Cases

  • Extending MCP Server Capabilities: Quickly add new functional tools to an existing MCP server by generating the necessary feature files and registration logic automatically.
  • Data Resource Integration: Simplify the process of exposing new data sources or URIs to AI agents by automating the creation of resource handlers and definitions.
  • Standardized Prompt Engineering: Rapidly package complex prompts with structured argument schemas, making them reusable and easily discoverable by the AI agent.
  • Boilerplate Reduction: Eliminate repetitive manual coding tasks when scaling agentic infrastructure, reducing the risk of registration errors and maintaining code consistency.
nameadd-mcp-primitive
descriptionAdd new MCP primitives (Tool, Resource, Prompt). Use when asked to add a new tool, resource, or prompt to the MCP server.

Adding MCP Primitives

Tool

  1. Create feature in src/features/<name>/<name>.ts
  2. Create definition in src/definitions/tools/<name>.ts
  3. Register in src/definitions/tools/index.ts
// src/definitions/tools/my-tool.ts
import { defineTool } from "@/definitions/define.ts";
import { z } from "zod";

export const myTool = defineTool({
  name: "my-tool",
  title: "My Tool",
  description: "What this tool does",
  inputSchema: {
    param: z.string().describe("Parameter description"),
  },
  handler: async ({ param }) => ({
    content: [{ type: "text", text: "Result" }],
  }),
});

Resource

  1. Create definition in src/definitions/resources/<name>.ts
  2. Register in src/definitions/resources/index.ts
// src/definitions/resources/my-resource.ts
import { defineResource } from "@/definitions/define.ts";

export const myResource = defineResource({
  name: "my-resource",
  uri: "my-resource://path",
  title: "My Resource",
  description: "What this resource provides",
  mimeType: "text/plain",
  handler: async (uri) => ({
    contents: [{ uri: uri.href, mimeType: "text/plain", text: "Content" }],
  }),
});

Prompt

  1. Create definition in src/definitions/prompts/<name>.ts
  2. Register in src/definitions/prompts/index.ts
// src/definitions/prompts/my-prompt.ts
import { definePrompt } from "@/definitions/define.ts";
import { z } from "zod";

export const myPrompt = definePrompt({
  name: "my-prompt",
  title: "My Prompt",
  description: "What this prompt does",
  argsSchema: {
    topic: z.string().describe("Topic to discuss"),
  },
  handler: ({ topic }) => ({
    messages: [
      { role: "user", content: { type: "text", text: `Discuss ${topic}` } },
    ],
  }),
});