# Clairvoyance

This MCP server gives coding agents software-design checks for modules, abstractions, errors, and naming. It connects over HTTP without sign-in.

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

## What it does

Clairvoyance supplies skills that make an agent inspect design choices during implementation and review. They cover module depth, boundary decisions, information hiding, caller burden, abstraction quality, error handling, naming, and documentation. A separate skill compares design alternatives before one is chosen, while another scans for design smells.

The server is read-only and uses Streamable HTTP. Each request contains only the selected skill name, so project code, file paths, and prompts stay out of the request. MCP clients that support prompts can expose the skills as slash commands, including `/clairvoyance:red-flags`, `/clairvoyance:deep-modules`, and `/clairvoyance:design-it-twice`. Claude Code connects through `https://clairvoyance.fyi/mcp`.

## Requirements
- Remote server: `https://clairvoyance.fyi/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://clairvoyance.fyi/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add clairvoyance --url https://clairvoyance.fyi/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "clairvoyance": {
            "url": "https://clairvoyance.fyi/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "clairvoyance": {
            "type": "http",
            "url": "https://clairvoyance.fyi/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http clairvoyance https://clairvoyance.fyi/mcp
```

## When to use it
- inspect whether module interfaces hide complexity
- spot pass-through methods and weak boundaries
- compare design alternatives before implementation
- reduce error-handling work pushed onto callers
- check naming and cross-module documentation

## Example prompts
- Run `/clairvoyance:red-flags` and scan this change for design smells.
- Use `/clairvoyance:deep-modules` to inspect the depth of these module interfaces.
- Call `/clairvoyance:design-it-twice` and compare two designs before I implement one.

## Similar
- [Architect Guide for Programmers](https://affpapa.org/en/nevibecode/prompts/architect-guide-for-programmers.md) — prompt · ★ 174676
- [better-interface](https://affpapa.org/en/nevibecode/skills/better-interface.md) — skill · 30000 installs
- [interface-review](https://affpapa.org/en/nevibecode/skills/interface-review.md) — skill · 18500 installs
- [web-design-guidelines](https://affpapa.org/en/nevibecode/skills/vercel-web-design-guidelines.md) — skill · 3900 installs
- [miro](https://affpapa.org/en/nevibecode/plugins/miro.md) — plugin · ★ 164
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 411800 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