@stacksfinder/mcp-server

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.

# Quick Start

# # Claude Code (CLI)

#  macOS/Linux
claude mcp add stacksfinder npx -y @stacksfinder/mcp-server

#  Windows (requires cmd wrapper)
claude mcp add-json stacksfinder '{
  "command": "cmd",
  "args": ["/c", "npx", "-y", "@stacksfinder/mcp-server"],
  "env": {"STACKSFINDER_API_KEY": "sk_live_xxx"}
}'

#  With API key (macOS/Linux)
claude mcp add-json stacksfinder '{
  "command": "npx",
  "args": ["-y", "@stacksfinder/mcp-server"],
  "env": {"STACKSFINDER_API_KEY": "sk_live_xxx"}
}'

# # Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

macOS/Linux:

{
  "mcpServers": {
    "stacksfinder": {
      "command": "npx",
      "args": ["-y", "@stacksfinder/mcp-server"],
      "env": {
        "STACKSFINDER_API_KEY": "sk_live_xxx"
      }
    }
  }
}

Windows:

{
  "mcpServers": {
    "stacksfinder": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@stacksfinder/mcp-server"],
      "env": {
        "STACKSFINDER_API_KEY": "sk_live_xxx"
      }
    }
  }
}

# # Cursor / Windsurf

Add to .cursor/mcp.json or .windsurf/mcp.json in your project root:

macOS/Linux:

{
  "mcpServers": {
    "stacksfinder": {
      "command": "npx",
      "args": ["-y", "@stacksfinder/mcp-server"],
      "env": {
        "STACKSFINDER_API_KEY": "sk_live_xxx"
      }
    }
  }
}

Windows:

{
  "mcpServers": {
    "stacksfinder": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@stacksfinder/mcp-server"],
      "env": {
        "STACKSFINDER_API_KEY": "sk_live_xxx"
      }
    }
  }
}

# # VS Code + Copilot

Add to .vscode/mcp.json:

macOS/Linux:

{
  "servers": {
    "stacksfinder": {
      "command": "npx",
      "args": ["-y", "@stacksfinder/mcp-server"],
      "env": {
        "STACKSFINDER_API_KEY": "sk_live_xxx"
      }
    }
  }
}

Windows:

{
  "servers": {
    "stacksfinder": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@stacksfinder/mcp-server"],
      "env": {
        "STACKSFINDER_API_KEY": "sk_live_xxx"
      }
    }
  }
}

# # ChatGPT Developer Mode

StacksFinder is compatible with ChatGPT Developer Mode (available on Pro, Plus, Business, Enterprise, and Education accounts).

# # # Prerequisites

• ChatGPT Pro, Plus, Business, Enterprise, or Education account
• Developer Mode enabled in ChatGPT settings
• Note: Business/Enterprise workspaces may require admin approval

# # # Setup Steps

1. Enable Developer Mode: Go to Settings → Apps → Advanced settings → toggle "Developer mode"
2. Create App: Go to Settings → Apps → Create
3. Enter details:
   • Name: StacksFinder
   • URL: https://smithery.ai/server/hoklims/stacksfinder-mcp/mcp (or your self-hosted URL)
   • Protocol: Streaming HTTP
   • Description: Deterministic tech stack recommendations
4. Verify: Click Create and confirm the 23 tools appear

# # # Important Notes

• Developer Mode does NOT require search/fetch tools (those are only for Deep Research)
• Tools with readOnlyHint: true won't ask for confirmation in ChatGPT
• Rate limited to 60 requests/minute per IP
• Uses Streaming HTTP transport (not SSE)

# # # Supported Protocols

| Protocol | Status |
|- -- -- -- -- -|- -- -- -- -|
| Streaming HTTP | ✅ Supported |
| SSE | ❌ Not supported |

# Available Tools

# # Free Tools (no account required)

