MCP Adr Analysis Server

ADR drift detection, content safety, and decision memory for architectural decisions

Connector by tosin2013 · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 35

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/tosin2013-mcp-adr-analysis-server

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

ADR drift detection, content safety, and decision memory for architectural decisions

Use cases: documentation, code-review

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools: 38 read · 25 write · 1 delete
Secrets: 1 (API keys, tokens or passwords)
Install scripts: None found
Runs as: Node.js package

Tools by what they do 64

Read from the source code; the running server may list different tools.

Read 38 · Look things up without changing anything.

analyze_adr_timeline
analyze_content_security
analyze_deployment_progress
analyze_environment
analyze_gaps
analyze_project_ecosystem
bootstrap_validation_loop
compare_adr_progress
deployment_readiness
discover_existing_adrs
expand_analysis_section
get_adr_context

Show 26 more tools

get_adr_diagrams
get_adr_priorities
get_adr_templates
get_architectural_context
get_conversation_snapshot
get_development_guidance
get_gaps
get_knowledge_graph
get_memory_stats
get_server_context
get_staleness_report
get_workflow_guidance
perform_research
query_conversation_history
release_tracking
review_existing_adrs
search_codebase
search_tools
smart_score
suggest_adrs
troubleshoot_guided_workflow
validate_adr
validate_adr_compliance
validate_all_adrs
validate_content_masking
validate_rules

Write 25 · Create, change, send or run things.

apply_basic_content_masking
configure_custom_patterns
configure_output_masking
create_research_template
create_rule_set
expand_memory
generate_adr_bootstrap
generate_adr_from_decision
generate_adr_todo
generate_adrs_from_prd
generate_content_masking
generate_deployment_guidance

Show 13 more tools

generate_research_questions
generate_rules
incorporate_research
interactive_adr_planning
manage_cache
mcp_planning
memory_loading
request_action_confirmation
set_project_path
sync_to_aggregator
tool_chain_orchestrator
update_implementation_status
update_knowledge

Delete 1 · Delete, drop, revoke or wipe things.

smart_git_push

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

OPENROUTER_API_KEY

Other settings (environment variables or headers).

ADR_DIRECTORY
EXECUTION_MODE
PROJECT_PATH

Files it touches

/opt/homebrew/bin/rg
/private/tmp
/private/var/folders
/tmp/link-check-config.json
/Users/tosinakinosho/workspaces/mcp-adr-analysis-server/dist/src/index.js
/var/folders
/var/run/docker.sock
/var/tmp
Any path the agent passes to its tools

Tools (64)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

analyze_adr_timelineAnalyze ADR Timelineread-only
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.
analyze_content_securityAnalyze Content Securityread-only
Analyze content for sensitive information using AI-powered detection with optional memory integration for security pattern learning
analyze_deployment_progressAnalyze Deployment Progressread-only
Analyze deployment progress and verify completion with outcome rules
analyze_environmentAnalyze Environmentread-only
Analyze environment context and provide optimization recommendations with optional memory integration for environment snapshot tracking
analyze_gapsAnalyze Gapsread-only
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.
analyze_project_ecosystemAnalyze Project Ecosystemread-only
Comprehensive recursive project ecosystem analysis with advanced prompting techniques (Knowledge Generation + Reflexion)
apply_basic_content_maskingApply Basic Content Masking
Apply basic content masking (fallback when AI is not available)
bootstrap_validation_loopBootstrap Validation Loopread-only
**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 t…
compare_adr_progressCompare ADR Progressread-only
Compare TODO.md progress against ADRs and current environment to validate implementation status
configure_custom_patternsConfigure Custom Patterns
Configure custom sensitive patterns for a project
configure_output_maskingConfigure Output Masking
Configure content masking for all MCP outputs
create_research_templateCreate Research Template
Create a research template file for documenting findings
create_rule_setCreate Rule Set
Create machine-readable rule set in JSON/YAML format
deployment_readinessCheck Deployment Readinessread-only
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.
discover_existing_adrsDiscover Existing ADRsread-only
Discover and catalog existing ADRs in the project

Show 49 more tools

