What can you do with this server?

The StacksFinder MCP server provides deterministic tech stack recommendations and analysis tools for developers working with LLM clients like Claude, Cursor, and VS Code. Core Capabilities: Technology Discovery & Analysis (No API Key Required) * List available technologies across 8 categories (frontend, backend, meta-framework, database, ORM, auth, hosting, payments) * Analyze individual technologies with 6-dimension scoring (performance, DX, ecosystem, maintainability, cost, compliance) that adapts to project context (default, MVP, enterprise) * Compare 2-4 technologies side-by-side with per-dimension winners and compatibility analysis * Get daily free demo stack recommendations for various project types and scales Stack Recommendations (Requires API Key) * Generate unlimited custom recommendations with support for 9 project types, 4 scale levels, up to 3 custom priorities (time-to-market, scalability, developer-experience, cost-efficiency, performance, security, maintainability), and technology constraints to include/exclude specific tools Blueprint Management (Requires API Key) * Create comprehensive project blueprints with AI-generated narratives and implementation guidance * Fetch existing blueprints by UUID with support for asynchronous generation and optional polling Project Estimation (Requires API Key) * Get comprehensive project scope, pricing, and market analysis with detailed feature breakdowns and cost adjustments Technical Audits (Requires API Key) * Run technical debt audits on existing stacks * Retrieve, list, and compare audit reports to track progress * Get migration recommendations MCP Integration Tools (No API Key Required) * Generate optimal tech stacks with MCP recommendations from project descriptions * Analyze repositories to identify relevant MCP servers * Prepare and execute MCP installations with .env-mcp templates API Key Management (Requires Credentials) * Authenticate with email/password to create API keys * List and revoke existing keys for access management Cross-Platform Support: Works with Claude Desktop, Claude Code, Cursor, Windsurf, VS Code + Copilot, and ChatGPT Developer Mode.

How do I use stacksfinder-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@stacksfinder-mcp recommend a stack for a startup mvp with react" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

The StacksFinder MCP server provides deterministic tech stack recommendations and analysis tools for developers working with LLM clients like Claude, Cursor, and VS Code.

Core Capabilities:

Technology Discovery & Analysis (No API Key Required)

List available technologies across 8 categories (frontend, backend, meta-framework, database, ORM, auth, hosting, payments)
Analyze individual technologies with 6-dimension scoring (performance, DX, ecosystem, maintainability, cost, compliance) that adapts to project context (default, MVP, enterprise)
Compare 2-4 technologies side-by-side with per-dimension winners and compatibility analysis
Get daily free demo stack recommendations for various project types and scales

Stack Recommendations (Requires API Key)

Generate unlimited custom recommendations with support for 9 project types, 4 scale levels, up to 3 custom priorities (time-to-market, scalability, developer-experience, cost-efficiency, performance, security, maintainability), and technology constraints to include/exclude specific tools

Blueprint Management (Requires API Key)

Create comprehensive project blueprints with AI-generated narratives and implementation guidance
Fetch existing blueprints by UUID with support for asynchronous generation and optional polling

Project Estimation (Requires API Key)

Get comprehensive project scope, pricing, and market analysis with detailed feature breakdowns and cost adjustments

Technical Audits (Requires API Key)

Run technical debt audits on existing stacks
Retrieve, list, and compare audit reports to track progress
Get migration recommendations

MCP Integration Tools (No API Key Required)

Generate optimal tech stacks with MCP recommendations from project descriptions
Analyze repositories to identify relevant MCP servers
Prepare and execute MCP installations with .env-mcp templates

API Key Management (Requires Credentials)

Authenticate with email/password to create API keys
List and revoke existing keys for access management

Cross-Platform Support: Works with Claude Desktop, Claude Code, Cursor, Windsurf, VS Code + Copilot, and ChatGPT Developer Mode.

Provides tech stack recommendations and analysis for Drizzle ORM, including scoring across performance, developer experience, ecosystem, maintainability, cost, and compliance dimensions.

Provides tech stack recommendations and analysis for Next.js, including scoring across performance, developer experience, ecosystem, maintainability, cost, and compliance dimensions, with support for technology comparisons.

Provides tech stack recommendations and analysis for Nuxt, including scoring across performance, developer experience, ecosystem, maintainability, cost, and compliance dimensions, with support for technology comparisons.

Provides tech stack recommendations and analysis for Paddle payment integration, including scoring across performance, developer experience, ecosystem, maintainability, cost, and compliance dimensions.

Provides tech stack recommendations and analysis for PlanetScale database, including scoring across performance, developer experience, ecosystem, maintainability, cost, and compliance dimensions.

Provides tech stack recommendations and analysis for PostgreSQL database, including scoring across performance, developer experience, ecosystem, maintainability, cost, and compliance dimensions.

Provides tech stack recommendations and analysis for SQLite database, including scoring across performance, developer experience, ecosystem, maintainability, cost, and compliance dimensions.

Provides tech stack recommendations and analysis for Supabase, including scoring across performance, developer experience, ecosystem, maintainability, cost, and compliance dimensions.

Provides tech stack recommendations and analysis for SvelteKit, including scoring across performance, developer experience, ecosystem, maintainability, cost, and compliance dimensions, with support for technology comparisons.

Provides tech stack recommendations and analysis for Turso database, including scoring across performance, developer experience, ecosystem, maintainability, cost, and compliance dimensions.

Provides tech stack recommendations and analysis for Vercel hosting platform, including scoring across performance, developer experience, ecosystem, maintainability, cost, and compliance dimensions.

@stacksfinder/mcp-server

npm version License: MIT MCP Registry LobeHub

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

Related MCP server: mcp-github

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

License

MIT

Install Server

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

Resources

Need Help?

Report Issue

Related Servers

Tools

View all tools

@stacksfinder/mcp-server

Quick Start

Claude Code (CLI)

Claude Desktop

Cursor / Windsurf

VS Code + Copilot

ChatGPT Developer Mode

Prerequisites

Setup Steps

Important Notes

Supported Protocols

Available Tools

Free Tools (no account required)

Estimator Tools (requires API key)

Pro Tools (requires API key)

Audit Tools (requires API key)

Project Kit Tools (no API key required)

Tool Examples

list_technologies

analyze_tech

compare_techs

recommend_stack (Free Demo)

create_audit (Pro)

compare_audits (Pro)

estimate_project (Pro)

generate_mcp_kit (Free)

analyze_repo_mcps (Free)

prepare_mcp_installation (Free)

execute_mcp_installation (Free)

Environment Variables

Score Dimensions

Contexts

Error Handling

Troubleshooting

Debug mode

Common issues

Development

Contributing

Documentation

Links

Related

License

Resources

Tools

New MCP Servers

Latest Blog Posts

MCP directory API