io.github.tosin2013/mcp-adr-analysis-server
NPM · MCP-ADR-ANALYSIS-SERVER · SCANNED AUG 3
AI-powered MCP server for analyzing Architectural Decision Records (ADRs).
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →
Supply Chain Security88
- No malware found by supply-chain analysis.Pass
- Only part of the dependency tree could be resolved (149 of 150), so this covers what we could see, not the whole tree.Partial
- No install/post-install scripts declared.Pass
- Only part of the dependency tree could be resolved (149 of 150), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency97
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to tosin2013/mcp-adr-analysis-server). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 55 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability63
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (poor).Fail
- Context-footprint check failed: tool/resource definitions use about 10378 tokens (~102/item across 101 items; 75 tools + 26 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management23
- Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
npm · mcp-adr-analysis-server
claude mcp add tosin2013-mcp-adr-analysis-server -- npx -y mcp-adr-analysis-server
codex mcp add tosin2013-mcp-adr-analysis-server -- npx -y mcp-adr-analysis-server
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"tosin2013-mcp-adr-analysis-server": {
"type": "local",
"command": [
"npx",
"-y",
"mcp-adr-analysis-server"
],
"enabled": true
}
}
} openclaw mcp add tosin2013-mcp-adr-analysis-server --command npx --arg -y --arg mcp-adr-analysis-server
mcp_servers:
tosin2013-mcp-adr-analysis-server:
command: "npx"
args: ["-y", "mcp-adr-analysis-server"] {
"mcpServers": {
"tosin2013-mcp-adr-analysis-server": {
"command": "npx",
"args": [
"-y",
"mcp-adr-analysis-server"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 3 Aug 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.
- 2 Aug 26 +50
- Install scripts: unverified → pass ▲ security
- Provenance: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- The attested source repository moved: tosin2013/mcp-adr-analysis-server security
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Stability: unverified → 0.20 ▲ functional
- Maintenance: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Schema quality: unverified → poor ▲ functional
- Licence: MIT functional
- 31 Jul 26 −27
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 30 Jul 26 +28
- Dependency health: partial → unverified ▼ functional
- Schema quality: unverified → 100 ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- 28 Jul 26 −28
- Tool coverage: 100 → unverified ▼ functional
- Schema quality: 100 → unverified ▼ functional
- Dependency health: unverified → partial ▲ functional
- 27 Jul 26 53
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Analysed npm/[email protected]
Provenance verified
Ecosystem: npm · Outcome: verified
Reason: verified
- Source repo:
- tosin2013/mcp-adr-analysis-server
- Certificate issuer:
- https://token.actions.githubusercontent.com
- Certificate SAN:
- https://github.com/tosin2013/mcp-adr-analysis-server/.github/workflows/publish.yml@refs/tags/v2.6.9
- Rekor log index:
- 1756529168
- Predicate type:
- https://slsa.dev/provenance/v1
- Subject digest:
- sha512:3344b60c153fff19c51caaa511897f829e1e8df434a1759bbf9c883f0774c0127333bb4460626b296df09d3b97b940fa27a2d172278ab81ee273db58a
- Discovery method:
- attestation_endpoint
Dependencies 149 packages
149 packages in the resolved dependency tree · 143 deprecated · 43 stale.
The dependency tree was only partially resolved, so these counts may be incomplete.
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
memory_loading ~115
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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | — | Memory operation to perform |
| entityId | string | — | Entity ID for get_entity and find_related actions |
| forceReload | boolean | — | Force reload of ADRs (load_adrs action) |
| maxDepth | number | — | Maximum depth for relationship traversal (find_related action) |
| query | object | — | Query parameters for entity search |
No output schema declared.
No examples provided.
perform_research ~102
Perform research using cascading sources: project files → knowledge graph → environment resources → web search (fallback)
| Name | Type | Req | Description |
|---|---|---|---|
| adrDirectory | string | — | Directory containing ADR files |
| confidenceThreshold | number | — | Minimum confidence threshold (0-1) before suggesting web search |
| performWebSearch | boolean | — | Enable web search recommendations when confidence is low |
| projectPath | string | — | Path to project directory |
| question | string | yes | The research question to answer |
No output schema declared.
No examples provided.
query_conversation_history ~87
Phase 3: Search and retrieve conversation sessions based on filters
| Name | Type | Req | Description |
|---|---|---|---|
| dateRange | object | — | Filter by date range |
| keyword | string | — | Search keyword in conversation turns |
| limit | number | — | Maximum number of sessions to return |
| projectPath | string | — | Filter by project path |
| toolsUsed | array | — | Filter by tools used in the session |
No output schema declared.
No examples provided.
read_directory ~47
List files and folders in a directory. Use this to explore the file structure within accessible roots.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | Directory path to list (relative to project root or absolute within roots) |
No output schema declared.
No examples provided.
read_file ~46
Read contents of a file
| Name | Type | Req | Description |
|---|---|---|---|
| filePath | string | — | Path to the file to read |
| path | string | — | Path to the file to read (alias for filePath) |
No output schema declared.
No examples provided.
release_tracking ~397
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.
| Name | Type | Req | Description |
|---|---|---|---|
| compareFrom | string | — | Starting version for comparison |
| compareTo | string | — | Ending version for comparison |
| createGithubRelease | boolean | — | Create a GitHub Release (requires gh CLI) |
| format | string | — | Changelog output format |
| groupByAdr | boolean | — | Group changelog entries by ADR |
| includeAdrLinks | boolean | — | Include ADR references in changelog |
| includeCommitHashes | boolean | — | Include commit hashes in output |
| includeReadiness | boolean | — | Include release readiness score |
| includeTimeline | boolean | — | Include mermaid timeline diagram |
| localOnly | boolean | — | For create_milestone: persist locally instead of calling gh CLI. Useful when gh auth is unavailable. |
| milestoneDescription | string | — | GitHub milestone description |
| milestoneDueDate | string | — | Milestone due date (YYYY-MM-DD) |
| milestoneTitle | string | — | GitHub milestone title (for create_milestone) |
| operation | string | yes | Operation to perform |
| projectPath | string | — | Project root path (defaults to current working directory) |
| releasePlanPath | string | — | Path to RELEASE_PLAN.md (relative to projectPath). |
| syncGithubMilestones | boolean | — | Sync milestones to GitHub (requires gh CLI) |
| updateTodo | boolean | — | Update TODO.md with milestone status |
| version | string | — | Release version to track (e.g., v2.3.0) |
| writeReleasePlan | boolean | — | For create_milestone/push_local_milestones: also render local milestones into RELEASE_PLAN.md (bounded section). |
| writeToFile | boolean | — | Write CHANGELOG.md to repo |
No output schema declared.
No examples provided.
request_action_confirmation ~55
Request confirmation before applying research-based changes
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | Description of the action to be performed |
| details | string | yes | Detailed information about the action |
| impact | string | — | Impact level of the action |
No output schema declared.
No examples provided.
review_existing_adrs ~159
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.
| Name | Type | Req | Description |
|---|---|---|---|
| adrDirectory | string | — | Directory containing ADR files |
| analysisDepth | string | — | Depth of analysis to perform |
| conversationContext | object | — | Rich context from the calling LLM about user goals and discussion history |
| generateUpdatePlan | boolean | — | Generate action plan for updating non-compliant ADRs |
| includeTreeSitter | boolean | — | Use tree-sitter for enhanced code analysis |
| projectPath | string | — | Path to the project directory |
| specificAdr | string | — | Specific ADR filename or title to review (optional) |
No output schema declared.
No examples provided.
search_codebase ~151
Atomic tool for searching codebase files based on query patterns. Returns raw file matches with relevance scores. Extracted from ResearchOrchestrator per ADR-018.
| Name | Type | Req | Description |
|---|---|---|---|
| enableTreeSitter | boolean | — | Use tree-sitter for enhanced analysis |
| includeContent | boolean | — | Include file content in results |
| maxFiles | number | — | Maximum files to return |
| projectPath | string | — | Path to project root |
| query | string | yes | Search query (e.g., "Docker configuration", "authentication") |
| relevanceThreshold | number | — | Minimum relevance threshold (0-1) |
| scope | array | — | Optional file scope patterns (e.g., ["src/**", "config/**"]) |
No output schema declared.
No examples provided.
search_tools ~147
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.
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | — | Filter tools by category |
| cemcpOnly | boolean | — | Only return tools with CE-MCP directive support (more token-efficient) |
| complexity | string | — | Filter by tool complexity level |
| includeSchema | boolean | — | Include full input schemas in response (increases token count) |
| limit | number | — | Maximum number of tools to return |
| query | string | — | Search query to match tool names, descriptions, and keywords |
No output schema declared.
No examples provided.
set_project_path ~96
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.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | Absolute path to the project directory. Must be an existing directory. |
| validatePath | boolean | — | Whether to validate that the path exists and is a directory (default: true) |
No output schema declared.
No examples provided.
smart_git_push ~166
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.
| Name | Type | Req | Description |
|---|---|---|---|
| branch | string | — | Target branch for push (optional, uses current branch if not specified) |
| dryRun | boolean | — | Show what would be pushed without actually pushing |
| forceUnsafe | boolean | — | Override security blocks and test failures (DANGEROUS) |
| message | string | — | Commit message (optional, commits staged files if provided) |
| projectPath | string | — | Path to project directory (defaults to current working directory) |
| skipSecurity | boolean | — | Skip security scanning (NOT RECOMMENDED) |
| testResults | object | — | Test results from AI-executed tests (required for proper deployment tracking) |
No output schema declared.
No examples provided.
smart_score ~343
Central coordination for project health scoring system - recalculate, sync, diagnose, optimize, and reset scores across all MCP tools
| Name | Type | Req | Description |
|---|---|---|---|
| analysisMode | string | — | Method for weight optimization (for optimize_weights operation) |
| checkDataFreshness | boolean | — | Validate data freshness across tools (for diagnose_scores operation) |
| component | string | — | Score component to reset (for reset_scores operation) |
| components | array | — | Score components to recalculate (for recalculate_scores operation) |
| customWeights | object | — | Custom weight overrides (for optimize_weights operation) |
| forceUpdate | boolean | — | Force update even if data is fresh |
| includeHistory | boolean | — | Include score history analysis (for diagnose_scores operation) |
| intentId | string | — | Intent ID to get score trends for (for get_intent_scores operation) |
| operation | string | yes | Smart scoring operation to perform |
| preserveHistory | boolean | — | Preserve score history in backup (for reset_scores operation) |
| previewOnly | boolean | — | Preview changes without applying (for optimize_weights operation) |
| projectPath | string | yes | Path to project directory |
| rebalanceWeights | boolean | — | Recalculate optimal scoring weights (for sync_scores operation) |
| recalculateAfterReset | boolean | — | Immediately recalculate after reset (for reset_scores operation) |
| suggestImprovements | boolean | — | Provide score improvement suggestions (for diagnose_scores operation) |
| todoPath | string | — | Path to TODO.md file (for sync_scores operation) |
| triggerTools | array | — | Tools to trigger for fresh data (for sync_scores operation) |
| updateSources | boolean | — | Trigger source tool updates before recalculating |
No output schema declared.
No examples provided.
suggest_adrs ~226
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.
| Name | Type | Req | Description |
|---|---|---|---|
| afterCode | string | — | Code after changes (for code_changes analysis) |
| analysisType | string | — | Type of analysis to perform |
| beforeCode | string | — | Code before changes (for code_changes analysis) |
| changeDescription | string | — | Description of the changes (for code_changes analysis) |
| commitMessages | array | — | Related commit messages (for code_changes analysis) |
| conversationContext | object | — | Rich context from the calling LLM about user goals and discussion history |
| enhancedMode | boolean | — | Enable advanced prompting features (Knowledge Generation + Reflexion) |
| existingAdrs | array | — | List of existing ADR titles to avoid duplication |
| knowledgeEnhancement | boolean | — | Enable Knowledge Generation for domain-specific insights |
| learningEnabled | boolean | — | Enable Reflexion learning from past experiences |
| projectPath | string | — | Path to the project directory |
No output schema declared.
No examples provided.
sync_to_aggregator ~173
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.
| Name | Type | Req | Description |
|---|---|---|---|
| adr_paths | array | — | Specific ADR paths to sync (syncs all if not provided) |
| full_sync | boolean | — | Replace all ADRs instead of incremental sync |
| include_code_links | boolean | — | Include AST-based code links (Pro+ tier) |
| include_diagrams | boolean | — | Include Mermaid diagrams (Pro+ tier) |
| include_metadata | boolean | — | Include analysis metadata in sync |
| include_security_scan | boolean | — | Include security scan results |
| include_timeline | boolean | — | Include timeline/staleness data |
| projectPath | string | — | Project path (defaults to PROJECT_PATH) |
No output schema declared.
No examples provided.
tool_chain_orchestrator ~119
AI-powered dynamic tool sequencing - intelligently analyze user requests and generate structured tool execution plans
| Name | Type | Req | Description |
|---|---|---|---|
| allowParallel | boolean | — | Allow parallel execution of independent steps |
| availableTools | array | — | List of available MCP tools to orchestrate |
| contextHints | array | — | Additional context hints for better plan generation |
| executionMode | string | — | Orchestration mode |
| maxSteps | number | — | Maximum number of steps in the execution plan |
| userRequest | string | yes | User request to analyze and create tool execution plan for |
No output schema declared.
No examples provided.
troubleshoot_guided_workflow ~202
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
| Name | Type | Req | Description |
|---|---|---|---|
| adrDirectory | string | — | ADR directory path |
| conversationContext | object | — | Rich context from the calling LLM about user goals and discussion history |
| enableAdrSuggestion | boolean | — | Enable automatic ADR suggestion based on recurring failures |
| enableMemoryIntegration | boolean | — | Enable memory entity storage for troubleshooting session tracking and pattern recognition |
| enablePatternRecognition | boolean | — | Enable automatic pattern recognition and failure classification |
| enableResearchGeneration | boolean | — | Enable automatic research question generation for persistent problems |
| failure | object | — | Structured failure information (required for analyze_failure and generate_test_plan) |
| operation | string | yes | Type of troubleshooting operation |
| projectPath | string | — | Path to project directory (optional) |
| todoPath | string | — | Path to TODO.md file |
No output schema declared.
No examples provided.
update_implementation_status ~72
Update the implementation status of synced ADRs directly from the IDE. Supports statuses: not_started, in_progress, implemented, deprecated, blocked. Requires Pro+ tier.
| Name | Type | Req | Description |
|---|---|---|---|
| projectPath | string | — | Project path (defaults to PROJECT_PATH) |
| updates | array | yes | Array of ADR status updates to apply |
No output schema declared.
No examples provided.
update_knowledge ~157
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).
| Name | Type | Req | Description |
|---|---|---|---|
| entity | string | — | Entity ID (for add_entity/remove_entity operations) |
| entityType | string | — | Type of entity (required for add_entity operation) |
| metadata | object | — | Additional metadata for the entity or relationship |
| operation | string | yes | Type of operation to perform on the knowledge graph |
| relationship | string | — | Relationship type (for add_relationship/remove_relationship) |
| source | string | — | Source node ID (for relationship operations) |
| target | string | — | Target node ID (for relationship operations) |
No output schema declared.
No examples provided.
validate_adr ~115
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.
| Name | Type | Req | Description |
|---|---|---|---|
| adrDirectory | string | — | Directory containing ADR files |
| adrPath | string | yes | Path to the ADR file to validate (relative or absolute) |
| confidenceThreshold | number | — | Minimum research confidence threshold (0-1) |
| includeEnvironmentCheck | boolean | — | Include live environment verification in validation |
| projectPath | string | — | Path to the project directory |
No output schema declared.
No examples provided.
validate_adr_compliance ~75
Validate ADR compliance against implementation via ADR Aggregator. Checks that code actually implements documented decisions. Requires Pro+ tier.
| Name | Type | Req | Description |
|---|---|---|---|
| adr_paths | array | — | Specific ADR paths to validate |
| projectPath | string | — | Project path (defaults to PROJECT_PATH) |
| validation_type | string | — | Type of validation to perform |
No output schema declared.
No examples provided.
validate_all_adrs ~79
Validate all ADRs in a directory against actual infrastructure reality
| Name | Type | Req | Description |
|---|---|---|---|
| adrDirectory | string | — | Directory containing ADR files |
| includeEnvironmentCheck | boolean | — | Include live environment verification in validation |
| minConfidence | number | — | Minimum research confidence for validation (0-1) |
| projectPath | string | — | Path to the project directory |
No output schema declared.
No examples provided.
validate_content_masking ~41
Validate that content masking was applied correctly
| Name | Type | Req | Description |
|---|---|---|---|
| maskedContent | string | yes | Content after masking |
| originalContent | string | yes | Original content before masking |
No output schema declared.
No examples provided.
validate_rules ~97
Validate code against architectural rules
| Name | Type | Req | Description |
|---|---|---|---|
| fileContent | string | — | Content to validate (alternative to filePath) |
| fileName | string | — | Name of file being validated (when using fileContent) |
| filePath | string | — | Path to file to validate |
| reportFormat | string | — | Format for validation report |
| rules | array | yes | Rules to validate against |
| validationType | string | — | Type of validation to perform |
No output schema declared.
No examples provided.
write_file ~40
Write content to a file
| Name | Type | Req | Description |
|---|---|---|---|
| content | string | yes | Content to write to the file |
| path | string | yes | Path to the file to write |
No output schema declared.
No examples provided.