Frequently Asked Questions

sunpeak is an MCP App framework and ChatGPT App framework. sunpeak enables developers to quickly build, test, and ship MCP Apps for ChatGPT, Claude, and other AI hosts, all from your local machine. sunpeak provides strongly typed APIs, a ChatGPT App simulator for testing, and production-ready UI components.

You can create a new sunpeak project using the CLI command pnpm add -g sunpeak && sunpeak new. This will scaffold a complete MCP App project with all necessary dependencies, build tools, and testing infrastructure. For existing React projects, you can install sunpeak as a dependency using npm or your preferred package manager.

The MCP (Model Context Protocol) server provides your MCP App content to AI hosts like ChatGPT and Claude. It makes tools, resources, and prompts available that can be used by the AI host. sunpeak includes a built-in MCP server that you can run locally using the sunpeak dev command for testing and development with mock data.

Yes! sunpeak provides an ChatGPT App Simulator — a React component that replicates the ChatGPT and MCP App environment. This allows you to test your app locally before deploying it. You can also use the built-in MCP server with mock data to test your local MCP App in the real ChatGPT.

sunpeak includes production-ready UI components for building MCP Apps. Components follow ChatGPT design guidelines and work across MCP-compatible AI hosts.

sunpeak provides 19+ typed React hooks for interacting with the MCP App runtime. These hooks include host context, theme detection, display modes, tool data, action hooks, and state management. These hooks make it easy to build MCP Apps that work across ChatGPT, Claude, and other AI hosts.

Use the sunpeak build command to create production-ready bundles of your MCP App. The build process is optimized for deployment and includes all necessary optimizations and configurations. Just drop the single file created for each Resource into your production MCP server and you're done.

Yes, sunpeak includes built-in MCP App testing support via Vitest and Playwright. You can run tests using the pnpm test or pnpm test:e2e commands. The framework provides testing utilities and examples to help you write comprehensive tests for your MCP Apps and ChatGPT Apps in all tool, runtime, and conversation states.

MCP Apps are interactive applications built on the Model Context Protocol (MCP) that run inside AI hosts. ChatGPT Apps are MCP Apps that run specifically inside ChatGPT, with some ChatGPT-specific features. Your app UIs are MCP Resources that AI hosts like ChatGPT and Claude render in conversations. sunpeak builds MCP Apps that work across all compatible hosts. Learn more about the MCP App framework or the ChatGPT App framework.

The complete sunpeak documentation is available at docs.sunpeak.ai. It includes quickstart guides, API references, integration instructions, and deployment guides to help you build MCP Apps and ChatGPT Apps.

Yes! sunpeak is open source and available on GitHub at github.com/sunpeak-AI/sunpeak. You can also find the package on npm at npmjs.com/package/sunpeak.

After installing globally with pnpm add -g sunpeak, sunpeak provides several CLI commands: sunpeak new for creating MCP App projects, sunpeak dev for running the development server (web and mcp), sunpeak build for production builds, and sunpeak login / push / pull for interacting with the sunpeak Resource Repository.