mcp-use

→ Full TypeScript Server Documentation

MCP Apps

MCP Apps let you build interactive widgets that work across Claude, ChatGPT, and other MCP clients — write once, run everywhere.

Server: define a tool and point it to a widget:

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);

Widget: create a React component in resources/weather-display/widget.tsx:

import { useWidget, type WidgetMetadata } from "mcp-use/react";
import { z } from "zod";

const propSchema = z.object({
  city: z.string(),
  temperature: z.number(),
  conditions: z.string(),
});

export const widgetMetadata: WidgetMetadata = {
  description: "Display weather information",
  props: propSchema,
};

const WeatherDisplay: React.FC = () => {
  const { props, isPending, theme } = useWidget<z.infer<typeof propSchema>>();
  const isDark = theme === "dark";

  if (isPending) return <div>Loading...</div>;

  return (
    <div style={{
      background: isDark ? "#1a1a2e" : "#f0f4ff",
      borderRadius: 16, padding: 24,
    }}>
      <h2>{props.city}</h2>
      <p>{props.temperature}° — {props.conditions}</p>
    </div>
  );
};

export default WeatherDisplay;

Widgets in resources/ are auto-discovered — no manual registration needed.

Visit MCP Apps Documentation

Templates

Ready-to-use MCP Apps you can deploy in one click or remix as your own.

| Preview | Name | Tools | Demo URL | Repo | Deploy | | --- | --- | --- | --- | --- | --- | | | Chart Builder | create-chart | Open URL | mcp-use/mcp-chart-builder | | | | Diagram Builder | create-diagram, edit-diagram | Open URL | mcp-use/mcp-diagram-builder | | | | Slide Deck | create-slides, edit-slide | Open URL | mcp-use/mcp-slide-deck | | | | Maps Explorer | show-map, get-place-details, add-markers | Open URL | mcp-use/mcp-maps-explorer | | | | Hugging Face Spaces | search-spaces, show-space, trending-spaces | Open URL | mcp-use/mcp-huggingface-spaces | | | | Recipe Finder | search-recipes, get-recipe, meal-plan, recipe-suggestion | Open URL | mcp-use/mcp-recipe-finder | | | | Widget Gallery | show-react-widget, html-greeting, mcp-ui-poll, programmatic-counter, detect-client | Open URL | mcp-use/mcp-widget-gallery | | | ![Multi Server Hub](https://raw.githubusercontent.com/mcp-use/mcp-multi-server-hub/main/repo-assets/de