Agent skill

MCP Server Builder with mcp-use

Builds, modifies, debugs, migrates and verifies TypeScript MCP servers and MCP Apps with the mcp-use framework, treating the installed package's types as the source of truth.

Apache-2.0Auto-check passedAgent Workflows

Install MCP Server Builder with mcp-use

skills CLI

$ npx skills add mcp-use/mcp-use --skill mcp-builder -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install mcp-use/mcp-use mcp-builder --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/mcp-use/mcp-use.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/mcp-builder .claude/skills/mcp-builder && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "mcp-builder" agent skill from https://github.com/mcp-use/mcp-use/tree/main/skills/mcp-builder into .claude/skills/mcp-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mcp-builder", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/mcp-use/mcp-use/tree/main/skills/mcp-builder

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add mcp-use/mcp-use --skill mcp-builder -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install mcp-use/mcp-use mcp-builder --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/mcp-use/mcp-use.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/mcp-builder .agents/skills/mcp-builder && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "mcp-builder" agent skill from https://github.com/mcp-use/mcp-use/tree/main/skills/mcp-builder into .agents/skills/mcp-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mcp-builder", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add mcp-use/mcp-use --skill mcp-builder -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install mcp-use/mcp-use mcp-builder --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/mcp-use/mcp-use.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/mcp-builder .cursor/skills/mcp-builder && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "mcp-builder" agent skill from https://github.com/mcp-use/mcp-use/tree/main/skills/mcp-builder into .cursor/skills/mcp-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mcp-builder", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/mcp-use/mcp-use.git --path skills/mcp-builder

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add mcp-use/mcp-use --skill mcp-builder -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install mcp-use/mcp-use mcp-builder --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/mcp-use/mcp-use.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/mcp-builder .gemini/skills/mcp-builder && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "mcp-builder" agent skill from https://github.com/mcp-use/mcp-use/tree/main/skills/mcp-builder into .gemini/skills/mcp-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mcp-builder", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install mcp-use/mcp-use mcp-builder

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add mcp-use/mcp-use --skill mcp-builder -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/mcp-use/mcp-use.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/mcp-builder .github/skills/mcp-builder && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "mcp-builder" agent skill from https://github.com/mcp-use/mcp-use/tree/main/skills/mcp-builder into .github/skills/mcp-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mcp-builder", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add mcp-use/mcp-use --skill mcp-builder -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install mcp-use/mcp-use mcp-builder --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/mcp-use/mcp-use.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/mcp-builder .opencode/skills/mcp-builder && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "mcp-builder" agent skill from https://github.com/mcp-use/mcp-use/tree/main/skills/mcp-builder into .opencode/skills/mcp-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mcp-builder", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: mcp-builder
GitHub stars: 11k
Token cost: ~923 tokens
SKILL.md length: 432 words
Files: 9 (incl. references)
Skills in repo: 2
Repo updated: Oct 8, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

Builds, modifies, debugs, migrates and verifies TypeScript MCP servers and MCP Apps with the mcp-use framework, treating the installed package's types as the source of truth.

Works in 5 steps: Inspect package.json, the server entry,… → Scaffold a new stable project with… → Read only the references needed for the… → …
Creating a new MCP server in TypeScript with mcp-use
SKILL.md covers Workflow, Core invariants and Guardrails
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

The agent starts by inspecting `package.json`, the server entry, exported tool refs, `mcp-env.d.ts`, the `views/` and `skills/` folders and the installed `mcp-use` version. New projects are scaffolded with `create-mcp-use-app@latest`, matching the package version or dist-tag on beta, canary or versioned projects. It then reads only the references the task needs: server, views, authentication, skills over MCP, advanced features, migration and verification, and implements against the installed types rather than copied examples.

Core invariants cover imports (`mcp-use`, `mcp-use/react` and `mcp-use/oauth/*`), `inputSchema` for tool arguments and `outputSchema` for structured results and tools bound to a View. Tools return raw MCP result envelopes with matching `structuredContent`, or `isError: true` for expected failures, each View lives in its own folder under `views/` as `view.tsx`, and the server entry is the default export used by `mcp-use dev`, `build` and `start`. Verification runs the smallest real lifecycle first.

When your agent uses it

Creating a new MCP server in TypeScript with mcp-use
Adding an interactive View or MCP App to an existing server
Adding OAuth authentication and scopes to an MCP server
Migrating a server off retired mcp-use APIs

Example prompts

“Scaffold a new mcp-use server with a tool that looks up order status by id.”
“Add an interactive View to the weather tool in my MCP server.”
“Add OAuth to this MCP server and restrict the delete tool to an admin scope.”
“Check this server against the verification checklist before I call it done.”

Requirements

A TypeScript project with the `mcp-use` package installed

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