| Tool | Description |
|- -- -- -|- -- -- -- -- -- --|
| list_technologies | List all 80+ tech IDs by category |
| analyze_tech | 6-dimension scores, strengths, weaknesses, compatible techs |
| compare_techs | Side-by-side comparison of 2-4 technologies |
| recommend_stack | FREE 1x/day — Full stack recommendation for any project type |

# # Estimator Tools (requires API key)

| Tool | Description |
|- -- -- -|- -- -- -- -- -- --|
| estimate_project | Estimate scope, pricing, and market analysis for a project |
| get_estimate_quota | Check your remaining estimate quota (weekly/monthly) |

# # Pro Tools (requires API key)

| Tool | Description |
|- -- -- -|- -- -- -- -- -- --|
| recommend_stack | Unlimited recommendations with priorities & constraints |
| get_blueprint | Fetch existing blueprint by ID |
| create_blueprint | Generate new blueprint with AI narrative |
| setup_api_key | Authenticate and create API key from MCP |
| list_api_keys | List your API keys |
| revoke_api_key | Revoke an API key |

# # Audit Tools (requires API key)

| Tool | Description |
|- -- -- -|- -- -- -- -- -- --|
| create_audit | Run technical debt audit on your stack |
| get_audit | Fetch audit report by ID |
| list_audits | List your audit reports |
| compare_audits | Compare two audits to track progress |
| get_audit_quota | Check your remaining audit quota |
| get_migration_recommendation | Analyze audit for migration opportunities with builder constraints |

# # Project Kit Tools (no API key required)

| Tool | Description |
|- -- -- -|- -- -- -- -- -- --|
| generate_mcp_kit | Generate optimal tech stack + MCP recommendations from project description |
| analyze_repo_mcps | Analyze your repository and recommend relevant MCP servers |
| prepare_mcp_installation | Detect MCPs, generate .env-mcp template for credentials |
| execute_mcp_installation | Parse .env-mcp and generate IDE install commands |

Get your API key at stacksfinder.com/pricing

# Tool Examples

# # list_technologies

> list_technologies category="database"

Available databases:
- postgres (PostgreSQL)
- sqlite (SQLite)
- supabase (Supabase)
- planetscale (PlanetScale)
- turso (Turso)
- neon (Neon)

# # analyze_tech

> analyze_tech technology="sveltekit" context="mvp"

# #  SvelteKit Analysis (MVP Context)

| Dimension | Score | Grade |
|- -- -- -- -- --|- -- -- --|- -- -- --|
| Performance | 92 | A |
| DX | 88 | A |
| Ecosystem | 72 | B |
| Maintainability | 85 | A |
| Cost | 90 | A |
| Compliance | 75 | B |

**Overall: 84/100 (A)**

Strengths:
- Compiler-first architecture, tiny bundles
- Excellent TypeScript support
- Built-in SSR, SSG, and edge rendering

Weaknesses:
- Smaller ecosystem than React
- Fewer enterprise case studies

# # compare_techs

> compare_techs technologies=["nextjs", "sveltekit", "nuxt"]

# #  Comparison: Next.js vs SvelteKit vs Nuxt

| Tech | Score | Grade |
|- -- -- -|- -- -- --|- -- -- --|
| Next.js | 82 | A |
| SvelteKit | 84 | A |
| Nuxt | 79 | B |

Per-dimension winners:
- Performance: SvelteKit (+10)
- DX: SvelteKit (+3)
- Ecosystem: Next.js (+15)

# # recommend_stack (Free Demo)

> recommend_stack projectType="saas" scale="mvp"

# #  Recommended Stack for SaaS (MVP)

| Category | Technology | Score | Grade |
|- -- -- -- -- -|- -- -- -- -- -- -|- -- -- --|- -- -- --|
| meta-framework | SvelteKit | 84 | A |
| database | Supabase | 82 | A |
| orm | Drizzle | 86 | A |
| auth | Better Auth | 80 | A |
| hosting | Vercel | 85 | A |
| payments | Paddle | 86 | A |

