Overview

supastarter splits the workspace into focused apps and packages. This keeps the public site, product app, API, and AI services separate and easy to navigate.

• apps/saas is the authenticated product app, including the AI Agent chat UI
• apps/api is the API process that owns the embedded agent runtime
• apps/mcp is the standalone MCP Server for external clients
• packages/agent contains the agent runtime, tools, prompts, and skills
• packages/skills contains the shared Agent Skills used by both the agent and MCP

Both AI surfaces use the same shared application tools from packages/api/lib/tools. Those tools always run through your existing oRPC procedures, so the same validation and permissions apply.

Where to go next

• AI Agent setup to enable the in-app chat experience
• MCP Server setup to expose application tools to external MCP clients
• App functionality tools to connect the agent to your product