Skip to main content
Prerequisites: - Install Node.js (version 22.22.2 or higher) - npm, pnpm, or Bun package manager

MCP Servers

The fastest way to scaffold a new MCP server project is to use create-mcp-use-app:
This command will:
  • Create a new directory with your project name
  • Initialize a TypeScript project with mcp-use configured
  • Set up a basic MCP server template with example tools
  • Optionally install all dependencies
  • Optionally install skills for agent support
Check out UI Widgets with support to MCP-UI and OpenAI Apps SDK for ChatGPT.

Server Metadata

The generated project includes pre-configured server metadata that is visible in MCP Inspector and MCP clients:
  • Name & Title: Both set to your project name (customizable in index.ts)
  • Instructions: Model-facing guidance for cross-tool workflows and server-wide constraints
  • Icons: mcp-use branding icons included in public/ folder
  • Website URL: Defaults to https://mcp-use.com (customizable)
  • Favicon: Included for browser display
These settings appear in:
  • MCP Inspector UI (server dropdown and “View server info” modal)
  • MCP clients that support server metadata
  • ChatGPT when using your server as an app
Customizing Server Metadata: Open index.ts in your project to customize:
Note: Icon paths (like icon.svg) are resolved from public/ against the incoming request origin. With basePath: "/mcp", for example, icon.svg is served from http://localhost:3000/mcp/_mcp-use/public/icon.svg. In hosted environments, MCP_URL sets the public origin while basePath continues to own the endpoint path.
You can also install mcp-use as a library and build your own MCP server from scratch.
For the local Inspector, run mcp-use dev; to mount it on a production build for internal testing, use mcp-use start --with-inspector. Check out the examples here. Visit the MCP Server documentation for more details.

MCP Agent & Client

Install the client and Agent packages using your preferred package manager:

Next Steps

Agent

Build AI Agents with tool calling capabilities through MCP connections

Client

A full featured MCP Client implementation for TypeScript

Server

The MCP Server framework implementation for TypeScript, with Apps SDK and MCP-UI support
Need Help? Join our Discord or Github communities.