reflectLABSCO SUMMARY
The tool does almost nothing, and that is the design.
It logs the text and acknowledges — there is no computation behind it. The value is that calling it forces the reasoning to be produced explicitly instead of skipped, which is a real effect and a very cheap one to add. Zero configuration, zero credentials, one tool definition in your context. Whether the model actually reaches for it depends on your prompting, not on the server.
What it is
An MCP server that provides a single reflect tool. The assistant calls it with its reasoning, the tool logs that thought process to the server console and acknowledges the checkpoint, and the act of having to write the reasoning down is the point.
What you get
- A reflection checkpoint the assistant writes into before or after an action —
reflect - Structured reasoning used as a planning step: breaking a task into ordered steps before starting
- Task validation after the fact — what was completed, what was learned, what technical debt was created, what comes next
- A debugging scratchpad — symptom, hypotheses, which were confirmed, the solution and the result
- A decision audit trail, since the reasoning is written rather than implicit
- Stdio by default, with an HTTP mode behind environment variables
Requirements
No account and no key. Install with npm install -g mcp-reflection-tool or run it directly with npx mcp-reflection-tool. Cursor and Cline configurations are documented. For HTTP mode set HTTP=true, with PORT overriding the default 8080. Node.js 18+ or Bun. Package mcp-reflection-tool 0.1.19 with a binary of the same name.
Setup effort
One command — npx mcp-reflection-tool
USE CASES
01
Making a plan before code gets written
Have the assistant lay out its approach as an ordered list first, so the plan is visible and correctable.
02
Checking that a task is really done
Ask for a completion checkpoint listing what was finished, what was learned and what was left behind.
03
Debugging by elimination
Record each hypothesis and its outcome, so the ruled-out branches stay ruled out.
1 tool
Listed in project docs. Your client may show a different list.
BEFORE YOU INSTALL
What to know first
Tools you get
1 tool named in the project's documentation.
Requires
- npx on PATH
- Node.js 18+
Where it runs
All 3 documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
npx mcp-reflection-toolMCP Clients
Cursor, Windsurf, Cline
JSON
{
"mcpServers": {
"reflection-tool": {
"command": "npx",
"args": [
"mcp-reflection-tool"
]
}
}
}
