Causal Mechanism Registry
A versioned registry of named causal mechanisms behind historical crises
Answered our latest tool-list check 7 hours ago with 8 tools. It will be marked verified after 3 successful checks in 7 days.
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://adenkarabal.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"causal-mechanism-registry": {
"url": "https://adenkarabal.com/mcp"
}
}
}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

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Claude Code Ultimate Guide
MCP serverMCP 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

Nautilus Compass Memory
MCP serverLocal-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

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity
MedXpert 图书馆连接器(通用版)
MCP serverLocal MCP server that searches and answers questions over your own Markdown wiki
Runs locally- 4 tools
- Open source
- Knowledge and memory