@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 — 4 tools work without an account, including a daily demo recommendation.

Quick Start

Claude Code (CLI)

# Add to Claude Code
claude mcp add stacksfinder npx -y @stacksfinder/mcp-server

# With API key for full features
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):

{
  "mcpServers": {
    "stacksfinder": {
      "command": "npx",
      "args": ["-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:

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

VS Code + Copilot

Add to .vscode/mcp.json:

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

Available Tools

Free Tools (no account required)

Pro Tools (requires API key)

Audit Tools (requires API key) 🆕

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** ⚠️

| Severity | Count |
|----------|-------|
| 🔴 Critical | 2 |
| 🟠 High | 1 |
| 🟡 Medium | 3 |
| 🟢 Low | 2 |
| ℹ️ Info | 5 |

### Critical Findings

**🔴 Security vulnerability in lodash** (lodash 4.17.20)
CVE-2021-23337 - Prototype pollution vulnerability
→ Upgrade to lodash 4.17.21 or later

**🔴 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)
- ✅ Critical: lodash vulnerability
- ✅ High: moment.js deprecation
- ✅ High: outdated Node version

Environment Variables

Score Dimensions

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

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

Development

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

Links

• Website: stacksfinder.com
• Pricing: stacksfinder.com/pricing
• 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

License

MIT