shipstack-mcp
v1.0.0
Published
Full-stack project scaffolder MCP server
Readme
Ship your SaaS in minutes, not weeks. Scaffold full-stack projects with framework, database, auth, and API routes — through one MCP interface.
Quick Start · Tools · Pro Features · Security · Architecture
See it in action
Agent "Create a new Next.js SaaS project with TypeScript"
ShipStack init_project({
name: "my-saas",
framework: "nextjs",
typescript: true,
package_manager: "npm"
})
Result:
Created my-saas/package.json
Created my-saas/tsconfig.json
Created my-saas/src/app/page.tsx
Created my-saas/src/app/layout.tsx
Created my-saas/.shipstack.json
Project scaffolded in 12ms Agent "Add PostgreSQL with Prisma ORM"
ShipStack add_database({
project_path: "./my-saas",
database: "postgresql",
orm: "prisma"
})
Result:
Created my-saas/prisma/schema.prisma
Created my-saas/src/lib/db.ts
Updated my-saas/package.json (+2 deps)
Updated my-saas/.shipstack.json
Database layer ready — run npx prisma generate Agent "Add JWT auth with login and registration"
ShipStack add_auth({
project_path: "./my-saas",
provider: "jwt",
features: ["login", "register", "forgot-password"]
})
Result:
Created my-saas/src/lib/auth.ts
Created my-saas/src/app/api/auth/login/route.ts
Created my-saas/src/app/api/auth/register/route.ts
Created my-saas/src/app/api/auth/forgot-password/route.ts
Updated my-saas/package.json (+1 dep)
Auth layer ready — 3 routes registeredArchitecture
graph LR
A["AI Agent<br/>(Claude, Cursor, Windsurf)"] -->|MCP Protocol| B["ShipStack MCP"]
B --> C["Next.js Project"]
B --> D["Express Project"]
B --> E["Fastify Project"]
B --> F["Database Layer<br/>(Prisma / Drizzle / Knex)"]
B --> G["Auth Layer<br/>(JWT / Session / OAuth)"]
style A fill:#1f2937,stroke:#3fb950,color:#f0f6fc
style B fill:#0d1117,stroke:#3fb950,stroke-width:2px,color:#3fb950
style C fill:#161b22,stroke:#3fb950,color:#f0f6fc
style D fill:#161b22,stroke:#3fb950,color:#f0f6fc
style E fill:#161b22,stroke:#3fb950,color:#f0f6fc
style F fill:#161b22,stroke:#30363d,color:#8b949e
style G fill:#161b22,stroke:#30363d,color:#8b949eQuick Start
npx shipstack-mcpAdd to your claude_desktop_config.json:
- macOS / Linux:
~/.config/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"shipstack": {
"command": "npx",
"args": ["shipstack-mcp"]
}
}
}Add to .cursor/rules/mcp_servers.json in your project root:
{
"mcpServers": {
"shipstack": {
"command": "npx",
"args": ["shipstack-mcp"]
}
}
}Open settings (Cmd+Shift+P / Ctrl+Shift+P then search "MCP") and add:
{
"mcpServers": {
"shipstack": {
"command": "npx",
"args": ["shipstack-mcp"]
}
}
}Set the PRO_LICENSE environment variable to unlock premium tools:
{
"mcpServers": {
"shipstack": {
"command": "npx",
"args": ["shipstack-mcp"],
"env": {
"PRO_LICENSE": "your-license-key"
}
}
}
}Or from the command line:
PRO_LICENSE=your-license-key npx shipstack-mcpTools
Free Tools (6)
| Tool | Description |
|:-----|:------------|
| init_project | Scaffold a new full-stack project — choose framework (Next.js, Express, Fastify), TypeScript, and package manager |
| add_database | Add a database layer to an existing project — PostgreSQL, MySQL, or SQLite with Prisma, Drizzle, or Knex |
| add_auth | Add authentication — JWT, session, or OAuth with login, register, and forgot-password routes |
| add_api_routes | Generate CRUD API routes for a resource with typed fields and Zod validation |
| add_env_config | Generate .env and .env.example files with service-specific variable templates |
| project_status | Inspect a scaffolded project — view installed features, dependencies, and next-step suggestions |
Pro Features (6)
| Tool | Description |
|:-----|:------------|
| add_deployment | Generate deployment configs for Vercel, Railway, Docker, or Fly.io — tailored to your framework |
| add_email | Add a transactional email layer — Resend, SendGrid, or Nodemailer with ready-to-use templates |
| add_monitoring | Integrate error tracking and analytics — Sentry, PostHog, or a custom provider |
| add_payments | Scaffold a Stripe payment integration — one-time, subscriptions, or both — with webhook handlers |
| add_testing | Set up a full test suite — Vitest or Jest, with unit, integration, and e2e test scaffolding |
| generate_readme | Generate a polished README for your scaffolded project based on its ShipStack manifest |
Feature Comparison
Framework Support
Database & ORM Support
Security
ShipStack MCP writes only to the target project directory you specify.
| Principle | Details |
|:----------|:--------|
| Local file writes only | All tools write to the project path you provide — nothing is sent externally |
| No credential storage | ShipStack never reads or stores database credentials — env vars are written as templates |
| Idempotent by design | Files are only created if they don't already exist — no accidental overwrites |
| No telemetry | Zero analytics, zero phone-home. Your project structure stays local |
| Manifest-gated | All tools require a valid .shipstack.json manifest — preventing writes outside scaffolded projects |
Best Practices
# Always specify an explicit project path
add_database({ project_path: "./my-saas", database: "postgresql", orm: "prisma" })
# Use environment variables — never hardcode credentials in templates
# ShipStack generates .env.example with placeholder values, not real secrets
# Review generated files before running install
cat my-saas/package.json
npm installPro License
Unlock deployment configs, email, monitoring, payments, test scaffolding, and README generation.
Get your license:
# Activate
export PRO_LICENSE=your-license-key
npx shipstack-mcp
# Or inline
PRO_LICENSE=your-license-key npx shipstack-mcpBuilt by Craftpipe — AI-powered developer tools
MIT License © 2026 Craftpipe (Heijnes Digital)
