Skip to content
cccskills
FreePublished on GitHubEnglish overview

mcp-builder

A deprecated guide to building MCP servers with mcp-use, covering callable actions, data resources, reusable prompts, and interactive widgets. It includes design references and code examples, and directs users to the replacement skill, mcp-app-builder.

OriginalShow the original description

DEPRECATED: This skill has been replaced by `mcp-app-builder`. Check if `mcp-app-builder` is available in the skills folder. If not, install it: `npx skills install mcp-use/mcp-use --skill mcp-app-builder` Use `mcp-app-builder` instead of this skill. Build Model Context Protocol (MCP) servers with mcp-use framework. Use when creating MCP servers, defining tools/resources/prompts, working with mcp-use, bootstrapping MCP projects, or when user mentions MCP development, tools, resources, or prompts.

AI rating80/ 100See how to install

Good for

  • Review the structure of an existing mcp-use server
  • Consult examples of tools, resources, and prompts
  • Explore interactive widget design
  • Check migration guidance for mcp-app-builder

Overview

What it does

mcp-builder is an older guide to building MCP servers with mcp-use, allowing AI to use external actions and data. It explains how to separate callable actions, read-only data, reusable prompts, and interactive interfaces. It also introduces server-side definition examples and helper functions for choosing response formats such as text, JSON, and images.

When it helps

Consult it when reading an existing mcp-use implementation or checking the basic structure of a Tool, Resource, or Prompt. It points to supporting references on design, React TSX Widgets, and URI templates that retrieve data according to supplied arguments. These references cover the areas described by the older guide.

Example requests

  • “Organize this server’s operations into Tools and Resources.”
  • “Show an example of defining reusable wording with server.prompt().”
  • “Check the guidance on moving to mcp-app-builder.”

Notes

This skill is deprecated and explicitly directs users to mcp-app-builder. If the replacement is not installed, the listed command is npx skills install mcp-use/mcp-use --skill mcp-app-builder. Implementation examples use mcp-use and Zod; Widgets assume React TSX.

This overview was written by AI (OpenAI Codex) from the public SKILL.md. Check the original below for the exact behavior.

Objective evaluation

AI rated this skill on four points using only the contents of its SKILL.md. Stars and popularity are not taken into account.

Clear instructionsIs it clear when to use it and what it does?
AGoodIt clearly identifies the MCP features covered and states that the skill is deprecated in favor of its replacement.
Concrete stepsAre steps, inputs, outputs, and examples spelled out?
AGoodCode examples show Tool, Resource, and Prompt inputs and return values, followed by server startup.
SafetyAre sending data, deleting files, and running commands disclosed?
BPartly lackingIt checks for the replacement and installs it if absent, but provides no confirmation step before running the installation.
Easy setupDoes it need few tools or API keys, and are they documented?
BPartly lackingThe replacement installation command is provided, but setup instructions for mcp-use and Zod are absent.

The total counts each point as A = 25, B = 15, C = 5. Rated by AI (OpenAI Codex) as of Oct 20, 2026. Treat it as a guide and read the original before installing.

Disagree? Request a re-evaluation

Tell us which point is wrong and why. No login needed. We will check it against the SKILL.md, redo the evaluation, and show the result here.

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

Files included (12)

  • SKILL.md2.5 KB
  • evals/architecture.json2.1 KB
  • evals/implementation.json1.5 KB
  • evals/README.md460 B
  • evals/skill.json1.9 KB
  • evals/widgets.json1.8 KB
  • LICENSE.txt8.9 KB
  • references/design-and-architecture.md6.1 KB
  • references/resource-templates.md3.3 KB
  • references/response-helpers.md7.2 KB
  • references/tools-and-resources.md7.5 KB
  • references/widgets.md15.1 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

MCP Server Builder

Build production-ready MCP servers with tools, resources, prompts, and interactive widgets using mcp-use.

Before You Code

Decompose user requests into tools, widgets, and resources. Decide what needs UI vs text.

Read design-and-architecture.md: when planning what to build, deciding tool vs widget, or designing UX flows.