expand_analysis_sectionExpand Analysis Sectionread-only
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.
expand_memoryExpand Memory
Phase 3: Retrieve and expand stored content from a tiered response using its expandable ID
generate_adr_bootstrapGenerate ADR Bootstrap
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.
generate_adr_from_decisionGenerate ADR from Decision
Generate a complete ADR from decision data. TIP: Reference @.mcp-server-context.md to align with existing architectural patterns and decisions.
generate_adr_todoGenerate ADR Todo
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.
generate_adrs_from_prdGenerate ADRs from PRD
Generate Architectural Decision Records from a Product Requirements Document with advanced prompting techniques (APE + Knowledge Generation)
generate_content_maskingGenerate Content Masking
Generate masking instructions for detected sensitive content
generate_deployment_guidanceGenerate Deployment Guidance
Generate deployment guidance and instructions from ADRs with environment-specific configurations
generate_research_questionsGenerate Research Questions
Generate context-aware research questions and create research tracking system
generate_rulesGenerate Rules
Generate architectural rules from ADRs and code patterns
get_adr_contextGet ADR Contextread-only
Fetch ADR context from ADR Aggregator including summaries, diagrams, timeline data, and code links. Useful for getting a consolidated view of architectural decisions.
get_adr_diagramsGet ADR Diagramsread-only
Get Mermaid diagrams for ADRs from ADR Aggregator. Includes workflow, relationship, and impact diagrams. Requires Pro+ tier.
get_adr_prioritiesGet ADR Prioritiesread-only
Get ADR priorities for roadmap and backlog planning from ADR Aggregator. Returns prioritized ADRs with scores, dependencies, blockers, implementation status, and gap counts.
get_adr_templatesGet ADR Templatesread-only
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_architectural_contextGet Architectural Contextread-only
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
get_conversation_snapshotGet Conversation Snapshotread-only
Phase 3: Get current conversation context snapshot for resumption or analysis
get_development_guidanceGet Development Guidanceread-only
Get comprehensive development guidance that translates architectural decisions and workflow recommendations into specific coding tasks, implementation patterns, and development roadmap
get_gapsGet Gapsread-only
Get current code gaps from ADR Aggregator. Returns gaps with their status (open, dismissed, resolved) for tracking and management.
get_knowledge_graphGet Knowledge Graphread-only
Get cross-repository knowledge graph from ADR Aggregator with analytics and insights. Visualize ADR relationships across repositories. Requires Team tier.
get_memory_statsGet Memory Statsread-only
Phase 3: Get statistics about stored conversation memory
get_server_contextGet Server Contextread-only
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 to give LLMs instant awareness of the server.
get_staleness_reportGet Staleness Reportread-only
Get ADR staleness report from ADR Aggregator with review compliance metrics. Identifies stale ADRs that need attention and provides governance insights.
get_workflow_guidanceGet Workflow Guidanceread-only
Get intelligent workflow guidance and tool recommendations based on your goals and project context to achieve expected outcomes efficiently
incorporate_researchIncorporate Research
Incorporate research findings into architectural decisions
interactive_adr_planningInteractive ADR Planning
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.
manage_cacheManage Cache
Manage MCP resource cache (clear, stats, cleanup)
mcp_planningMCP Planning
Enhanced project planning and workflow management tool - phase-based project management, team resource allocation, progress tracking, risk analysis, and executive reporting
memory_loadingLoad Memory
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.
perform_researchPerform Researchread-only
Perform research using cascading sources: project files → session/tool-usage tracker → environment resources → web search (fallback)
query_conversation_historyQuery Conversation Historyread-only
Phase 3: Search and retrieve conversation sessions based on filters
release_trackingTrack Releasesread-only
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.
request_action_confirmationRequest Action Confirmation
Request confirmation before applying research-based changes
review_existing_adrsReview Existing ADRsread-only
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.
search_codebaseSearch Codebaseread-only
Atomic tool for searching codebase files based on query patterns. Returns raw file matches with relevance scores. Extracted from ResearchOrchestrator per ADR-018.
search_tools
[DEPRECATED host-native, ADR-023] 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.
set_project_pathSet Project Path
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.
smart_git_pushSmart Git Pushcan change or delete data
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.
smart_scoreSmart Scoreread-only
Central coordination for project health scoring system - recalculate, sync, diagnose, optimize, and reset scores across all MCP tools
suggest_adrsSuggest ADRsread-only
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.
sync_to_aggregatorSync to Aggregator
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.
tool_chain_orchestratorTool Chain Orchestrator
AI-powered dynamic tool sequencing - intelligently analyze user requests and generate structured tool execution plans
troubleshoot_guided_workflowTroubleshoot Guided Workflowread-only
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
update_implementation_statusUpdate Implementation Status
Update the implementation status of synced ADRs directly from the IDE. Supports statuses: not_started, in_progress, implemented, deprecated, blocked. Requires Pro+ tier.
update_knowledgeUpdate Knowledge
ADR-018: Simple CRUD operations for project session state. Not a graph database — keyword retrieval over local JSON snapshots. Add/remove entities (intents, ADRs, tools, code) and relationships. Use knowledge://graph resource to read current state (zero token cost).
validate_adrValidate ADRread-only
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_adr_complianceValidate ADR Complianceread-only
Validate ADR compliance against implementation via ADR Aggregator. Checks that code actually implements documented decisions. Requires Pro+ tier.
validate_all_adrsValidate All ADRsread-only
Validate all ADRs in a directory against actual infrastructure reality
validate_content_maskingValidate Content Maskingread-only
Validate that content masking was applied correctly
validate_rulesValidate Rulesread-only
Validate code against architectural rules

Signals

Stars: 35
Forks: 13
Open issues: 12
Contributors: 6
Last commit: Oct 23, 2026 (5 days ago)
Last release: Sep 17, 2026 (1 month ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name: io.github.tosin2013/mcp-adr-analysis-server
Version: 2.14.13
Auth: API key
Packages: npm mcp-adr-analysis-server
License: MIT
Repository: github.com/tosin2013/mcp-adr-analysis-server
First seen: Oct 24, 2026
Last checked: Oct 24, 2026
Source: Official MCP Registry github-graphql