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)

npm install -g @hummbl/mcp-server

Using npx (No Installation Required)

npx @hummbl/mcp-server

Configuration

Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "hummbl": { "command": "npx", "args": ["-y", "@hummbl/mcp-server"] } } }

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:

{ "code": "P1" }

`list_all_models`

List all 120 mental models, optionally filtered by transformation type.

Example:

{ "transformation_filter": "P" }

`search_models`

Search models by keyword across names, descriptions, and examples.

Example:

{ "query": "decision" }

`recommend_models`

Get AI-recommended models based on problem description.

Example:

{ "problem_description": "Our startup is growing rapidly but systems are breaking down. We need to scale operations without losing quality." }

`get_transformation`

Retrieve information about a specific transformation type and all its models.

Example:

{ "type": "IN" }

`search_problem_patterns`

Find pre-defined problem patterns with recommended approaches.

Example:

{ "query": "innovation" }

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 framework

Development

Setup

git clone https://github.com/hummbl-dev/mcp-server.git cd mcp-server npm install

Build

npm run build

Run Locally

npm run dev

Type Checking

npm run typecheck

Architecture

src/ ├── index.ts # stdio entry point ├── server.ts # Server configuration ├── framework/ │ └── base120.ts # Complete mental models database ├── tools/ │ └── models.ts # Tool registrations ├── resources/ │ └── models.ts # Resource endpoints ├── types/ │ └── domain.ts # Core type definitions └── utils/ └── result.ts # Result pattern utilities

License

Version

1.0.0-beta.1

Deploy Server

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Provides access to the HUMMBL Base120 framework of 120 validated mental models organized across 6 transformations, enabling users to search, retrieve, and get AI-recommended mental models for problem-solving and decision-making.

Related Resources

Reddit Discussion about this server

HUMMBL MCP Server

HUMMBL MCP Server

Overview

Installation

Global Installation (Recommended)

Using npx (No Installation Required)

Configuration

Claude Desktop

Available Tools

`get_model`

`list_all_models`

`search_models`

`recommend_models`

`get_transformation`

`search_problem_patterns`

Available Resources

Development

Setup

Build

Run Locally

Type Checking

Architecture

License

Version

Tools

Related Resources

New MCP Servers

MCP directory API