@wemake.cx/decision-framework
v0.4.6
Published
MCP server for diagrammatic thinking and spatial representation
Readme
Decision Framework MCP Server
A detailed tool for structured decision analysis and rational choice. This tool helps models systematically evaluate options, criteria, and outcomes using multiple decision frameworks.
Core Concepts
Decision Components
The decision framework operates on several key components:
- Options: Available alternatives or choices
- Criteria: Standards for evaluating options
- Outcomes: Possible results with probabilities and values
- Stakeholders: People or groups affected by the decision
- Constraints: Limitations on the decision
Example option:
{
"id": "option_a",
"name": "Cloud Migration",
"description": "Migrate existing infrastructure to cloud platform"
}Decision Analysis Types
The server supports multiple analysis frameworks:
- Expected Utility: Probability-weighted value calculations
- Multi-Criteria: Weighted scoring across multiple criteria
- Maximin: Choose option with best worst-case outcome
- Minimax Regret: Minimize maximum regret across scenarios
- Satisficing: Find first option meeting minimum criteria
Evaluation Process
Decisions progress through structured stages:
- Problem Definition: Clear statement of decision to be made
- Options: Identification of available alternatives
- Criteria: Definition of evaluation standards
- Evaluation: Scoring options against criteria
- Analysis: Application of decision framework
- Recommendation: Final recommendation with justification
API
Tools
- decisionFramework
- Systematic decision analysis and rational choice evaluation
- Input: Comprehensive decision analysis data structure
decisionStatement(string): Clear statement of the decision to be madeoptions(array): Available options or alternatives- Each option contains:
id(string): Unique identifiername(string): Option namedescription(string): Detailed description
- Each option contains:
criteria(array): Criteria for evaluating options- Each criterion contains:
id(string): Unique identifiername(string): Criterion namedescription(string): Detailed descriptionweight(number): Importance weight (0.0-1.0)evaluationMethod(enum): "quantitative" | "qualitative" | "boolean"
- Each criterion contains:
criteriaEvaluations(array): Evaluations of options against criteria- Each evaluation contains:
criterionId(string): Reference to criterionoptionId(string): Reference to optionscore(number): Score (0.0-1.0)justification(string): Reasoning for the score
- Each evaluation contains:
possibleOutcomes(array): Possible outcomes with probabilities- Each outcome contains:
id(string): Unique identifierdescription(string): Outcome descriptionprobability(number): Likelihood (0.0-1.0)optionId(string): Associated optionvalue(number): Utility valueconfidenceInEstimate(number): Confidence level (0.0-1.0)
- Each outcome contains:
informationGaps(array): Missing information affecting the decisionstakeholders(string[]): Affected partiesconstraints(string[]): Decision limitationstimeHorizon(string): Decision timeframeriskTolerance(enum): "risk-averse" | "risk-neutral" | "risk-seeking"analysisType(enum): Type of analysis to performstage(enum): Current stage of decision processiteration(number): Current iteration numbernextStageNeeded(boolean): Whether further analysis is required
- Returns structured decision analysis with recommendations
- Supports iterative refinement through multiple stages
Setup
bunx
{
"mcpServers": {
"Decision Framework": {
"command": "bunx",
"args": ["@wemake.cx/decision-framework@latest"]
}
}
}bunx with custom settings
The server can be configured using the following environment variables:
{
"mcpServers": {
"Decision Framework": {
"command": "bunx",
"args": ["@wemake.cx/decision-framework@latest"],
"env": {
"DECISION_MAX_OPTIONS": "10",
"DECISION_MAX_CRITERIA": "15",
"DECISION_MIN_CONFIDENCE": "0.1"
}
}
}
}DECISION_MAX_OPTIONS: Maximum number of options per decision (default: 20)DECISION_MAX_CRITERIA: Maximum number of criteria per decision (default: 20)DECISION_MIN_CONFIDENCE: Minimum confidence threshold for outcomes (default: 0.0)
System Prompt
The prompt for utilizing decision framework should encourage systematic analysis:
Follow these steps for structured decision making:
1. Problem Definition:
- Clearly articulate the decision to be made
- Identify the decision maker and key stakeholders
- Define the time horizon and constraints
- Establish the context and background
2. Option Generation:
- Brainstorm comprehensive list of alternatives
- Include creative and unconventional options
- Ensure options are mutually exclusive and collectively exhaustive
- Document assumptions and feasibility constraints
3. Criteria Development:
- Identify all relevant evaluation criteria
- Assign appropriate weights based on importance
- Choose suitable evaluation methods for each criterion
- Validate criteria with stakeholders
4. Systematic Evaluation:
- Score each option against every criterion
- Provide clear justification for scores
- Consider uncertainty and confidence levels
- Document key assumptions and trade-offs
5. Analysis and Recommendation:
- Apply appropriate decision analysis framework
- Conduct sensitivity analysis on key parameters
- Identify information gaps and their impact
- Provide clear recommendation with rationale
6. Implementation Planning:
- Consider implementation challenges and risks
- Develop contingency plans for key uncertainties
- Establish monitoring and review mechanisms
- Plan for decision communication and buy-in