# Causal Mechanism Registry

> Causal Mechanism Registry is a free MCP server for knowledge and memory. A versioned registry of named causal mechanisms behind historical crises. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API
- **Website:** https://adenkarabal.com
- **Repository:** https://github.com/adenkarabal/causal-mechanism-registry
- **MCP Registry name:** io.github.adenkarabal/causal-mechanism-registry
- **Categories:** knowledge and memory
- **Listing updated:** 2026-11-14

## About

The registry comes from adenkarabal, a research project that takes crises apart into recurring processes it calls mechanisms. Each mechanism has a name, definition, scope, boundary and test, so people and AI models can describe a bank run or a quarantine regime in the same words. The vocabulary is described as open and free.

Its examples span centuries: Insull's buyback in 1930 Chicago, Tang commanders given more troops in the 880s, Mobutu's weakened army in Zaire, plague quarantine at Ragusa in 1377, and the Refco bankruptcy in 2005 where customer assets sat apart so the failure did not spread. The list runs from a Mesopotamian debt cancellation around 2400 BC to the Valencia flood of 2024.

A separate publication, the Pano, publishes dated pictures of which processes are active now. It is moving to quarterly editions.

## Features

- **Named mechanisms:** Each has definition, scope, boundary and test.
- **Versioned registry:** The vocabulary changes in tracked versions.
- **Shared vocabulary:** Connects events described in different words.
- **Wide time range:** Cases from 2400 BC to 2024.
- **Chains and walls:** Tracks how crises chain and where chains stop.
- **Remote endpoint:** Streamable HTTP at adenkarabal.com/mcp.

## Good for

- Name the process behind a financial crisis
- Compare a modern bank failure to an older one
- Ground an essay on crises in sourced concepts
- Look for where a historical chain stopped

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http causal-mechanism-registry https://adenkarabal.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://adenkarabal.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "causal-mechanism-registry": {
      "url": "https://adenkarabal.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "causal-mechanism-registry": {
      "type": "http",
      "url": "https://adenkarabal.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "causal-mechanism-registry": {
      "serverUrl": "https://adenkarabal.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "causal-mechanism-registry": {
      "type": "http",
      "url": "https://adenkarabal.com/mcp"
    }
  }
}
```

## Tools

- `search_mechanisms`: Search the registry by name, identifier or a word in the definition, scope, boundary or test. Returns matching entries with id, name, layer, kind, review state, name_test and the first sentence of the definition. A term matches the start of a word, terms shorter than 2 characters are ignored and listed in the note. An entry matching every term ranks first; if none does, the closest partial matches
- `get_mechanism`: Read one published entry in full: definition, scope, boundary, distinguishing test, related identifiers, phase roles and status fields, with its versioned GitHub address and a citation line. Does not filter by review state; the requested identifier always returns. An unknown or retired identifier is an error that names the replacement or the closest identifiers. Entries describe processes in gener
- `resolve_name`: Turn a display name, an identifier or a retired identifier into the current identifier (for example export_pressure becomes export_earnings_shock). If nothing matches it says so and returns the closest three candidates.
- `list_mechanisms`: List entries with identifier, name, layer, kind and review state, optionally by layer and review state. The default lists every entry; with review=accepted the response states how many entries in review are not shown.
- `cite`: Return the recommended citation line for a version, its version DOI (if it has one), the DOI that covers all versions, and the licence.
- `list_versions`: List the published registry versions with release dates, version DOIs, entry counts and changes (kinds, the summary from CHANGELOG.md, the number of change items and a link to them). The first listed with default true is used when a version is not given.
- `search`: Search the registry; returns results with id, title and url. A thin wrapper over search_mechanisms for connectors that expect a search and a fetch tool. It looks in all review states and marks entries in review in the title. Entries describe processes in general, not the present state of any country, market or asset.
- `fetch`: Fetch one entry by identifier as text with its url and metadata. A thin wrapper over get_mechanism for connectors that expect a search and a fetch tool. Entries describe processes in general, not the present state of any country, market or asset.

## FAQ

### What is a mechanism?

A named process that drove a crisis, with a definition, boundary and test.

### Is the vocabulary free?

The site calls it open and free, belonging to no company.

### How far back does it go?

To a Mesopotamian debt cancellation around 2400 BC.

### What is the Pano?

A dated picture of which processes are at work now, published quarterly.

### Is Causal Mechanism Registry free?

Yes. Causal Mechanism Registry is free to use.

### How do I add Causal Mechanism Registry to Claude Code?

Run this command in your terminal: claude mcp add --transport http causal-mechanism-registry https://adenkarabal.com/mcp

### What are the best alternatives to Causal Mechanism Registry?

The closest alternatives to Causal Mechanism Registry are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.
- [Context Nest](https://ai-powered.com/mcp/context-nest): Context Nest is a freemium MCP server for knowledge and memory.
- [Agent Yurt](https://ai-powered.com/mcp/agent-yurt): Agent Yurt is a free MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/causal-mechanism-registry
