mcp-adr-analysis-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| AI_MODEL | No | AI model to use for execution | anthropic/claude-3-sonnet |
| LOG_LEVEL | No | Logging level (DEBUG, INFO, WARN, ERROR) | |
| AI_TIMEOUT | No | Request timeout in ms | 60000 |
| PROJECT_PATH | Yes | Path to the project directory to analyze | |
| ADR_DIRECTORY | No | Directory containing ADR files | docs/adrs |
| AI_MAX_TOKENS | No | Response length limit | 4000 |
| AI_TEMPERATURE | No | Response consistency (0-1) | 0.1 |
| EXECUTION_MODE | No | Execution mode: 'full' (AI execution) or 'prompt-only' (legacy) | prompt-only |
| AI_CACHE_ENABLED | No | Enable response caching | true |
| OPENROUTER_API_KEY | No | OpenRouter API key from https://openrouter.ai/keys (Required for AI execution) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
| prompts | {} |
| resources | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_toolsA | Search and discover available tools by category, keyword, or capability. Use this to find the right tool for a task without loading all tool schemas. Returns lightweight tool metadata by default; use includeSchema:true for full schemas. |
| analyze_project_ecosystemB | Comprehensive recursive project ecosystem analysis with advanced prompting techniques (Knowledge Generation + Reflexion) |
| get_architectural_contextB | Get detailed architectural context for specific files or the entire project, automatically sets up ADR infrastructure if missing, and provides outcome-focused workflow for project success |
| generate_adrs_from_prdB | Generate Architectural Decision Records from a Product Requirements Document with advanced prompting techniques (APE + Knowledge Generation) |
| compare_adr_progressB | Compare TODO.md progress against ADRs and current environment to validate implementation status |
| analyze_content_securityB | Analyze content for sensitive information using AI-powered detection with optional memory integration for security pattern learning |
| generate_content_maskingC | Generate masking instructions for detected sensitive content |
| configure_custom_patternsB | Configure custom sensitive patterns for a project |
| apply_basic_content_maskingB | Apply basic content masking (fallback when AI is not available) |
| validate_content_maskingC | Validate that content masking was applied correctly |
| manage_cacheB | Manage MCP resource cache (clear, stats, cleanup) |
| configure_output_maskingC | Configure content masking for all MCP outputs |
| suggest_adrsB | Suggest architectural decisions with advanced prompting techniques (Knowledge Generation + Reflexion). TIP: Read @.mcp-server-context.md first for project history, patterns, and previous ADRs to ensure consistency. |
| generate_adr_from_decisionC | Generate a complete ADR from decision data. TIP: Reference @.mcp-server-context.md to align with existing architectural patterns and decisions. |
| generate_adr_bootstrapA | Generate bootstrap.sh and validate_bootstrap.sh scripts to ensure deployed code follows ADR requirements. CRITICAL: Before generating scripts, use WebFetch to query the base code repository (e.g., https://github.com/validatedpatterns/common for OpenShift) and authoritative pattern documentation (e.g., https://play.validatedpatterns.io/). Merge the base repository code into your project and have bootstrap.sh call the pattern's scripts rather than generating everything from scratch. This ensures compliance with validated deployment patterns. |
| bootstrap_validation_loopA | GUIDED EXECUTION MODE: This tool guides you through an interactive, step-by-step deployment validation workflow. It does NOT execute commands internally - instead, it tells YOU what commands to run and processes the results iteratively. Workflow: (1) First call with iteration=0: Detects platform (OpenShift/K8s/Docker), validates environment connection, and requests human approval for target platform. (2) Subsequent calls: After running each command and reporting back with output, the tool provides next steps. Environment Validation: Before deployment, the tool verifies connection to the target platform (e.g., |
| discover_existing_adrsC | Discover and catalog existing ADRs in the project |
| analyze_adr_timelineB | Analyze ADR timeline with smart time tracking, adaptive thresholds, and actionable recommendations. Auto-detects project context (startup/growth/mature) and generates prioritized work queue based on staleness, implementation lag, and technical debt. |
| review_existing_adrsB | Review existing ADRs against actual code implementation with cloud/DevOps expertise. TIP: After review, call get_server_context to update @.mcp-server-context.md with findings. |
| validate_adrB | Validate an existing ADR against actual infrastructure reality using research-driven analysis. TIP: Compare findings against patterns in @.mcp-server-context.md for consistency checks. |
| validate_all_adrsB | Validate all ADRs in a directory against actual infrastructure reality |
| incorporate_researchC | Incorporate research findings into architectural decisions |
| create_research_templateB | Create a research template file for documenting findings |
| request_action_confirmationB | Request confirmation before applying research-based changes |
| generate_rulesB | Generate architectural rules from ADRs and code patterns |
| validate_rulesC | Validate code against architectural rules |
| create_rule_setC | Create machine-readable rule set in JSON/YAML format |
| analyze_environmentB | Analyze environment context and provide optimization recommendations with optional memory integration for environment snapshot tracking |
| generate_research_questionsC | Generate context-aware research questions and create research tracking system |
| perform_researchA | Perform research using cascading sources: project files → knowledge graph → environment resources → web search (fallback) |
| search_codebaseB | Atomic tool for searching codebase files based on query patterns. Returns raw file matches with relevance scores. Extracted from ResearchOrchestrator per ADR-018. |
| llm_web_searchB | LLM-managed web search using Firecrawl for cross-platform support |
| llm_cloud_managementC | LLM-managed cloud provider operations with research-driven approach |
| llm_database_managementC | LLM-managed database operations with research-driven approach |
| analyze_deployment_progressC | Analyze deployment progress and verify completion with outcome rules |
| check_ai_execution_statusB | Check AI execution configuration and status for debugging prompt-only mode issues |
| get_workflow_guidanceB | Get intelligent workflow guidance and tool recommendations based on your goals and project context to achieve expected outcomes efficiently |
| get_development_guidanceB | Get comprehensive development guidance that translates architectural decisions and workflow recommendations into specific coding tasks, implementation patterns, and development roadmap |
| list_rootsA | List available file system roots that can be accessed. Use this to discover what directories are available before reading files. |
| read_directoryA | List files and folders in a directory. Use this to explore the file structure within accessible roots. |
| read_fileB | Read contents of a file |
| write_fileC | Write content to a file |
| list_directoryC | List contents of a directory |
| generate_deployment_guidanceB | Generate deployment guidance and instructions from ADRs with environment-specific configurations |
| smart_git_pushA | AI-driven security-focused git push with credential detection, file filtering, and deployment metrics tracking. Tests should be run by calling AI and results provided. |
| deployment_readinessB | Comprehensive deployment readiness validation with test failure tracking, deployment history analysis, and hard blocking for unsafe deployments. Integrates with smart_git_push for deployment gating. |
| release_trackingB | Track releases mapped to ADR decisions. Generates changelogs, manages milestones, compares releases, and assesses release readiness. Supports greenfield and brownfield projects. Writes CHANGELOG.md, creates GitHub Releases and Milestones. |
| generate_adr_todoA | Generate TODO.md from ADRs with comprehensive task breakdown. Decomposes each ADR into paired test+production tasks (TDD), links tasks to release milestones, and preserves manual edits via a bounded HTML-comment section. Re-runs are idempotent; tasks for deleted/superseded ADRs move to a Stale Tasks section. |
| troubleshoot_guided_workflowB | Structured failure analysis and test plan generation with memory integration for troubleshooting session tracking and intelligent ADR/research suggestion capabilities - provide JSON failure info to get specific test commands |
| smart_scoreC | Central coordination for project health scoring system - recalculate, sync, diagnose, optimize, and reset scores across all MCP tools |
| mcp_planningC | Enhanced project planning and workflow management tool - phase-based project management, team resource allocation, progress tracking, risk analysis, and executive reporting |
| interactive_adr_planningB | Interactive guided ADR planning and creation tool - walks users through structured decision-making process with research integration, option evaluation, and automatic ADR generation. TIP: Start by reading @.mcp-server-context.md to understand project context and previous decisions. |
| memory_loadingC | Advanced memory loading tool for the memory-centric architecture. Query, explore, and manage memory entities and relationships. Load ADRs into memory system and perform intelligent queries. |
| expand_analysis_sectionA | Retrieve full analysis content from tiered responses. Expand entire analysis or specific sections stored in memory. Use this when a tool returns a summary with an expandable ID. |
| tool_chain_orchestratorC | AI-powered dynamic tool sequencing - intelligently analyze user requests and generate structured tool execution plans |
| expand_memoryC | Phase 3: Retrieve and expand stored content from a tiered response using its expandable ID |
| query_conversation_historyB | Phase 3: Search and retrieve conversation sessions based on filters |
| get_conversation_snapshotC | Phase 3: Get current conversation context snapshot for resumption or analysis |
| get_memory_statsC | Phase 3: Get statistics about stored conversation memory |
| update_knowledgeA | ADR-018: Simple CRUD operations for knowledge graph. Add/remove entities (intents, ADRs, tools, code) and relationships. Use knowledge://graph resource to read current state (zero token cost). |
| get_server_contextB | Generate a comprehensive context file showing the server's current state, memory, and capabilities. Creates .mcp-server-context.md that can be @ referenced in conversations for instant LLM awareness |
| get_current_datetimeA | Get the current date and time in various formats. Useful for timestamping ADRs, research documents, and other architectural artifacts. Returns ISO 8601, human-readable, and ADR-specific date formats. |
| set_project_pathA | Dynamically set the active project path for the current session. Call this at the start of a session to switch between projects without restarting the server or modifying environment variables. All subsequent tool calls will use this path as the default. |
| load_promptB | Load a specific prompt or prompt section on-demand. Part of CE-MCP lazy loading system that reduces token usage by ~96% by loading prompts only when needed. Use this to retrieve prompt templates for ADR generation, analysis, deployment, and other operations. |
| sync_to_aggregatorB | Sync ADRs to ADR Aggregator platform (https://adraggregator.com) for centralized tracking, visualization, and team collaboration. Supports incremental and full sync modes with optional metadata. |
| get_adr_contextA | Fetch ADR context from ADR Aggregator including summaries, diagrams, timeline data, and code links. Useful for getting a consolidated view of architectural decisions. |
| get_staleness_reportB | Get ADR staleness report from ADR Aggregator with review compliance metrics. Identifies stale ADRs that need attention and provides governance insights. |
| get_adr_templatesA | Get domain-specific ADR templates and anti-patterns from ADR Aggregator. Includes best practices for web applications, microservices, APIs, and more. No authentication required. |
| get_adr_diagramsA | Get Mermaid diagrams for ADRs from ADR Aggregator. Includes workflow, relationship, and impact diagrams. Requires Pro+ tier. |
| validate_adr_complianceC | Validate ADR compliance against implementation via ADR Aggregator. Checks that code actually implements documented decisions. Requires Pro+ tier. |
| get_knowledge_graphB | Get cross-repository knowledge graph from ADR Aggregator with analytics and insights. Visualize ADR relationships across repositories. Requires Team tier. |
| update_implementation_statusB | Update the implementation status of synced ADRs directly from the IDE. Supports statuses: not_started, in_progress, implemented, deprecated, blocked. Requires Pro+ tier. |
| get_adr_prioritiesA | Get ADR priorities for roadmap and backlog planning from ADR Aggregator. Returns prioritized ADRs with scores, dependencies, blockers, implementation status, and gap counts. |
| analyze_gapsA | Scan local codebase and compare with ADRs to detect bi-directional gaps. Finds: (1) ADR-to-code gaps: file references in ADRs that do not exist, (2) Code-to-ADR gaps: technologies in package.json and architectural patterns without ADR coverage. Reports gaps to ADR Aggregator for tracking. |
| get_gapsA | Get current code gaps from ADR Aggregator. Returns gaps with their status (open, dismissed, resolved) for tracking and management. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| goal_specification | Specify project goals and requirements for comprehensive analysis |
| action_confirmation | Confirm actions before writing files to disk |
| ambiguity_resolution | Resolve ambiguities in project analysis or requirements |
| custom_rule_definition | Define custom architectural rules and validation criteria |
| baseline_analysis | Generate comprehensive baseline analysis for existing projects |
| secret_prevention_guidance | Proactive guidance to prevent secret exposure in code and documentation |
| todo_task_generation | Generate comprehensive development task list from ADRs with cloud/DevOps expertise |
| todo_status_management | Manage task status, priorities, and progress tracking |
| todo_dependency_analysis | Analyze task dependencies and critical path optimization |
| todo_estimation | Provide accurate task estimation and timeline planning |
| technology_detection_prompt | Generate technology detection analysis prompt |
| pattern_detection_prompt | Generate architectural pattern detection prompt |
| comprehensive_analysis_prompt | Generate comprehensive project analysis prompt |
| implicit_decision_detection_prompt | Generate prompt for detecting implicit architectural decisions in code |
| code_change_analysis_prompt | Generate prompt for analyzing code changes for architectural decisions |
| adr_template_prompt | Generate ADR template prompt with specific format and context |
| deployment_task_identification_prompt | Generate prompt for identifying deployment tasks |
| cicd_analysis_prompt | Generate CI/CD pipeline analysis prompt |
| deployment_progress_calculation_prompt | Generate deployment progress calculation prompt |
| completion_verification_prompt | Generate completion verification prompt |
| environment_spec_analysis_prompt | Generate environment specification analysis prompt |
| containerization_detection_prompt | Generate containerization detection prompt |
| adr_environment_requirements_prompt | Generate ADR environment requirements prompt |
| environment_compliance_prompt | Generate environment compliance analysis prompt |
| research_topic_extraction_prompt | Generate research topic extraction prompt |
| research_impact_evaluation_prompt | Generate research impact evaluation prompt |
| adr_update_suggestion_prompt | Generate ADR update suggestion prompt |
| problem_knowledge_correlation_prompt | Generate problem-knowledge correlation prompt |
| relevant_adr_pattern_prompt | Generate relevant ADR pattern identification prompt |
| context_aware_research_questions_prompt | Generate context-aware research questions prompt |
| research_task_tracking_prompt | Generate research task tracking prompt |
| rule_extraction_prompt | Generate rule extraction prompt from code and ADRs |
| pattern_based_rule_prompt | Generate pattern-based rule creation prompt |
| code_validation_prompt | Generate code validation prompt against rules |
| rule_deviation_report_prompt | Generate rule deviation report prompt |
| sensitive_content_detection_prompt | Generate sensitive content detection prompt |
| content_masking_prompt | Generate content masking strategy prompt |
| custom_pattern_configuration_prompt | Generate custom security pattern configuration prompt |
| validated_pattern_selection_prompt | Generate validated pattern selection guidance for LLMs |
| validated_pattern_integration_prompt | Generate comprehensive pattern integration guide with base code repository instructions |
| validated_pattern_troubleshooting_prompt | Generate pattern troubleshooting guide for deployment failures |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Architectural Knowledge Graph | Complete architectural knowledge graph with technologies, patterns, and relationships |
| Analysis Report | Comprehensive project analysis report with metrics and recommendations |
| ADR List | List of all Architectural Decision Records with status and metadata |
| Todo List | Current project task list with status, priorities, and dependencies |
| Research Index | Index of all research documents and findings with metadata |
| Rule Catalog | Catalog of all architectural and validation rules from ADRs and code |
| Rule Generation | AI-powered rule generation from ADRs and code patterns. Supports query parameters: ?operation=generate|validate|create_set, ?source=adrs|patterns|both, ?knowledge=true|false, ?enhanced=true|false, ?format=json|yaml|both, ?comprehensive=true|false |
| Project Status | Current project status and health metrics aggregated from all sources |
| ADR by ID | Individual Architectural Decision Record by ID or title match |
| Research by Topic | Research documents filtered by topic with full content |
| Todo by Task ID | Individual task details by ID or title match with dependencies and history |
| Rule by ID | Individual architectural rule by ID or name match with violations and usage stats |
| Deployment Status | Current deployment state with health checks, build status, and readiness score |
| Environment Analysis | System environment details including platform, dependencies, and capabilities |
| Memory Snapshots | Knowledge graph snapshots with statistics, insights, and relationship data |
| Project Metrics | Code metrics and quality scores including codebase stats, quality assessment, and git metrics |
| Technology by Name | Individual technology analysis by name with usage, relationships, and adoption status |
| Pattern by Name | Individual pattern analysis by name with quality metrics, relationships, and examples |
| Deployment History | Historical deployment data with trends, failure analysis, and patterns. Supports query parameters: ?period=7d|30d|90d|1y|all, ?environment=production|staging|development|all, ?includeFailures=true|false, ?includeMetrics=true|false, ?format=summary|detailed |
| Release History | Release tracking state with releases mapped to ADRs, milestones, and project metadata. Shows release timeline, ADR-to-release mappings with confidence scores, and unmapped ADRs. |
| Code Quality | Comprehensive code quality assessment with metrics, issues, and recommendations. Supports query parameters: ?scope=full|changes|critical, ?includeMetrics=true|false, ?includeRecommendations=true|false, ?threshold=0-100, ?format=summary|detailed |
| Validated Patterns Catalog | Complete catalog of validated deployment patterns for different platforms (OpenShift, Kubernetes, Docker, Node.js, Python, MCP, A2A) with bill of materials, deployment phases, validation checks, and authoritative sources |
| Validated Pattern by Platform | Individual validated pattern by platform type (openshift, kubernetes, docker, nodejs, python, mcp, a2a) with complete bill of materials, deployment phases, validation checks, health checks, and authoritative sources for LLM research |
| Pattern Authoritative Sources | Authoritative documentation and repository sources for a specific platform pattern, prioritized by importance with query instructions for LLMs |
| Pattern Base Code Repository | Base code repository information for a platform pattern including URL, integration instructions, required files, and script entrypoint |
| Knowledge Graph | Read-only knowledge graph structure with nodes (intents, ADRs, tools, code files) and edges (relationships). Zero token cost for querying graph state. Use update_knowledge tool to modify. |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/tosin2013/mcp-adr-analysis-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server