**Confidence**: medium (demo mode)

- --
Want more? Upgrade to Pro for custom priorities, constraints, and AI narratives.

# # create_audit (Pro)

> 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"}]

# #  Audit Report: Q1 2026 Review

**Health Score: 72/100** (warning)

| Severity | Count |
|- -- -- -- -- -|- -- -- --|
| [CRITICAL] | 2 |
| [HIGH] | 1 |
| [MEDIUM] | 3 |
| [LOW] | 2 |
| [INFO] | 5 |

# # #  Critical Findings

**[CRITICAL] Security vulnerability in lodash** (lodash 4.17.20)
CVE-2021-23337 - Prototype pollution vulnerability
> Upgrade to lodash 4.17.21 or later

**[CRITICAL] Outdated Express version** (express 4.17.0)
Express 4.17.0 is missing security patches
> Upgrade to express 4.21+ for security fixes

# # compare_audits (Pro)

> compare_audits baseAuditId="uuid-jan" compareAuditId="uuid-mar"

# #  Audit Comparison

**Trend: Improving** (+16 health score)

| Metric | January | March |
|- -- -- -- -|- -- -- -- --|- -- -- --|
| Health Score | 62 | 78 |
| Critical | 4 | 1 |
| High | 6 | 3 |

# # #  Resolved Issues (6)
- [x] Critical: lodash vulnerability
- [x] High: moment.js deprecation
- [x] High: outdated Node version

# # estimate_project (Pro)

> 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"

# #  Project Estimate

**ID**: `est_abc123`
**Confidence**: 85%
**Pricing Table Version**: 2026-01

# # #  Scope Analysis

**Total Hours**: 280 - 420h
**Complexity**: high
**Buffer**: 10% (28-42h)

# # # #  Feature Breakdown

| Feature | Hours | Complexity |
|- -- -- -- --|- -- -- --|- -- -- -- -- -- -|
| User Authentication | 16-24h | simple |
| Team Workspaces | 32-48h | medium |
| Task Boards | 48-72h | complex |
| Real-time Collaboration | 40-60h | complex |
| File Attachments | 24-36h | medium |
| Stripe Integration | 32-48h | medium |
| Email Notifications | 16-24h | simple |

# # #  Pricing (EUR)

| Seniority | Min | Max |
|- -- -- -- -- --|- -- --|- -- --|
| junior | 12 000 € | 21 000 € |
| mid | 18 000 € | 33 000 € |
| senior | 28 000 € | 50 400 € |
| expert | 40 000 € | 75 600 € |

**Adjustments Applied** (×1.15):
- Payment Integration: +5%
- Real-time Features: +10%

# # generate_mcp_kit (Free)

> generate_mcp_kit projectDescription="I'm building a SaaS for project management with Supabase and Stripe"

# #  Recommended Tech Stack

| Category | Technology | Score |
|- -- -- -- -- -|- -- -- -- -- -- -|- -- -- --|
| meta-framework | SvelteKit | 84 |
| database | Supabase | 82 |
| auth | Supabase Auth | 80 |
| payments | Stripe | 96 |

# #  Recommended MCPs

| MCP | Priority | Why |
|- -- --|- -- -- -- -- -|- -- --|
| supabase-mcp | High | Direct database access |
| stripe-mcp | High | Payment management |
| context7 | Medium | Documentation lookup |

# #  Install Configs

Claude Code:
claude mcp add supabase-mcp npx -y @supabase/mcp-server

# # analyze_repo_mcps (Free)

> analyze_repo_mcps

# #  Detected Technologies
- **Frontend**: SvelteKit (2.x)
- **Database**: PostgreSQL (via Drizzle)
- **Auth**: Lucia
- **Payments**: Paddle

# #  Recommended MCPs