Inspect package.json, the server entry, exported tool refs, mcp-env.d.ts, views/, skills/, and the installed mcp-use version.
Scaffold a new stable project with create-mcp-use-app@latest and the appropriate template. Match the package version or dist-tag when…
Read only the references needed for the task
Implement against installed types. Prefer the framework's current conventions over copied examples or historical changelogs.
Validate the smallest real lifecycle that proves the changed behavior, then expand checks in proportion to risk.

What it can do on your machine

Read from SKILL.md and the folder at commit 56dbe75. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

MCP Server Builder with mcp-use loads about 923 tokens when it runs, and up to ~6.2k if it reads all its reference files. Until then it costs about 58 tokens; SKILL.md has 432 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~58
When it runs · the whole SKILL.md, loaded when a task matches: ~923
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~6.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from mcp-use/mcp-use at commit 56dbe75, republished under its Apache-2.0 licence (© mcp-use). 432 words, ~923 tokens.

Download SKILL.mdSave it as .claude/skills/mcp-builder/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.

name: mcp-builder
description: Build, modify, debug, migrate, review, or verify TypeScript MCP servers and MCP Apps with mcp-use. Use for tools, resources, prompts, middleware, Views, authentication, Skills over MCP, scaffolding, and advanced features.

Build with mcp-use

Treat the installed mcp-use package, its exported types, generated declarations, and the project's existing code as the source of truth. Inspect the installed version before choosing APIs or changing code.

Workflow

Inspect package.json, the server entry, exported tool refs, mcp-env.d.ts, views/, skills/, and the installed mcp-use version.
Scaffold a new stable project with create-mcp-use-app@latest and the appropriate template. Match the package version or dist-tag when working on beta, canary, or an existing versioned project.
Read only the references needed for the task:
- Server for tools, resources, prompts, MCP middleware, request context, and result envelopes.
- Views for interactive MCP Apps, React hooks, model context, host capabilities, assets, and CSP.
- Authentication for OAuth providers, verified identity, scopes, permissions, and authorization.
- Skills over MCP when a server should ship reusable workflows alongside its tools.
- Advanced features for OpenAPI, proxying, notifications, subscriptions, and elicitation.
- Migration only when retired or compatibility-only imports, helpers, registration shapes, UI patterns, or session assumptions are present.
- Verification before reporting implementation work complete.
Implement against installed types. Prefer the framework's current conventions over copied examples or historical changelogs.
Validate the smallest real lifecycle that proves the changed behavior, then expand checks in proportion to risk.

Show full SKILL.md (229 more words)Show less

Core invariants

