MCP (Model Context Protocol) server that brings deterministic tech stack recommendations to LLM clients like Claude, Cursor, Windsurf, and other MCP-compatible tools. Try it free — 8 tools work without an account, including a daily demo recommendation and MCP project kit. Add to ~/Library/Application Support/Claude/claudedesktopconfig.json (macOS) or %APPDATA%\Claude\claudedesktopconfig.json (Wind
Add this skill
npx mdskills install hoklims/stacksfinder-mcpWell-documented MCP server with 23 tools for tech stack recommendations, audits, and project estimation
1# @stacksfinder/mcp-server23[](https://www.npmjs.com/package/@stacksfinder/mcp-server)4[](https://opensource.org/licenses/MIT)5[](https://registry.modelcontextprotocol.io)6[](https://lobehub.com/fr/mcp/hoklims-stacksfinder-mcp)78MCP (Model Context Protocol) server that brings **deterministic tech stack recommendations** to LLM clients like Claude, Cursor, Windsurf, and other MCP-compatible tools.910**Try it free** — 8 tools work without an account, including a daily demo recommendation and MCP project kit.1112## Quick Start1314### Claude Code (CLI)1516```bash17# macOS/Linux18claude mcp add stacksfinder npx -y @stacksfinder/mcp-server1920# Windows (requires cmd wrapper)21claude mcp add-json stacksfinder '{22 "command": "cmd",23 "args": ["/c", "npx", "-y", "@stacksfinder/mcp-server"],24 "env": {"STACKSFINDER_API_KEY": "sk_live_xxx"}25}'2627# With API key (macOS/Linux)28claude mcp add-json stacksfinder '{29 "command": "npx",30 "args": ["-y", "@stacksfinder/mcp-server"],31 "env": {"STACKSFINDER_API_KEY": "sk_live_xxx"}32}'33```3435### Claude Desktop3637Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):3839**macOS/Linux:**40```json41{42 "mcpServers": {43 "stacksfinder": {44 "command": "npx",45 "args": ["-y", "@stacksfinder/mcp-server"],46 "env": {47 "STACKSFINDER_API_KEY": "sk_live_xxx"48 }49 }50 }51}52```5354**Windows:**55```json56{57 "mcpServers": {58 "stacksfinder": {59 "command": "cmd",60 "args": ["/c", "npx", "-y", "@stacksfinder/mcp-server"],61 "env": {62 "STACKSFINDER_API_KEY": "sk_live_xxx"63 }64 }65 }66}67```6869### Cursor / Windsurf7071Add to `.cursor/mcp.json` or `.windsurf/mcp.json` in your project root:7273**macOS/Linux:**74```json75{76 "mcpServers": {77 "stacksfinder": {78 "command": "npx",79 "args": ["-y", "@stacksfinder/mcp-server"],80 "env": {81 "STACKSFINDER_API_KEY": "sk_live_xxx"82 }83 }84 }85}86```8788**Windows:**89```json90{91 "mcpServers": {92 "stacksfinder": {93 "command": "cmd",94 "args": ["/c", "npx", "-y", "@stacksfinder/mcp-server"],95 "env": {96 "STACKSFINDER_API_KEY": "sk_live_xxx"97 }98 }99 }100}101```102103### VS Code + Copilot104105Add to `.vscode/mcp.json`:106107**macOS/Linux:**108```json109{110 "servers": {111 "stacksfinder": {112 "command": "npx",113 "args": ["-y", "@stacksfinder/mcp-server"],114 "env": {115 "STACKSFINDER_API_KEY": "sk_live_xxx"116 }117 }118 }119}120```121122**Windows:**123```json124{125 "servers": {126 "stacksfinder": {127 "command": "cmd",128 "args": ["/c", "npx", "-y", "@stacksfinder/mcp-server"],129 "env": {130 "STACKSFINDER_API_KEY": "sk_live_xxx"131 }132 }133 }134}135```136137### ChatGPT Developer Mode138139StacksFinder is compatible with **ChatGPT Developer Mode** (available on Pro, Plus, Business, Enterprise, and Education accounts).140141#### Prerequisites142143- ChatGPT Pro, Plus, Business, Enterprise, or Education account144- Developer Mode enabled in ChatGPT settings145- Note: Business/Enterprise workspaces may require admin approval146147#### Setup Steps1481491. **Enable Developer Mode**: Go to Settings → Apps → Advanced settings → toggle "Developer mode"1502. **Create App**: Go to Settings → Apps → Create1513. **Enter details**:152 - **Name**: StacksFinder153 - **URL**: `https://smithery.ai/server/hoklims/stacksfinder-mcp/mcp` (or your self-hosted URL)154 - **Protocol**: Streaming HTTP155 - **Description**: Deterministic tech stack recommendations1564. **Verify**: Click Create and confirm the 23 tools appear157158#### Important Notes159160- **Developer Mode does NOT require search/fetch tools** (those are only for Deep Research)161- Tools with `readOnlyHint: true` won't ask for confirmation in ChatGPT162- Rate limited to 60 requests/minute per IP163- Uses **Streaming HTTP** transport (not SSE)164165#### Supported Protocols166167| Protocol | Status |168|----------|--------|169| Streaming HTTP | ✅ Supported |170| SSE | ❌ Not supported |171172## Available Tools173174### Free Tools (no account required)175176| Tool | Description |177|------|-------------|178| `list_technologies` | List all 80+ tech IDs by category |179| `analyze_tech` | 6-dimension scores, strengths, weaknesses, compatible techs |180| `compare_techs` | Side-by-side comparison of 2-4 technologies |181| `recommend_stack` | **FREE 1x/day** — Full stack recommendation for any project type |182183### Estimator Tools (requires API key)184185| Tool | Description |186|------|-------------|187| `estimate_project` | Estimate scope, pricing, and market analysis for a project |188| `get_estimate_quota` | Check your remaining estimate quota (weekly/monthly) |189190### Pro Tools (requires API key)191192| Tool | Description |193|------|-------------|194| `recommend_stack` | Unlimited recommendations with priorities & constraints |195| `get_blueprint` | Fetch existing blueprint by ID |196| `create_blueprint` | Generate new blueprint with AI narrative |197| `setup_api_key` | Authenticate and create API key from MCP |198| `list_api_keys` | List your API keys |199| `revoke_api_key` | Revoke an API key |200201### Audit Tools (requires API key)202203| Tool | Description |204|------|-------------|205| `create_audit` | Run technical debt audit on your stack |206| `get_audit` | Fetch audit report by ID |207| `list_audits` | List your audit reports |208| `compare_audits` | Compare two audits to track progress |209| `get_audit_quota` | Check your remaining audit quota |210| `get_migration_recommendation` | Analyze audit for migration opportunities with builder constraints |211212### Project Kit Tools (no API key required)213214| Tool | Description |215|------|-------------|216| `generate_mcp_kit` | Generate optimal tech stack + MCP recommendations from project description |217| `analyze_repo_mcps` | Analyze your repository and recommend relevant MCP servers |218| `prepare_mcp_installation` | Detect MCPs, generate `.env-mcp` template for credentials |219| `execute_mcp_installation` | Parse `.env-mcp` and generate IDE install commands |220221Get your API key at [stacksfinder.com/pricing](https://stacksfinder.com/pricing)222223## Tool Examples224225### list_technologies226227```228> list_technologies category="database"229230Available databases:231- postgres (PostgreSQL)232- sqlite (SQLite)233- supabase (Supabase)234- planetscale (PlanetScale)235- turso (Turso)236- neon (Neon)237```238239### analyze_tech240241```242> analyze_tech technology="sveltekit" context="mvp"243244## SvelteKit Analysis (MVP Context)245246| Dimension | Score | Grade |247|-----------|-------|-------|248| Performance | 92 | A |249| DX | 88 | A |250| Ecosystem | 72 | B |251| Maintainability | 85 | A |252| Cost | 90 | A |253| Compliance | 75 | B |254255**Overall: 84/100 (A)**256257Strengths:258- Compiler-first architecture, tiny bundles259- Excellent TypeScript support260- Built-in SSR, SSG, and edge rendering261262Weaknesses:263- Smaller ecosystem than React264- Fewer enterprise case studies265```266267### compare_techs268269```270> compare_techs technologies=["nextjs", "sveltekit", "nuxt"]271272## Comparison: Next.js vs SvelteKit vs Nuxt273274| Tech | Score | Grade |275|------|-------|-------|276| Next.js | 82 | A |277| SvelteKit | 84 | A |278| Nuxt | 79 | B |279280Per-dimension winners:281- Performance: SvelteKit (+10)282- DX: SvelteKit (+3)283- Ecosystem: Next.js (+15)284```285286### recommend_stack (Free Demo)287288```289> recommend_stack projectType="saas" scale="mvp"290291## Recommended Stack for SaaS (MVP)292293| Category | Technology | Score | Grade |294|----------|------------|-------|-------|295| meta-framework | SvelteKit | 84 | A |296| database | Supabase | 82 | A |297| orm | Drizzle | 86 | A |298| auth | Better Auth | 80 | A |299| hosting | Vercel | 85 | A |300| payments | Paddle | 86 | A |301302**Confidence**: medium (demo mode)303304---305Want more? Upgrade to Pro for custom priorities, constraints, and AI narratives.306```307308### create_audit (Pro)309310```311> create_audit name="Q1 2026 Review" technologies=[{name:"react",version:"18.2.0"},{name:"lodash",version:"4.17.20"},{name:"express",version:"4.17.0"}]312313## Audit Report: Q1 2026 Review314315**Health Score: 72/100** (warning)316317| Severity | Count |318|----------|-------|319| [CRITICAL] | 2 |320| [HIGH] | 1 |321| [MEDIUM] | 3 |322| [LOW] | 2 |323| [INFO] | 5 |324325### Critical Findings326327**[CRITICAL] Security vulnerability in lodash** (lodash 4.17.20)328CVE-2021-23337 - Prototype pollution vulnerability329> Upgrade to lodash 4.17.21 or later330331**[CRITICAL] Outdated Express version** (express 4.17.0)332Express 4.17.0 is missing security patches333> Upgrade to express 4.21+ for security fixes334```335336### compare_audits (Pro)337338```339> compare_audits baseAuditId="uuid-jan" compareAuditId="uuid-mar"340341## Audit Comparison342343**Trend: Improving** (+16 health score)344345| Metric | January | March |346|--------|---------|-------|347| Health Score | 62 | 78 |348| Critical | 4 | 1 |349| High | 6 | 3 |350351### Resolved Issues (6)352- [x] Critical: lodash vulnerability353- [x] High: moment.js deprecation354- [x] High: outdated Node version355```356357### estimate_project (Pro)358359```360> estimate_project specs="Build a SaaS project management tool with: user authentication, team workspaces, task boards with drag-and-drop, real-time collaboration, file attachments, Stripe billing integration, and email notifications. Target: small to medium teams." region="france" seniorityLevel="mid"361362## Project Estimate363364**ID**: `est_abc123`365**Confidence**: 85%366**Pricing Table Version**: 2026-01367368### Scope Analysis369370**Total Hours**: 280 - 420h371**Complexity**: high372**Buffer**: 10% (28-42h)373374#### Feature Breakdown375376| Feature | Hours | Complexity |377|---------|-------|------------|378| User Authentication | 16-24h | simple |379| Team Workspaces | 32-48h | medium |380| Task Boards | 48-72h | complex |381| Real-time Collaboration | 40-60h | complex |382| File Attachments | 24-36h | medium |383| Stripe Integration | 32-48h | medium |384| Email Notifications | 16-24h | simple |385386### Pricing (EUR)387388| Seniority | Min | Max |389|-----------|-----|-----|390| junior | 12 000 € | 21 000 € |391| mid | 18 000 € | 33 000 € |392| senior | 28 000 € | 50 400 € |393| expert | 40 000 € | 75 600 € |394395**Adjustments Applied** (×1.15):396- Payment Integration: +5%397- Real-time Features: +10%398```399400### generate_mcp_kit (Free)401402```403> generate_mcp_kit projectDescription="I'm building a SaaS for project management with Supabase and Stripe"404405## Recommended Tech Stack406407| Category | Technology | Score |408|----------|------------|-------|409| meta-framework | SvelteKit | 84 |410| database | Supabase | 82 |411| auth | Supabase Auth | 80 |412| payments | Stripe | 96 |413414## Recommended MCPs415416| MCP | Priority | Why |417|-----|----------|-----|418| supabase-mcp | High | Direct database access |419| stripe-mcp | High | Payment management |420| context7 | Medium | Documentation lookup |421422## Install Configs423424Claude Code:425claude mcp add supabase-mcp npx -y @supabase/mcp-server426```427428### analyze_repo_mcps (Free)429430```431> analyze_repo_mcps432433## Detected Technologies434- **Frontend**: SvelteKit (2.x)435- **Database**: PostgreSQL (via Drizzle)436- **Auth**: Lucia437- **Payments**: Paddle438439## Recommended MCPs440441### High Priority442**Neon MCP** (`@neondatabase/mcp-server`)443- Direct database access and query execution444- _Matched: drizzle, postgresql_445446### Medium Priority447**Context7** (`context7`)448- Up-to-date documentation for any library449- _Matched: universal_450```451452### prepare_mcp_installation (Free)453454```455> prepare_mcp_installation456457✅ Created .env-mcp with 3 MCPs requiring configuration.458459## MCPs to Install460461### 🔴 High Priority462- **Neon MCP** (1 required vars)463- **Paddle MCP** (2 required vars)464465### 🟢 Low Priority466- **Context7** (0 required vars)467468Edit .env-mcp to add your credentials, then run execute_mcp_installation.469```470471### execute_mcp_installation (Free)472473```474> execute_mcp_installation targetClient="claude-code"475476✅ 2 MCPs ready, 1 pending credentials.477478## Claude Code Installation479480Run this command to install all ready MCPs:481482claude mcp add neon-mcp npx -y @neondatabase/mcp-server && \483claude mcp add context7 npx -y context7484485## Post-Installation486- Restart Claude Code to load new MCPs487- Run `claude mcp list` to verify installation488```489490## Environment Variables491492| Variable | Required | Default | Description |493|----------|----------|---------|-------------|494| `STACKSFINDER_API_KEY` | For Pro tools | - | API key from stacksfinder.com |495| `STACKSFINDER_API_URL` | No | `https://stacksfinder.com` | API base URL |496| `STACKSFINDER_MCP_DEBUG` | No | `false` | Enable debug logging |497498## Score Dimensions499500All technology scores are measured across 6 dimensions (0-100):501502| Dimension | Description |503|-----------|-------------|504| **Performance** | Runtime speed, bundle size, optimization potential |505| **DX** | Learning curve, tooling, documentation quality |506| **Ecosystem** | Community size, integrations, job market |507| **Maintainability** | Long-term code health, upgrade path |508| **Cost** | Hosting costs, licensing, operational overhead |509| **Compliance** | Security features, audit readiness |510511## Contexts512513Scores vary by project context:514515- **default**: General-purpose scores516- **mvp**: Optimized for speed-to-market, lower cost517- **enterprise**: Emphasizes compliance, maintainability, support518519## Error Handling520521Structured errors with suggestions:522523```524**Error (TECH_NOT_FOUND)**: Technology "nexjs" not found.525**Suggestions**: nextjs, nuxt, nestjs526```527528## Troubleshooting529530### Debug mode531532```bash533STACKSFINDER_MCP_DEBUG=true npx @stacksfinder/mcp-server534```535536### Common issues537538| Issue | Solution |539|-------|----------|540| "API key required" | Get key at [stacksfinder.com/pricing](https://stacksfinder.com/pricing) |541| "Daily limit reached" | Wait 24h or upgrade to Pro |542| "Technology not found" | Use `list_technologies` to see valid IDs |543544## Development545546```bash547cd packages/mcp-server548bun install549bun run build550bun run dev # Watch mode551bun test # Run tests552```553554## Contributing555556Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) before submitting a Pull Request.557558For security vulnerabilities, please see our [Security Policy](SECURITY.md).559560## Documentation561562- [CHANGELOG.md](CHANGELOG.md) - Version history and release notes563- [CONTRIBUTING.md](CONTRIBUTING.md) - How to contribute564- [SECURITY.md](SECURITY.md) - Security policy and vulnerability reporting565566## Links567568- **Website**: [stacksfinder.com](https://stacksfinder.com)569- **Pricing**: [stacksfinder.com/pricing](https://stacksfinder.com/pricing)570- **MCP Registry**: [registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io) (Official Anthropic)571- **Discord**: [discord.gg/scBHF2EumC](https://discord.gg/scBHF2EumC)572- **Glama**: [glama.ai/mcp/servers/@stacksfinder/mcp-server](https://glama.ai/mcp/servers/@stacksfinder/mcp-server)573- **Smithery**: [smithery.ai/server/hoklims/stacksfinder-mcp](https://smithery.ai/server/hoklims/stacksfinder-mcp)574- **GitHub**: [github.com/hoklims/stacksfinder-mcp](https://github.com/hoklims/stacksfinder-mcp)575- **npm**: [@stacksfinder/mcp-server](https://www.npmjs.com/package/@stacksfinder/mcp-server)576577## Related578579- **CLI**: [create-stacksfinder](https://www.npmjs.com/package/create-stacksfinder) — Scaffold projects from terminal580- **Website**: [stacksfinder.dev](https://stacksfinder.dev) — Full web experience581582## License583584MIT585
Full transparency — inspect the skill content before installing.