StackGuide MCP
Provides tracker and VCS integration for branch checks, commit parsing, CI status, and PR/MR creation.
Provides tracker and VCS integration for branch checks, commit parsing, CI status, and PR/MR creation.
Allows creating Jira tickets from strict MAIN DESCRIPTION templates and reading tickets for intake.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@StackGuide MCP Initialize full project setup with Jira integration"
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.
StackGuide MCP Server
Dynamic context + active engineering workflow for AI coding assistants in Cursor, VS Code, and other MCP clients.
What It Does
@stackguide/mcp-server helps teams standardize implementation quality with:
project-aware rule/context loading
code review and health scoring
auto-detected setup and stack scaffolding
active agent workflow that executes real work (
intake,plan,verify,release)adaptive TDD preferences per project (model + token profile)
Jira ticket creation from strict
MAIN DESCRIPTIONtemplatestracker + VCS + test orchestration for delivery flow
This server is built for real team usage, not just prompt templates.
Related MCP server: TechStack Local MCP Server
What's New In v4.x
Added active
agenttool (execution-first workflow).initnow generates.stackguide/config.jsonautomatically.Added tracker service support for GitHub, GitLab, and Jira.
Added VCS service for branch checks, commit parsing, CI status, and PR/MR creation.
Added test runner service for structured
test/lint/buildexecution.Updated TDD prompts to use active tool calls instead of large passive markdown payloads.
Hardened local persistence:
.stackguideartifacts removed from version controlrepository guard blocks accidental tracking of local artifacts
cache and health history include integrity validation and safer writes
Install By IDE
Cursor
File (workspace):
.cursor/mcp.jsonFile (global):
~/.cursor/mcp.json
{
"mcpServers": {
"stackguide": {
"command": "npx",
"args": ["-y", "@stackguide/mcp-server@latest"]
}
}
}JetBrains (IntelliJ, WebStorm, PhpStorm, etc.)
Open
Settings | Tools | AI Assistant | Model Context Protocol (MCP).Click Add and paste JSON config.
Recommended: set it as Project-level unless you want global scope.
{
"mcpServers": {
"stackguide": {
"command": "npx",
"args": ["-y", "@stackguide/mcp-server@latest"]
}
}
}VS Code
Requirement: GitHub Copilot Chat with MCP enabled.
File (workspace):
.vscode/mcp.jsonVS Code MCP schema uses
serversas root key.
{
"servers": {
"stackguide": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@stackguide/mcp-server@latest"]
}
}
}Visual Studio (Windows, 2022 17.14+ / 2026+)
Enable GitHub Copilot Agent mode.
Supported config locations include:
%USERPROFILE%\\.mcp.json(global)<solution>\\.mcp.json(repo-scoped)<solution>\\.vs\\mcp.json(solution/user-scoped)
Visual Studio MCP schema uses
serversas root key.
{
"servers": {
"stackguide": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@stackguide/mcp-server@latest"]
}
}
}How To Use (Any IDE)
Restart the IDE after adding the MCP configuration.
Open AI chat in agent/tool mode.
Call
setupto detect project context.Call
init action:"full"to scaffold.stackguide/and defaults.Use
agentactions (intake,create_ticket,plan,verify,release) for delivery flow.
Quick Start
Configure your project:
setup type:"react-typescript" enableAdaptiveTdd:true model:"gpt-5" integrations:["jira","github"] tokenMode:"compact"
init action:"full" model:"gpt-5" tokenMode:"compact" integrations:["jira","github"] mcpSyncTargets:["cursor","root"] applyMcpTemplates:trueCheck generated setup:
init action:"status"
agent action:"status"Run active TDD workflow:
agent action:"intake" ticket:"PROJ-123"
agent action:"create_ticket" mainDescription:"<MAIN DESCRIPTION>" projectKey:"PROJ"
agent action:"plan" brief:"<brief-from-intake>"
agent action:"verify"
agent action:"release" version:"v1.2.0"Tools (16)
Core
setup: configure StackGuide context for project typecontext: show currently loaded contextrules: list/search/get/select rule setsknowledge: list/search/get knowledge filesreview: analyze files/URLs/project code quality
Utility
cursor: browse/import community rulesdocs: fetch/search/list documentationconfig: save/load/export/import configurationscustom_rule: create/update/delete/list project custom ruleshelp: usage help by topic
Advanced
generate: boilerplate generation (component/hook/service/test/api/model/util)health: project health score and recommendationsanalyze: project intelligence (structure/config/dependency/generate/apply)
Workflow
workflow: lazy-load raw workflow assets (agents/skills/hooks/commands)init: scaffold.stackguidewith stack-aware defaultsagent: active workflow executor (status,intake,create_ticket,plan,verify,release)
Active Workflow Details
agent action:"intake"
reads ticket from configured tracker
returns normalized brief + gaps
proposes branch name convention
can optionally create a Jira ticket first (
createFromDescription:true)
agent action:"create_ticket"
creates Jira issues using strict
MAIN DESCRIPTIONformatuses project defaults from
.stackguide/config.json(projectKey,issueType)derives
summaryfrom first line ofMAIN DESCRIPTIONwhen omitted
agent action:"plan"
inspects conventions + project shape
creates vertical-slice plan
returns exactly 3 target tests in structured format
agent action:"verify"
executes configured tests/lint/build per layer
checks branch naming + commit convention + TDD test budget
returns blocker list and final pass/fail report
agent action:"release"
checks CI status
parses commits since last tag
suggests semver impact (
major/minor/patch)can create tag and PR/MR (when enabled)
Local Data And Security
init generates:
.stackguide/config.json(project workflow config)
Runtime/local artifacts:
.stackguide/analysis-cache.json.stackguide/health-history.json
These are machine-local and must not be committed.
Repository Guard
pnpm lint includes:
pnpm run guard:repoThe guard fails if .stackguide artifacts are tracked.
Integrity Hardening
Cache/history persistence includes:
boundary/symlink checks
file size and entry limits
atomic write strategy
checksum validation
optional HMAC signature using:
STACKGUIDE_INTEGRITY_KEY=<long-random-secret>For teams, configure STACKGUIDE_INTEGRITY_KEY in local/dev and CI environments for stronger tamper resistance.
Supported Stacks
python-django, python-fastapi, python-flask, react-node, react-typescript, vue-node, nextjs, express, nestjs, laravel, rails, golang, rust, custom.
Development
Use pnpm for all commands.
pnpm install
pnpm lint
pnpm test
pnpm build
pnpm devRelease And Version Policy
Current secure baseline:
4.1.2+Versions from
3.0.0up to4.1.1are deprecated in npm due to local artifact hygiene issues.Use the latest
4.xrelease in all environments.
Registry Identifiers
npm package:
@stackguide/mcp-serverMCP Registry server:
io.github.isucorp-taimiralain/stackguide-mcp
License
GPL-3.0
Available Tools
16 toolsagentC
Active agent workflow actions: intake/plan/verify/release plus Jira ticket creation from strict MAIN DESCRIPTION templates.
Inputs: path, brief, action, labels, +22 more.
analyzeC
Project Intelligence: Comprehensive analysis of project structure, configuration, and dependencies. Provides smart recommendations, generates optimal configs, and suggests improvements based on framework best practices.
Inputs: path, action, format, autoFix, +1 more.
configC
Manage saved configurations: save, load, list, delete, export, or import.
Inputs: id, json, name, action.
contextA
Get current context with all loaded rules and knowledge. Use this to see what StackGuide has configured.
Inputs: full.
cursorB
Browse, search, and import rules from cursor.directory community.
Inputs: slug, query, action.
custom_ruleC
Create, update, delete, or list custom rules for your project.
Inputs: id, json, name, action, +2 more.
docsC
Fetch and manage web documentation. Fetch URLs, search cached docs, or list available.
Inputs: url, urls, query, action.
generateA
Generate boilerplate code from templates. Create components, hooks, services, tests, API routes, models, and utilities with best practices built in.
Inputs: name (required), type (required), options.
healthA
Get a comprehensive health score for your project. Analyzes configuration, code quality, structure, documentation, and testing readiness. Returns a grade (A-F) with detailed recommendations.
Inputs: detailed, projectPath.
helpC
Get help about StackGuide tools and how to use them.
Inputs: topic.
initB
Initialize a project with the StackGuide TDD workflow. Auto-detects your stack and scaffolds a .stackguide/ directory with only the relevant agents, skills and hooks.
Inputs: path, type, model, action, +6 more.
knowledgeB
Manage knowledge base: list, search, or get architecture patterns and solutions.
Inputs: query, action, category.
reviewA
Analyze code for issues using pattern matching. Detects security vulnerabilities, performance problems, coding standard violations, and architecture issues. Returns a score (0-100) and detailed report with suggestions. Works on files, URLs, or entire projects.
Inputs: url, file, focus, project.
rulesB
Manage rules: list, search, get, or select rules for your project.
Inputs: ids, query, action, category.
setupB
Configure StackGuide for your project. Auto-detects project type or lets you specify one manually.
Inputs: path, type, model, tokenMode, +5 more.
workflowC
TDD agentic workflow with lazy loading. Load agents, skills, hooks and commands on demand to save tokens. Five roles: Intake → Planner → Implementer → Verifier → Releaser.
Inputs: name, action, category.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 16 tools
Several tools have overlapping purposes: 'workflow' and 'agent' both handle TDD workflow actions; 'init' and 'setup' both configure the project; 'health', 'analyze', and 'review' all perform analysis. While descriptions provide some differentiation, an agent may still confuse similar tools.
Tool names are a mix of verbs (generate, init, analyze, help, setup, review) and nouns (workflow, health, agent, context, rules, knowledge, cursor, docs, config, custom_rule). 'custom_rule' uses an underscore while all others are single words, showing no consistent naming pattern.
With 16 tools, the server is slightly above the typical 3-15 range but still well-scoped for its broad feature set covering workflow, analysis, code generation, and configuration management. Each tool serves a clear purpose, and none seem redundant.
The tool set covers major aspects of a development assistant: project initialization, workflow management, code generation, health analysis, code review, rule management, documentation, and configuration. Minor gaps exist (e.g., no explicit deployment or testing automation), but overall it is comprehensive for its domain.
Maintenance
Related MCP Connectors
Adaptive plan/build/review cycles for AI coding assistants, persisted across sessions.
Context engineering for AI coding agents: product context, project missions, and 360 memory.
AI-powered spec-to-task decomposition and execution orchestration for coding agents.
AI colleagues that keep your standards, your project and their reasoning between sessions
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceImplements Agentic Context Engineering to create self-improving AI coding assistants that learn from execution feedback and build persistent knowledge playbooks. Reduces token usage by 86.9% while improving code accuracy by 10.6% through incremental context updates.4MIT
- FlicenseNot gradedqualityDmaintenanceTransforms AI coding assistants into context-aware developers by auto-detecting project context, remembering conversations, and executing commands safely with a multi-layer security model.-
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to research, plan, generate requirements, map codebases, curate context, manage tasks, scaffold projects, and run multi-step software development workflows.69 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to research, plan, generate requirements and user stories, create starter projects, analyze codebases, curate context, manage tasks, and execute multi-step development workflows.69 npmMIT