@stacksfinder/mcp-server

![npm version](https://www.npmjs.com/package/@stacksfinder/mcp-server)
![License: MIT](https://opensource.org/licenses/MIT)
![MCP Registry](https://registry.modelcontextprotocol.io)
![LobeHub](https://lobehub.com/fr/mcp/hoklims-stacksfinder-mcp)

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

$3

bash

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

}'





$3



Add to

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

 (Windows):



macOS/Linux:

json

{

  "mcpServers": {

    "stacksfinder": {

      "command": "npx",

      "args": ["-y", "@stacksfinder/mcp-server"],

      "env": {

        "STACKSFINDER_API_KEY": "sk_live_xxx"

      }

    }

  }

}





Windows:

json

{

  "mcpServers": {

    "stacksfinder": {

      "command": "cmd",

      "args": ["/c", "npx", "-y", "@stacksfinder/mcp-server"],

      "env": {

        "STACKSFINDER_API_KEY": "sk_live_xxx"

      }

    }

  }

}





$3



Add to

.cursor/mcp.json or .windsurf/mcp.json

 in your project root:



macOS/Linux:

json

{

  "mcpServers": {

    "stacksfinder": {

      "command": "npx",

      "args": ["-y", "@stacksfinder/mcp-server"],

      "env": {

        "STACKSFINDER_API_KEY": "sk_live_xxx"

      }

    }

  }

}





Windows:

json

{

  "mcpServers": {

    "stacksfinder": {

      "command": "cmd",

      "args": ["/c", "npx", "-y", "@stacksfinder/mcp-server"],

      "env": {

        "STACKSFINDER_API_KEY": "sk_live_xxx"

      }

    }

  }

}





$3



Add to

.vscode/mcp.json

:



macOS/Linux:

json

{

  "servers": {

    "stacksfinder": {

      "command": "npx",

      "args": ["-y", "@stacksfinder/mcp-server"],

      "env": {

        "STACKSFINDER_API_KEY": "sk_live_xxx"

      }

    }

  }

}





Windows:

json

{

  "servers": {

    "stacksfinder": {

      "command": "cmd",

      "args": ["/c", "npx", "-y", "@stacksfinder/mcp-server"],

      "env": {

        "STACKSFINDER_API_KEY": "sk_live_xxx"

      }

    }

  }

}





$3



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



$3



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



$3



| Tool | Description |

|------|-------------|

|

estimate_project

 | Estimate scope, pricing, and market analysis for a project |

|

get_estimate_quota

 | Check your remaining estimate quota (weekly/monthly) |



$3



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



$3



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



$3



| 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



$3



> list_technologies category="database"



Available databases:

- postgres (PostgreSQL)

- sqlite (SQLite)

- supabase (Supabase)

- planetscale (PlanetScale)

- turso (Turso)

- neon (Neon)

$3



> 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

$3



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

$3



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

$3



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



$3



[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

$3



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



$3

- [x] Critical: lodash vulnerability

- [x] High: moment.js deprecation

- [x] High: outdated Node version

$3



> 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



$3



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 |



$3



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

$3



> 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

$3



> analyze_repo_mcps



Detected Technologies

- Frontend: SvelteKit (2.x)

- Database: PostgreSQL (via Drizzle)

- Auth: Lucia

- Payments: Paddle



Recommended MCPs



$3

Neon MCP (

@neondatabase/mcp-server

)

- Direct database access and query execution

- _Matched: drizzle, postgresql_



$3

Context7 (

context7

)

- Up-to-date documentation for any library

- _Matched: universal_

$3



> prepare_mcp_installation



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



MCPs to Install



$3

- Neon MCP (1 required vars)

- Paddle MCP (2 required vars)



$3

- Context7 (0 required vars)



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

$3



> 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



$3

bash

STACKSFINDER_MCP_DEBUG=true npx @stacksfinder/mcp-server





$3



| 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

bash

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

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

License

MIT

@stacksfinder/mcp-server

Quick Start

$3

bash

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

}'





$3



Add to

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

 (Windows):



macOS/Linux:

json

{

  "mcpServers": {

    "stacksfinder": {

      "command": "npx",

      "args": ["-y", "@stacksfinder/mcp-server"],

      "env": {

        "STACKSFINDER_API_KEY": "sk_live_xxx"

      }

    }

  }

}





Windows:

json

{

  "mcpServers": {

    "stacksfinder": {

      "command": "cmd",

      "args": ["/c", "npx", "-y", "@stacksfinder/mcp-server"],

      "env": {

        "STACKSFINDER_API_KEY": "sk_live_xxx"

      }

    }

  }

}





$3



Add to

.cursor/mcp.json or .windsurf/mcp.json

 in your project root:



macOS/Linux:

json

{

  "mcpServers": {

    "stacksfinder": {

      "command": "npx",

      "args": ["-y", "@stacksfinder/mcp-server"],

      "env": {

        "STACKSFINDER_API_KEY": "sk_live_xxx"

      }

    }

  }

}





Windows:

json

{

  "mcpServers": {

    "stacksfinder": {

      "command": "cmd",

      "args": ["/c", "npx", "-y", "@stacksfinder/mcp-server"],

      "env": {

        "STACKSFINDER_API_KEY": "sk_live_xxx"

      }

    }

  }

}





$3



Add to

.vscode/mcp.json

:



macOS/Linux:

json

{

  "servers": {

    "stacksfinder": {

      "command": "npx",

      "args": ["-y", "@stacksfinder/mcp-server"],

      "env": {

        "STACKSFINDER_API_KEY": "sk_live_xxx"

      }

    }

  }

}





Windows:

json

{

  "servers": {

    "stacksfinder": {

      "command": "cmd",

      "args": ["/c", "npx", "-y", "@stacksfinder/mcp-server"],

      "env": {

        "STACKSFINDER_API_KEY": "sk_live_xxx"

      }

    }

  }

}





$3



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



$3



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



$3



| Tool | Description |

|------|-------------|

|

estimate_project

 | Estimate scope, pricing, and market analysis for a project |

|

get_estimate_quota

 | Check your remaining estimate quota (weekly/monthly) |



$3



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



$3



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



$3



| 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



$3



> list_technologies category="database"



Available databases:

- postgres (PostgreSQL)

- sqlite (SQLite)

- supabase (Supabase)

- planetscale (PlanetScale)

- turso (Turso)

- neon (Neon)

$3



> 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

$3



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

$3



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

$3



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



$3



[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

$3



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



$3

- [x] Critical: lodash vulnerability

- [x] High: moment.js deprecation

- [x] High: outdated Node version

$3



> 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



$3



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 |



$3



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

$3



> 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

$3



> analyze_repo_mcps



Detected Technologies

- Frontend: SvelteKit (2.x)

- Database: PostgreSQL (via Drizzle)

- Auth: Lucia

- Payments: Paddle



Recommended MCPs



$3

Neon MCP (

@neondatabase/mcp-server

)

- Direct database access and query execution

- _Matched: drizzle, postgresql_



$3

Context7 (

context7

)

- Up-to-date documentation for any library

- _Matched: universal_

$3



> prepare_mcp_installation



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



MCPs to Install



$3

- Neon MCP (1 required vars)

- Paddle MCP (2 required vars)



$3

- Context7 (0 required vars)



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

$3



> 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



$3

bash

STACKSFINDER_MCP_DEBUG=true npx @stacksfinder/mcp-server





$3



| 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

bash

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

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

License

MIT

@stacksfinder/mcp-server

@stacksfinder/mcp-server

Quick Start

$3

macOS/Linux

Windows (requires cmd wrapper)

With API key (macOS/Linux)

$3

$3

$3

$3

Available Tools

$3

$3

$3

$3

$3

Tool Examples

$3

$3

SvelteKit Analysis (MVP Context)

$3

Comparison: Next.js vs SvelteKit vs Nuxt

$3

Recommended Stack for SaaS (MVP)

$3

Audit Report: Q1 2026 Review

$3

$3

Audit Comparison

$3

$3

Project Estimate

$3

$3

$3

Recommended Tech Stack

Recommended MCPs

Install Configs

$3

Detected Technologies

Recommended MCPs

$3

$3

$3

MCPs to Install

$3

$3

$3

Claude Code Installation

Post-Installation

Environment Variables

Score Dimensions

Contexts

Error Handling

Troubleshooting

$3

$3

Development

Contributing

Documentation

Links

Related

License

@stacksfinder/mcp-server

@stacksfinder/mcp-server

Quick Start

$3

macOS/Linux

Windows (requires cmd wrapper)

With API key (macOS/Linux)

$3

$3

$3

$3

Available Tools

$3

$3

$3

$3