@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
- Enable Developer Mode: Go to Settings โ Apps โ Advanced settings โ toggle "Developer mode"
- Create App: Go to Settings โ Apps โ Create
- 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
- 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)