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 usecreate-mcp-use-app:
- 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
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
- MCP Inspector UI (server dropdown and “View server info” modal)
- MCP clients that support server metadata
- ChatGPT when using your server as an app
index.ts in your project to customize:
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.
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