Skip to content

MCP App Builder Guide

Guides an agent through building mcp-use MCP servers, tools, resources, prompts and widgets

Stars
143,726
Licence
Apache-2.0
Files
15 files

What it does

This skill is a navigation guide and reference library that tells an AI agent how to build MCP (Model Context Protocol) servers using the mcp-use framework. Once installed, when you ask the agent to create or change an MCP server, it first checks whether you are in an existing mcp-use project, scaffolds a new one if needed, and then reads the matching reference file for tools, resources, prompts, authentication, deployment or widgets before writing code.

Great for

  • Developers building MCP servers with the mcp-use TypeScript framework
  • Teams adding OAuth authentication (WorkOS, Supabase or custom providers) to an MCP server
  • Anyone who wants an agent to follow consistent patterns when adding tools, resources or interactive widgets

Skip it if

  • People who are not building MCP servers, since the guidance is specific to mcp-use and will not help with other tasks
  • Projects that use a different MCP SDK, because the patterns and APIs target mcp-use specifically
  • Production systems without review, since the agent may follow the reference patterns imperfectly and security-relevant code (auth, tokens, env vars) should be checked by a developer

Try asking

  • “Create a new MCP server with a tool that fetches weather data”
  • “Add OAuth login with WorkOS to my existing mcp-use server”
  • “Add an interactive widget that lets users filter a product list”
  • “Review my MCP server code for security issues”
Step-by-step guide: how to use MCP App Builder GuideInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 15 original files, the Apache-2.0 licence and an attribution note.

    mcp-apps-builder.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip mcp-apps-builder.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip mcp-apps-builder.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Point the agent at an existing mcp-use project directory before asking for changes so it does not scaffold a duplicate project
  • Ask the agent to name the specific reference file it used, so you can confirm it followed the guidance
  • Review any generated auth configuration and environment variable handling before deploying

What's inside

  • LICENSE.txt
  • references/authentication/custom.md
  • references/authentication/overview.md
  • references/authentication/supabase.md
  • references/authentication/workos.md
  • references/foundations/architecture.md
  • references/foundations/concepts.md
  • references/foundations/deployment.md
  • references/foundations/quickstart.md
  • references/patterns/common-patterns.md
  • references/server/prompts.md
  • references/server/resources.md
  • references/server/response-helpers.md
  • references/server/tools.md
  • SKILL.md

Redistributed unmodified from Shubhamsaboo/awesome-llm-apps under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.