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
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:
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.
Development
Setup
Build
Run Locally
Type Checking
Architecture
License
MIT © HUMMBL, LLC
Version
1.0.0-beta.1