Use this file to discover all available pages before exploring further.
For the complete documentation index, see llms.txt.
The fullstack MCP framework
Build MCP Apps for ChatGPT / Claude and MCP Servers for AI Agents — in TypeScript and Python.
Build with the mcp-use SDK
Preview with the MCP Inspector
Deploy to production in one command
Quickstart
TypeScript
Python
npx create-mcp-use-app@latest
Or create a server manually:
import { MCPServer, text } from "mcp-use/server";import { z } from "zod";const server = new MCPServer({ name: "my-server", version: "1.0.0",});server.tool({ name: "get_weather", description: "Get weather for a city", schema: z.object({ city: z.string() }),}, async ({ city }) => { return text(`Temperature: 72°F, Condition: sunny, City: ${city}`);});await server.listen(3000);// Inspector at http://localhost:3000/inspector
Full TypeScript Server Documentation
pip install mcp-use
from typing import Annotatedfrom mcp.types import ToolAnnotationsfrom pydantic import Fieldfrom mcp_use import MCPServerserver = MCPServer(name="Weather Server", version="1.0.0")@server.tool( name="get_weather", description="Get current weather information for a location", annotations=ToolAnnotations(readOnlyHint=True, openWorldHint=True),)async def get_weather( city: Annotated[str, Field(description="City name")],) -> str: return f"Temperature: 72°F, Condition: sunny, City: {city}"server.run(transport="streamable-http", port=8000)# Inspector at http://localhost:8000/inspector
Full Python Server Documentation
MCP Apps
MCP Apps let you build interactive widgets that work across Claude, ChatGPT, and other MCP clients — write once, run everywhere.
import { MCPServer, widget } from "mcp-use/server";import { z } from "zod";const server = new MCPServer({ name: "weather-app", version: "1.0.0" });server.tool({ name: "get-weather", description: "Get weather for a city", schema: z.object({ city: z.string() }), widget: "weather-display", // references resources/weather-display/widget.tsx}, async ({ city }) => { return widget({ props: { city, temperature: 22, conditions: "Sunny" }, message: `Weather in ${city}: Sunny, 22°C`, });});await server.listen(3000);
Widgets in resources/ are auto-discovered — no manual registration needed.
MCP Apps Guide
Build widgets with React, auto-discovery, and client-side hooks.
ChatGPT Apps Flow
Step-by-step: ship an MCP App to ChatGPT.
Templates
Ready-to-use MCP Apps and Servers you can deploy in one click or remix as your own.
Chart Builder
Natural-language chart generation.
Diagram Builder
Conversational diagramming.
Widget Gallery
Reference patterns for every widget type.
Browse all templates
Full gallery with demo URLs and one-click deploy buttons.
Inspector
Test and debug your MCP servers interactively. The Inspector is auto-included in every server:
server.listen(3000);// Inspector at http://localhost:3000/inspector
