Stack Scout MCP: free open-source tool finder for Claude and Cursor
The honest free-tool finder for your AI. Describe what you want to build. Get free, open-source tools for every part of it: checked to be alive, checked to be truly free, with the catch spelled out.
What is Stack Scout? (in simple words)
You want to make an app. For example, a shoe shop.
Your app needs many parts:
- a page to log in
- a shopping cart
- a way to pay
- emails
You do not need to make every part yourself. People share free parts on the internet. But it is hard to find good ones. Some are old. Some are broken. Some say "free", but they are not really free.
Stack Scout helps your AI find the good free parts.
- You tell your AI (Claude or Cursor): "I want to make a shoe shop."
- Your AI asks Stack Scout for help.
- Stack Scout looks on GitHub. GitHub is a big website with free code.
- Stack Scout checks every tool. Is it new? Do many people use it? Is it really free? Is there a catch?
- Your AI gives you a short list: the best free tools, with links, good points and bad points.
Stack Scout is free. It runs on your computer. You do not pay for anything.
How it works (for developers)
Stack Scout is an MCP server for AI assistants you already use (Claude, Cursor, ...). Your AI splits your idea into needs. Stack Scout finds the tools for each need, reads their licenses and READMEs, checks activity, downloads, security and community discussion, and hands your AI the facts. Your AI then explains the pros, cons and the catch, without guessing from old training data.
Why "honest"
AI assistants often recommend tools that are abandoned, archived, or "open source" in name only. Stack Scout checks live data every time. Real examples from testing:
| Tool | GitHub says | Stack Scout found |
|---|---|---|
| Medusa (e-commerce) | License: "Other" | MIT core, but the Enterprise Edition needs a commercial agreement → open core |
| Meilisearch (search) | License: BUSL (not free) | MIT core, BUSL only for enterprise parts → open core, still usable for free |
| Terraform | License: BUSL | Restrictive → not recommended |
| Sentry | License: "Other" | Functional Source License, turns Apache only after 2 years → not free today |
| Elasticsearch | License: "Other" | You may choose AGPL → free (copyleft) |
It also skips archived repos, repos with no code changes in 2 years, and awesome-lists or tutorials posing as tools.
Example
> I want to build an online shoe store with TypeScript. Use Stack Scout.
## 1. Shopping cart & product catalog
| # | Tool | Stars | Last code change | License | Score |
| 1 | bagisto/bagisto | 28.4k | 3 days ago | MIT (free, permissive) | 96 |
| 2 | saleor/saleor | 23.6k | 1 day ago | BSD-3-Clause (free, permissive) | 95 |
| 3 | medusajs/medusa | 37.4k | today | MIT (open core: some parts paid) | 91 |
#### medusajs/medusa: research notes
- README mentions paid terms: "The RBAC-based Enterprise Edition materials ... require a
commercial agreement with MedusaJS, Inc."
- Activity: latest release v2.23.0 on 2026-11-20
- Adoption: package @medusajs/medusa on npm, 1.4M downloads last month
- Security practices (OpenSSF Scorecard): 5.7/10
- Known vulnerabilities in latest version: none listed in OSV
- README mentions (likely setup needs): Docker, PostgreSQL, Redis, Node.js
...
It works for anything, not just apps: "a 2D game engine" → Godot, PixiJS, GDevelop; "extract text from PDF files in python" → pdfplumber, pdftext.
Install
Pick the app you use. Each takes about 2 minutes.
Claude Desktop: easiest, no terminal
- Download stack-scout.mcpb
- Double-click the downloaded file. Claude Desktop opens.
- Click Install.
- Ask Claude: "Use Stack Scout to find free tools for an online shoe store."
Claude Desktop sets up everything Stack Scout needs by itself. Nothing else to install.
Cursor, VS Code or Claude Code
Step 1: install uv (one time only). It's a free helper that downloads Stack Scout and keeps it updated.
- Windows: open PowerShell and paste:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" - Mac / Linux: open Terminal and paste:
curl -LsSf https://astral.sh/uv/install.sh | sh
Then restart your computer (or at least the app), so the app can find uv.
Step 2: add Stack Scout.
| App | How |
|---|---|
| Cursor | |
| VS Code | |
| Claude Code | Run: claude mcp add stack-scout -- uvx stack-scout-mcp |
Step 3: ask your AI: "Use Stack Scout to find free tools for an online shoe store."
The first answer takes a little longer (about 10 seconds) while Stack Scout downloads.
Any other MCP app (Windsurf, Zed, Cline, ...)
Install uv (Step 1 above), then add this to the app's MCP settings:
{
"mcpServers": {
"stack-scout": {
"command": "uvx",
"args": ["stack-scout-mcp"]
}
}
}
If something doesn't work
| Problem | Fix |
|---|---|
The app says it can't find uvx |
Restart your computer after installing uv. Still failing? Use the full path: C:\Users\<you>\.local\bin\uvx.exe on Windows, ~/.local/bin/uvx on Mac/Linux |
| Stack Scout doesn't appear in the app | Fully quit the app (not just the window) and open it again |
| "Rate limit" message | Wait one minute, or add a free GitHub token (below) |
| Something else | Open an issue and paste the error |
Optional: more searches per minute
Without a token, GitHub allows 10 searches a minute, which is enough for most people. A free GitHub token (tick no permissions) raises it to 30.
- Claude Desktop: paste it in Settings → Extensions → Stack Scout.
- Other apps: add
"env": { "GITHUB_TOKEN": "your-token" }next to"args"in the config.
From source (for contributors)
git clone https://github.com/mhassaan0806-jpg/stack-scout-mcp.git && cd stack-scout-mcp
python -m venv .venv
.venv/bin/pip install -e . # Windows: .venv\Scripts\pip install -e .
Then point your MCP app at /full/path/.venv/bin/python with args ["/full/path/server.py"].
From a clone, a .env file (copy .env.example) can hold the GitHub token.
Tools your AI gets
| Tool | Use it for |
|---|---|
scout_stack |
Researched free tools for every need of a project |
find_tools |
One need ("send emails", "PDF invoices", "2D game engine") |
research_tool |
Vetting a GitHub link: maintained? truly free? what's the catch? |
plan_app_components |
Backup: guess an idea's needs from keywords |
list_building_blocks |
24 common needs with tuned searches |
Where the facts come from (all free, no paid keys)
GitHub (search, README, LICENSE, releases) · deps.dev (OpenSSF Scorecard, packages) · OSV (vulnerabilities) · npm / PyPI / crates.io (downloads) · Hacker News (discussions). Everything runs on your computer and the thinking is done by your own AI, so it costs $0 to run.
Use it without an AI
python -m stack_scout_mcp.tools.scout_stack "online shoe store" --language TypeScript
python -m stack_scout_mcp.tools.scout_stack "pdf tool" --components "extract text from pdf files in python"
python -m stack_scout_mcp.tools.research_tool medusajs/medusa
Tests
python -m unittest discover tests # offline, < 1 second
.venv/bin/python tests/live_mcp_smoke.py # starts the MCP server like Claude does, live data
How it's organised
stack_scout_mcp/server.py MCP server: thin wrapper around tools/
stack_scout_mcp/tools/ Scripts that do the work (search, license, health, research, rank, report)
stack_scout_mcp/tools/data/ Building-block catalog: add needs here, no code needed
server.py Runs the server from a clone
workflows/ Plain-language guides: how to run, evaluate, connect and extend
tests/ Offline logic tests + a live MCP smoke test
.tmp/ Cache when running from a clone (safe to delete)
Privacy
No account, no analytics, no server of ours. Stack Scout only sends search words and project names to the free public services listed above. Details: PRIVACY.md.
Limits (honestly)
- Ranking can't judge fit: a popular AI search engine may rank high for "site search". Your AI is told to judge fit and say "unknown" rather than guess.
- README checks are keyword hints ("read in context"), not legal advice.
- Payments: no open-source project makes card processing free. You'll get payment and billing platforms that still connect to a processor (Stripe, PayPal...) with per-transaction fees.
- No web search of its own yet. Your AI can web-search a pick further.
Contributing
The easiest win is a better catalog. See
workflows/extend_catalog.md.
Please run python -m unittest discover tests before opening a pull request.
FAQ
What is Stack Scout? Stack Scout is a free, open-source MCP server that helps AI assistants like Claude and Cursor find free, open-source tools for any software project. It checks that each tool is maintained and truly free, and explains the catch, such as paid "enterprise" features or license duties.
Is Stack Scout free? Yes. It is MIT-licensed, runs on your own computer, uses your own AI assistant, and only calls free public data sources. There is no account, subscription or API bill.
What is an MCP server? MCP (Model Context Protocol) is a standard way to give AI assistants extra tools. An MCP server is a small program the AI can call. Claude Desktop, Claude Code, Cursor, VS Code and other apps support MCP.
How is this different from just asking an AI for free tools? An AI answering from memory can suggest tools that are abandoned, archived, or no longer open source. Stack Scout checks live data every time: last code change, license file, releases, downloads, security score and known vulnerabilities.
Does it find open-source alternatives to paid software? Yes. Describe the need ("an open-source alternative to Shopify", "self-hosted analytics") and it returns free, maintained options, with any paid parts flagged.
Does it only work for web apps? No. It works for any need: games ("2D game engine"), data tools ("extract text from PDF files in python"), mobile apps, internal tools and more.
Which tools does it reject? Archived projects, projects with no code changes in two years, "source-available" licenses that restrict use (BUSL, SSPL, Elastic, FSL), and awesome-lists or tutorials posing as tools.
Keywords
free tool finder, open source alternatives, MCP server, Model Context Protocol, Claude MCP, Cursor MCP, tech stack recommendation, open source software discovery, license checker, open core detection, self-hosted alternatives, GitHub repository health, free developer tools, AI coding assistant tools
License
Metadata
Release files for stack-scout-mcp 0.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| stack_scout_mcp-0.1.2.tar.gz | 35.3 kB | With provenance | Details for stack_scout_mcp-0.1.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| stack_scout_mcp-0.1.2-py3-none-any.whl | Python 3 | none | any | Details for stack_scout_mcp-0.1.2-py3-none-any.whl |
Total release size: 73.9 kB
Release files / stack_scout_mcp-0.1.2.tar.gz
| Download URL | stack_scout_mcp-0.1.2.tar.gz |
|---|---|
| Size | 35.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
96eacf6b9ea0b5bccceede7535669484a8bf4299d3958446197c12b8efab8b84
|
|
BLAKE2b-256 checksum How to use checksums |
55cba817dec0fc28aaa2e35b7332e2cf37b918ec8079188ddd9a30e0a6505a07
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.
Transparency logRelease files / stack_scout_mcp-0.1.2-py3-none-any.whl
| Download URL | stack_scout_mcp-0.1.2-py3-none-any.whl |
|---|---|
| Size | 38.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2c715111f9b8e749f7ba800f20f2c490d4188fbc3a1159c6d48693d22f8c3a4d
|
|
BLAKE2b-256 checksum How to use checksums |
848661b8e486008ab347304ca52c73592b72abe884504086911905ef54459c24
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.
Transparency logSecurity for stack-scout-mcp 0.1.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for stack_scout_mcp-0.1.2.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.