# self-inspect-mcp

This MCP server gives an agent a question about its own assumptions. Use it before a plan, decision, or final answer when the reasoning reaches a real block.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7
- Author: ejentum
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ejentum/self-inspect-mcp
- Updated: 2026-06-13
- HTML: https://affpapa.org/en/nevibecode/mcp/self-inspect-mcp

## What it does

self-inspect-mcp takes a description of the agent’s current thought or task and returns one metathought. The question redirects attention to assumptions, missing conditions, fixed decisions, or claims that do not follow. Its selector is deterministic and uses no LLM, embeddings, or API key.

The MCP interface exposes `self_inspect` with a `thought` argument. You can connect to the hosted HTTP endpoint or run the package locally with `npx self-inspect-mcp`; Python users also get `dist/self_inspect.py`, which uses the standard library. Call it at a genuine reasoning block. Running it after every step creates staged corrections and can make the result worse.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.ejentum.com/self-inspect-mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http self-inspect-mcp https://api.ejentum.com/self-inspect-mcp
```

2. **Platform CLI**
```bash
claude mcp add self-inspect-mcp -- npx -y self-inspect-mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add self-inspect-mcp --url https://api.ejentum.com/self-inspect-mcp
```

2. **Platform CLI**
```bash
codex mcp add self-inspect-mcp -- npx -y self-inspect-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "self-inspect-mcp": {
            "url": "https://api.ejentum.com/self-inspect-mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "self-inspect-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "self-inspect-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "self-inspect-mcp": {
            "type": "http",
            "url": "https://api.ejentum.com/self-inspect-mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "self-inspect-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "self-inspect-mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http self-inspect-mcp https://api.ejentum.com/self-inspect-mcp
```

2. **Platform CLI**
```bash
gemini mcp add self-inspect-mcp npx -y self-inspect-mcp
```

## When to use it
- check an assumption before taking action
- catch goal drift across a long chain
- challenge the first plausible answer
- surface missing conditions in a plan

## Example prompts
- Before I continue, ask one question that tests the assumption behind this decision.
- I am about to lock in this architecture. Use `self_inspect` to challenge my reasoning.
- I am stuck at this step. Send the current thought to `self_inspect` and use the returned question.

## Similar
- [dotnet-inspect](https://affpapa.org/en/nevibecode/skills/dotnet-inspect.md) — skill · 508 installs
- [dotnet-inspect-correctness](https://affpapa.org/en/nevibecode/skills/dotnet-inspect-correctness.md) — skill · 415 installs
- [node-inspect-debugger](https://affpapa.org/en/nevibecode/skills/node-inspect-debugger.md) — skill · 396 installs
- [self-hosted-funnel-launch](https://affpapa.org/en/nevibecode/skills/self-hosted-funnel-launch.md) — skill · 103000 installs
- [inspect-dropbox-file](https://affpapa.org/en/nevibecode/skills/inspect-dropbox-file.md) — skill · ★ 7604
- [convex-self-heal](https://affpapa.org/en/nevibecode/skills/convex-self-heal.md) — skill · 36100 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md