Implementation

  • Tools, resources, prompts → tools-and-resources.md: when writing server-side server.tool(), server.resource(), server.prompt() code
  • Visual widgets (React TSX) → widgets.md: when creating interactive UI widgets in resources/ folder
  • Response helper API → response-helpers.md: when choosing how to format tool/resource return values
  • URI template patterns → resource-templates.md: when defining parameterized resources

Quick Reference

import {
  MCPServer,
  text,
  object,
  markdown,
  html,
  image,
  widget,
  error,
} from "mcp-use/server";
import { z } from "zod";

const server = new MCPServer({ name: "my-server", version: "1.0.0" });

// Tool
server.tool(
  {
    name: "my-tool",
    description: "...",
    schema: z.object({ param: z.string().describe("...") }),
  },
  async ({ param }) => text("result"),
);

// Resource
server.resource(
  { uri: "config://settings", name: "Settings", mimeType: "application/json" },
  async () => object({ key: "value" }),
);

// Prompt
server.prompt(
  {
    name: "my-prompt",
    description: "...",
    schema: z.object({ topic: z.string() }),
  },
  async ({ topic }) => text(`Write about ${topic}`),
);

server.listen();

Response helpers: text(), object(), markdown(), html(), image(), audio(), binary(), error(), mix(), widget()

Server methods: server.tool(), server.resource(), server.resourceTemplate(), server.prompt(), server.listen()

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

advisor-orchestrator-worker

FreeSummaryAI rating 80

Coordinate large research or generation tasks across a model team. An orchestrator plans and checks the work, workers execute subtasks in parallel, and an advisor reviews the plan and draft before the results are combined.

  • Research multiple competitors in parallel
  • Split a large generation task across multiple models
  • Have an advisor review plans and drafts
Shubhamsaboo/awesome-llm-apps142.6KUpdated Oct 22, 2026

chatgpt-app-builder

FreeSummaryAI rating 70

Develop ChatGPT apps with interactive React widgets using mcp-use and OpenAI Apps SDK. Guidance covers app scope, server tools, shared state, and display settings. This skill is deprecated and points users to mcp-app-builder.

  • Define the scope of a ChatGPT app
  • Build React widgets connected to server tools
  • Share widget state with ChatGPT
Shubhamsaboo/awesome-llm-apps142.6KUpdated Oct 22, 2026

commit-archaeologist

FreeSummaryAI rating 100

Investigate why a file or function exists using local Git history. Trace its introduction, later edits, authorship, and files often changed alongside it, then summarize likely intent and change risks while distinguishing evidence from inference.

  • Understanding why an unfamiliar function exists
  • Reviewing historical constraints before a refactor
  • Tracing the background of a workaround
Shubhamsaboo/awesome-llm-apps142.6KUpdated Oct 22, 2026

dependency-doctor

FreeSummaryAI rating 100

Inspect Python and JavaScript dependency files for missing version constraints, duplicate entries, conflicting exact versions, and outdated Python compatibility packages. Get plain-language explanations and focused repair suggestions, with offline checks by default.

  • Check dependency files before investigating installation failures
  • Find outdated Python compatibility packages
  • Review duplicate entries and conflicting exact versions
Shubhamsaboo/awesome-llm-apps142.6KUpdated Oct 22, 2026

first-reader

FreeSummaryAI rating 100

Simulate readers encountering a draft for the first time to see whether they open it, where their attention fades, and what they remember. Receive reader comments alongside the text without rewrites or suggested fixes.

  • Check whether a post earns a full read
  • Find where readers lose interest
  • Compare reader reactions after revisions
Shubhamsaboo/awesome-llm-apps142.6KUpdated Oct 22, 2026

mcp-apps-builder

FreeSummaryAI rating 70

Build MCP servers that let AI access actions and data using mcp-use. The guide covers project setup, reusable prompts, interactive React interfaces, authentication, error handling, and deployment, with reference files for each area.

  • Create a new MCP server with mcp-use
  • Add actions, data resources, or reusable prompts
  • Build interactive React interfaces for browsing and selection
Shubhamsaboo/awesome-llm-apps142.6KUpdated Oct 22, 2026

See all skills by Shubhamsaboo

Report a problem with this skill