Import server APIs from mcp-use, React APIs from mcp-use/react, and OAuth provider adapters from their mcp-use/oauth/* subpaths.
Define tool arguments with inputSchema. Add outputSchema for structured results and every View-bound tool.
Return raw MCP result envelopes. A successful schema-backed tool must include matching structuredContent; an expected failure may return isError: true with model-readable content.
Put each View at views/<name>/view.tsx and bind it with view: { name: "<name>" }.
Export every statically declared tool ref consumed by a View. Default-export the server entry used by mcp-use dev, build, and start.
Keep identity and mutable workflow state request-scoped or in an external store. Treat client-reported metadata as unverified.
Consider Skills over MCP when a server exposes a repeatable, multi-step workflow that would otherwise inflate tool descriptions.

Guardrails

Do not invent exports, configuration fields, or callback shapes. Confirm uncertain details in installed declarations or source.
Do not preserve APIs that are absent from the installed version merely because they appear in an existing project.
Do not return a plain domain object from a tool callback.
Do not bind a View without a matching outputSchema and structuredContent result.
Do not use module globals for cross-request identity, elicitation continuity, or durable business state.
Do not claim success from a source build alone when types, package exports, authentication, or interactive behavior changed.
Do not deploy or mutate external systems unless the user explicitly requests it.

Files

SKILL.md and 8 other files (references) in skills/mcp-builder of mcp-use/mcp-use.

SKILL.md
LICENSE.txt
references/advanced-features.md
references/auth.md
references/migration.md
references/server.md
references/skills-over-mcp.md
references/verification.md
references/views.md

Open the folder on GitHubat commit 56dbe75

Compare with similar skills

MCP Server Builder with mcp-use next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

MCP Server Builder with mcp-use compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
MCP Server Builder with mcp-use this skillmcp-use/mcp-use	11k	—	~923	Automated safety check: Pass	Apache-2.0	today
Copilot SDKintellectronica/agent-skills	295	—	~3.2k	Automated safety check: Pass	CC0-1.0	5 mo ago
Copilot SDKmicrosoft/skills	3.1k	—	~7.1k	Automated safety check: Pass	MIT	2 days ago
MCP Server Builderborghei/Claude-Skills	881	—	~1.9k	Automated safety check: Pass	MIT	yesterday
Chatgpt App Builderalpic-ai/skybridge	2.1k	—	~1k	Automated safety check: Pass	MIT	2 days ago
MCP App Builderalpic-ai/skybridge	2.1k	—	~906	Automated safety check: Pass	MIT	2 days ago

Similar skills

Copilot SDK
intellectronica/agent-skills
This skill helps with GitHub Copilot SDK work across Node.js/TypeScript, Python, Go, .NET, and Java.
295 GitHub stars~3.2k tokensUpdated 5 mo ago
Agent WorkflowsAuto-check passed
Copilot SDK
microsoft/skills
Official
Build applications powered by GitHub Copilot using the Copilot SDK.
3.1k GitHub stars~7.1k tokensUpdated 2 days ago
Agent WorkflowsAuto-check passed
MCP Server Builder
borghei/Claude-Skills
Build MCP (Model Context Protocol) servers with tool definitions, resource providers, prompt templates, and transports.
881 GitHub stars~1.9k tokensUpdated yesterday
Agent WorkflowsAuto-check passed
Chatgpt App Builder
alpic-ai/skybridge
Guide developers through creating and updating ChatGPT plugins.
2.1k GitHub stars~1k tokensUpdated 2 days ago
Agent WorkflowsAuto-check passed
MCP App Builder
alpic-ai/skybridge
Guide developers through creating and updating MCP Apps. An agent skill from alpic-ai/skybridge.
2.1k GitHub stars~906 tokensUpdated 2 days ago
Agent WorkflowsAuto-check passed
Skybridge
alpic-ai/skybridge
Guide developers through creating and updating ChatGPT plugins and MCP Apps.
2.1k GitHub stars~923 tokensUpdated 2 days ago
Agent WorkflowsAuto-check passed

Questions about MCP Server Builder with mcp-use

What does MCP Server Builder with mcp-use do?

Builds, modifies, debugs, migrates and verifies TypeScript MCP servers and MCP Apps with the mcp-use framework, treating the installed package's types as the source of truth. ts`, the `views/` and `skills/` folders and the installed `mcp-use` version. New projects are scaffolded with `create-mcp-use-app@latest`, matching the package version or dist-tag on beta, canary or versioned projects.

When should I use MCP Server Builder with mcp-use?

MCP Server Builder with mcp-use fits situations like: creating a new MCP server in TypeScript with mcp-use; adding an interactive View or MCP App to an existing server; adding OAuth authentication and scopes to an MCP server; migrating a server off retired mcp-use APIs.

How do I install MCP Server Builder with mcp-use in Claude Code?

Run `npx skills add mcp-use/mcp-use --skill mcp-builder -a claude-code`. Or copy the skill folder (skills/mcp-builder in mcp-use/mcp-use) into .claude/skills/mcp-builder in your project. Claude Code loads it when a task matches its description.

How do I install MCP Server Builder with mcp-use in Codex?

Run `npx skills add mcp-use/mcp-use --skill mcp-builder -a codex`. Or copy the skill folder (skills/mcp-builder in mcp-use/mcp-use) into .agents/skills/mcp-builder in your project. Codex loads it when a task matches its description.

Can I use MCP Server Builder with mcp-use in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mcp-use/mcp-use --skill mcp-builder -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mcp-builder, .gemini/skills/mcp-builder, .github/skills/mcp-builder and .opencode/skills/mcp-builder in your project.

What does MCP Server Builder with mcp-use need to run?

SKILL.md names no scripts, command-line tools or credentials: MCP Server Builder with mcp-use is instructions for the agent only. Our summary lists: A TypeScript project with the `mcp-use` package installed.

Does MCP Server Builder with mcp-use access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is MCP Server Builder with mcp-use safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does MCP Server Builder with mcp-use use?

MCP Server Builder with mcp-use is published under the Apache-2.0 licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does MCP Server Builder with mcp-use use?

About 923 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.2k tokens, read only when the agent opens those files.

What are the alternatives to MCP Server Builder with mcp-use?

Skills that share tags, products or a category with MCP Server Builder with mcp-use: Copilot SDK (intellectronica/agent-skills, 295 stars), Copilot SDK (microsoft/skills, 3.1k stars), MCP Server Builder (borghei/Claude-Skills, 881 stars) and Chatgpt App Builder (alpic-ai/skybridge, 2.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains MCP Server Builder with mcp-use?

mcp-use (a GitHub organization) maintains it in mcp-use/mcp-use, which has 10,730 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 8, 2026.

Source: mcp-use/mcp-use on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

MCP Server Builder with mcp-use

Install MCP Server Builder with mcp-use

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Build with mcp-use

Workflow

Core invariants

Guardrails

Files

Compare with similar skills

Similar skills

Copilot SDK

Copilot SDK