Skip to content
MCP server

Causal Mechanism Registry

A versioned registry of named causal mechanisms behind historical crises

Status and history

Answered our latest tool-list check 7 hours ago with 8 tools. It will be marked verified after 3 successful checks in 7 days.

Install
Pricing
Free
Platforms
Web, API
Runs
Remotely
Version
1.0.0
Listing updated
3 days ago

About Causal Mechanism Registry

Causal Mechanism Registry is a free MCP server for knowledge and memory. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://adenkarabal.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "causal-mechanism-registry": {
      "url": "https://adenkarabal.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (8)

Read directly from the server.

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.

What it does

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

Pricing

Free

Vocabulary described as open and free

Prices change. Check adenkarabal.com before you buy.

Causal Mechanism Registry 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 to Causal Mechanism Registry

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  4. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  5. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity