Git Reflog Archaeologist is a local MCP for the moment after an accidental reset, deleted branch, or abandoned experiment. It looks at Git metadata that can help answer whether recovery may still be possible.

Tools

reflog_signals: aggregate reflog count, age buckets, and loose or packed object counts
recovery_signals: aggregate unreachable object counts by type
stash_signals: aggregate stash count and age buckets

The outputs include coarse recovery hints such as recent-history-may-be-recoverable or unreachable-commits-found. They do not return commit hashes, subjects, ref names, file paths, remote names, author data, or file contents.

Safety

Local Git commands only. No network access is used.
The selected repository must stay inside GIT_ARCHAEOLOGY_ROOT.
Git output is line and count bounded.
The server never runs mutating commands such as reset, reflog expire, prune, or garbage collection.
This is a recovery signal tool, not a guarantee that an object can be restored.

Run

npm install
npm run build
node dist/index.js

The server uses stdio and works with Claude Desktop, Cursor, VS Code, MCP Inspector, and compatible CLI harnesses.

Quick start

npm install
npm run build
node dist/index.js

The server uses stdio, so it can be connected to Claude Desktop, Cursor, VS Code, MCP Inspector, or another compatible MCP client.

Tools at a glance

reflog_signals: Summarize local reflog activity by count and age bucket without returning ref names, hashes, subjects, paths, or remotes.
recovery_signals: Count unreachable Git object types and recovery hints without returning object IDs, messages, paths, or contents.
stash_signals: Summarize local stash age buckets and count without returning stash messages, refs, hashes, or paths.

Try it

After building, connect the server through your MCP client. The repository root also contains smoke-test.mjs for projects covered by the shared harness. A typical tool call starts with reflog_signals.

Premium tools

These tools need a licence key:

public_commit_provenance

The tool bodies run on our gateway, not inside this package, so the key is what buys access. Buy one at https://buy.polar.sh/polar_cl_mrO7rS5LZxpqM7oAFFEA10i9121J240U40IIj4JRZO4 and set it in your MCP client config:

"env": { "MCP_LICENSE_KEY": "polar_..." }

The gateway checks the key against Polar and gives every key 1,000 free premium calls a month before per-call billing starts. Every other tool on this server stays free.