The HUMMBL MCP Server provides programmatic access to the Base120 framework of 120 validated mental models organized across 6 transformation types (P-Perspective, IN-Inversion, CO-Composition, DE-Decomposition, RE-Recursion, SY-Meta-Systems) for cognitive problem-solving and decision-making.
Core Capabilities:
Retrieve mental models - Get detailed information about specific models by code (e.g., P1, IN3)
List all models - View all 120 models with optional filtering by transformation type
Search models - Find models by keyword across names, descriptions, and codes
AI-powered recommendations - Get tailored model suggestions based on natural language problem descriptions
Explore transformations - Retrieve detailed information about transformation types and their associated models
Search problem patterns - Discover predefined problem patterns with recommended approaches
Access methodology - Retrieve the Self-Dialectical AI Systems methodology and audit model references
URI-based access - Direct access to models, transformations, and documentation via
hummbl://URIs
Click on "Install 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., "@HUMMBL MCP Serverrecommend models for improving team decision-making under uncertainty"
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.
HUMMBL MCP Server
Model Context Protocol server providing access to the HUMMBL Base120 mental models framework.
Overview
HUMMBL Base120 is a comprehensive cognitive framework consisting of 120 validated mental models organized across 6 transformations:
P (Perspective): Change viewpoint to see problems differently
IN (Inversion): Flip problem to find solution by avoiding failure
CO (Composition): Combine elements to create emergent properties
DE (Decomposition): Break down complexity into manageable components
RE (Recursion): Apply patterns at multiple scales and iterations
SY (Meta-Systems): Understand rules, patterns, and systems governing systems
Installation
Global Installation (Recommended)
Using npx (No Installation Required)
Configuration
Claude Desktop
Add to your Claude Desktop configuration file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
get_methodology
Retrieve the canonical Self-Dialectical AI Systems methodology, including all stages and HUMMBL Base120 references.
Example:
audit_model_references
Audit a list of HUMMBL model references for validity, duplication, and transformation alignment.
Example:
After configuration, restart Claude Desktop. The HUMMBL tools will appear in the attachment menu.
Available Tools
get_model
Retrieve detailed information about a specific mental model.
Example:
list_all_models
List all 120 mental models, optionally filtered by transformation type.
Example:
search_models
Search models by keyword across names, descriptions, and examples.
Example:
recommend_models
Get AI-recommended models based on problem description.
Example:
get_transformation
Retrieve information about a specific transformation type and all its models.
Example:
search_problem_patterns
Find pre-defined problem patterns with recommended approaches.
Example:
Usage Examples
Example 1: Getting a Specific Model
Scenario: You want to understand "First Principles Thinking" before applying it to a problem.
When to use: Starting a new problem analysis by identifying core assumptions and fundamentals.
Example 2: Listing Models by Transformation
Scenario: You know you need to look at a problem from different perspectives but want to see all available perspective models.
When to use: Exploring all models within a specific transformation category to find the right approach.
Example 3: Searching for Decision-Related Models
Scenario: You're making a strategic decision and want to find all mental models related to decision-making.
When to use: Finding relevant models across all transformations for a specific concept or challenge.
Example 4: Getting Recommendations for a Complex Problem
Scenario: Your startup is scaling rapidly but systems are breaking down—you need guidance on which mental models to apply.
When to use: You have a complex, multi-faceted problem and need AI-driven recommendations on where to start.
Example 5: Exploring the Inversion Transformation
Scenario: You've heard about "inversion thinking" and want to understand all the models in that category.
When to use: Deep-diving into a transformation to understand its philosophy and available models.
Example 6: Finding Problem Patterns
Scenario: Your team struggles with innovation—everything feels incremental. You want to find pre-defined patterns that match this challenge.
When to use: You recognize a common problem type and want to quickly jump to the recommended mental models and approaches.
Guided Workflows (NEW in Phase 2)
HUMMBL now includes guided multi-turn workflows that walk you through systematic problem-solving using mental models. Perfect for complex problems that benefit from structured analysis.
Available Workflows
1. Root Cause Analysis
Use when: Investigating failures, incidents, or recurring problems Duration: 20-30 minutes Sequence: P → IN → DE → SY
Systematically find root causes, not just symptoms.
2. Strategy Design
Use when: Creating strategies, planning initiatives, entering markets Duration: 30-45 minutes Sequence: P → CO → SY → RE
Design comprehensive strategies with creative combinations and systemic thinking.
3. Decision Making
Use when: High-stakes decisions with uncertainty Duration: 15-25 minutes Sequence: P → IN → SY → RE
Make quality decisions through clear framing, stress-testing, and systematic evaluation.
Workflow Tools
list_workflows
List all available guided workflows.
start_workflow
Begin a guided workflow for your problem.
continue_workflow
Proceed to the next step after completing current step.
find_workflow_for_problem
Discover which workflow best fits your problem.
Example: Root Cause Analysis Workflow
Step 1 (Perspective):
After completing Step 1, continue:
Step 2 (Inversion): Test boundaries, work backward from failure Step 3 (Decomposition): Isolate the failing component Step 4 (Meta-Systems): Design systemic fixes and prevention
Available Resources
Direct URI-based access to models and transformations:
hummbl://model/{code}– Individual model (e.g.,hummbl://model/P1)hummbl://transformation/{type}– All models in transformation (e.g.,hummbl://transformation/P)hummbl://models– Complete Base120 frameworkhummbl://methodology/self-dialectical-ai– Structured Self-Dialectical AI methodology definitionhummbl://methodology/self-dialectical-ai/overview– Markdown overview of the methodology for quick operator reference
Self-Dialectical Methodology Overview
The HUMMBL Self-Dialectical AI Systems methodology (v1.2) enables ethical self-correction via five dialectical stages (thesis, antithesis, synthesis, convergence, meta-reflection) mapped to Base120 mental models plus SY meta-models. Use the tools/resources above to fetch the canonical JSON definition, Markdown overview, or to audit references in external documents.
Problem Patterns
HUMMBL includes pre-defined problem patterns that map common challenges to recommended transformations and models. See Problem Patterns Documentation for the complete catalog with detailed guidance.
Problem Patterns
HUMMBL includes pre-defined problem patterns that map common challenges to recommended transformations and models. See Problem Patterns Documentation for the complete catalog with detailed guidance.
Development
Setup
Build
Run Locally
Type Checking
Architecture
License
MIT © HUMMBL, LLC
Version
1.0.0-beta.1