Docs · Quickstart
Install once. Describe your business. Ship in minutes.
SeldonFrame plugs into Claude Code as an MCP server. After install, you describe your business in natural language and Claude orchestrates the workspace creation, block installs, and customization — same flow whether you're in the Claude Code desktop app or the terminal.
Prerequisites
- ✓Claude Code installed and authenticated
- ✓Node.js 18 or newer (Node 20 recommended)
- ✓An Anthropic API key (BYO — SeldonFrame doesn't margin on tokens)
Running in Codespaces, WSL, or SSH remote?
- ·Node version: Codespaces default images sometimes ship Node 16. SeldonFrame requires Node 18+. Run
nvm install 20 && nvm use 20ifnode --versionshows v16 or v17. - ·Claude Code OAuth: the OAuth callback points at
localhost, which your local browser can't reach when Claude Code runs in a remote VM. Use the API key path instead:export ANTHROPIC_API_KEY=sk-ant-... - ·Web-terminal paste: some browser-based terminals block
Ctrl+V. UseCtrl+Shift+Vor right-click → Paste. - ·npm cache 404 after publish:if you ever query a package before it's published, npm caches the 404. After publishing, run
npm cache clean --forceifnpm viewstill 404s.
Add SeldonFrame to Claude Code
The MCP server exposes SeldonFrame's primitive surface inside Claude Code. Pick whichever path is comfortable — both register the same MCP and produce the same result.
Claude Code desktop app
Open Claude Code (download from claude.ai/code if you don't have it), then type:
Add SeldonFrame to my toolsClaude Code reads this as a request to install an MCP server and runs the registration for you. No terminal required.
Terminal
If you prefer the command line, run:
claude mcp add seldonframe -- npx -y @seldonframe/mcp
claudeRequires Node.js 18+ and Claude Code CLI installed. The first command registers the MCP; the second starts a session.
Describe your business
Paste this template into Claude Code (app or terminal — same prompt) and fill in your details:
Create a workspace for my business:
- Business name: [your business name]
- Industry: [hvac, dental, legal, coaching, real-estate, salon, ...]
- Location: [city, state]
- Operating hours: [Mon-Sat 7am-7pm]
- Team size: [number]
- Services offered: [3-5 main ones]
- Website: [URL, optional]Watch Claude build it
Claude Code chains the right tool calls automatically: creates the workspace, installs an industry-matched vertical pack, configures booking availability, seeds your Soul from your website (if provided), and customizes the intake form. Returns live URLs you can share immediately. Your first workspace is free forever.
https://your-business.app.seldonframe.com ← public home
https://your-business.app.seldonframe.com/book ← booking
https://your-business.app.seldonframe.com/intake ← intake form
https://app.seldonframe.com/switch-workspace?... ← admin dashboardWhat's next
- Browse MCP servers → — extend your Business OS with 25+ verified external integrations
- Watch the HVAC walkthrough → — see a complete agency-deployed Business OS built end-to-end
- Read the docs → — primitives reference, API surface, architecture overview
- Star the repo → — open source under MIT