# # #  High Priority
**Neon MCP** (`@neondatabase/mcp-server`)
- Direct database access and query execution
- _Matched: drizzle, postgresql_

# # #  Medium Priority
**Context7** (`context7`)
- Up-to-date documentation for any library
- _Matched: universal_

# # prepare_mcp_installation (Free)

> prepare_mcp_installation

✅ Created .env-mcp with 3 MCPs requiring configuration.

# #  MCPs to Install

# # #  🔴 High Priority
- **Neon MCP** (1 required vars)
- **Paddle MCP** (2 required vars)

# # #  🟢 Low Priority
- **Context7** (0 required vars)

Edit .env-mcp to add your credentials, then run execute_mcp_installation.

# # execute_mcp_installation (Free)

> execute_mcp_installation targetClient="claude-code"

✅ 2 MCPs ready, 1 pending credentials.

# #  Claude Code Installation

Run this command to install all ready MCPs:

claude mcp add neon-mcp npx -y @neondatabase/mcp-server && \
claude mcp add context7 npx -y context7

# #  Post-Installation
- Restart Claude Code to load new MCPs
- Run `claude mcp list` to verify installation

# Environment Variables

| Variable | Required | Default | Description |
|- -- -- -- -- -|- -- -- -- -- -|- -- -- -- --|- -- -- -- -- -- --|
| STACKSFINDER_API_KEY | For Pro tools | - | API key from stacksfinder.com |
| STACKSFINDER_API_URL | No | https://stacksfinder.com | API base URL |
| STACKSFINDER_MCP_DEBUG | No | false | Enable debug logging |

# Score Dimensions

All technology scores are measured across 6 dimensions (0-100):

| Dimension | Description |
|- -- -- -- -- --|- -- -- -- -- -- --|
| Performance | Runtime speed, bundle size, optimization potential |
| DX | Learning curve, tooling, documentation quality |
| Ecosystem | Community size, integrations, job market |
| Maintainability | Long-term code health, upgrade path |
| Cost | Hosting costs, licensing, operational overhead |
| Compliance | Security features, audit readiness |

# Contexts

Scores vary by project context:

• default: General-purpose scores
• mvp: Optimized for speed-to-market, lower cost
• enterprise: Emphasizes compliance, maintainability, support

# Error Handling

Structured errors with suggestions:

**Error (TECH_NOT_FOUND)**: Technology "nexjs" not found.
**Suggestions**: nextjs, nuxt, nestjs

# Troubleshooting

# # Debug mode

STACKSFINDER_MCP_DEBUG=true npx @stacksfinder/mcp-server

# # Common issues

| Issue | Solution |
|- -- -- --|- -- -- -- -- -|
| "API key required" | Get key at stacksfinder.com/pricing |
| "Daily limit reached" | Wait 24h or upgrade to Pro |
| "Technology not found" | Use list_technologies to see valid IDs |

# Development

cd packages/mcp-server
bun install
bun run build
bun run dev      #  Watch mode
bun test         #  Run tests

# Contributing

Contributions are welcome! Please read our Contributing Guide before submitting a Pull Request.

For security vulnerabilities, please see our Security Policy.

# Documentation

• CHANGELOG.md - Version history and release notes
• CONTRIBUTING.md - How to contribute
• SECURITY.md - Security policy and vulnerability reporting

# Links

• Website: stacksfinder.com
• Pricing: stacksfinder.com/pricing
• MCP Registry: registry.modelcontextprotocol.io (Official Anthropic)
• Discord: discord.gg/scBHF2EumC
• Glama: glama.ai/mcp/servers/@stacksfinder/mcp-server
• Smithery: smithery.ai/server/hoklims/stacksfinder-mcp
• GitHub: github.com/hoklims/stacksfinder-mcp
• npm: @stacksfinder/mcp-server

# Related

• CLI: create-stacksfinder — Scaffold projects from terminal
• Website: stacksfinder.dev — Full web experience

# License

MIT