MCP.Market

Clairvoyance MCP server

online · 100% uptime
by clairvoyance.fyi·fyi.clairvoyance/mcp·v1.3.1·12 stars

Software design skills for AI coding agents, inspired by A Philosophy of Software Design.

A91/100grade A
What users say
No reviews yet
Be the first
Safety scan
A91/100

full report

Adoption
Growing

12 stars

Reviews

Write one

Nobody has reviewed Clairvoyance yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Clairvoyance tools (17)

write = sends, deletes, buys or posts
  • abstraction-qualityFree

    Evaluates whether abstractions provide a genuinely different way of thinking or are structurally shallow. Use when adjacent layers feel redundant, wrappers add boilerplate without depth, or an abstraction feels leaky. Not for a single module's interface-to-implementation ratio (use deep-modules) or information leakage across boundaries (use information-hiding).

  • code-evolutionFree

    Evaluates whether changes to existing code maintain or degrade design quality. Use when the user asks to review a diff or PR (for example before merging it), or asks about recently modified files, to judge whether each change looks designed-in or bolted-on. Not for scanning design smells (use red-flags) or assessing overall design investment (use strategic-mindset).

  • comments-docsFree

    Reviews comment quality and documentation practices: the four comment types, comments-first workflow, and comment rot. Use when reviewing comments or docs, when comments just repeat the code, or when something is hard to describe in a sentence. Not for naming or code obviousness (use naming-obviousness).

  • complexity-recognitionFree

    Diagnoses whether complexity exists and where it comes from, using the three-symptom, two-root-cause framework. Use when code feels harder to work with than it should but the specific problem is unclear. Not for scanning known design smells (use red-flags) or evaluating a module's depth (use deep-modules).

  • deep-modulesFree

    Measures module depth: whether the interface is simple relative to the implementation behind it. Use when an interface has too many parameters or methods, many small classes each do too little, or methods just forward calls. Not for whether adjacent layers provide different abstractions (use abstraction-quality) or merging/splitting modules (use module-boundaries).

  • design-it-twiceFree

    Generates and compares at least two fundamentally different design alternatives on concrete criteria before committing. Use when the user asks to design something twice, or before committing to any significant design of classes, modules, APIs, or architecture. Also use when asked how to structure or architect a feature, or when writing the design or alternatives section of an RFC, design doc, or ADR. Not for judging strategic vs. tactical investment in existing code (use strategic-mindset) or whether a change degrades design (use code-evolution).

  • design-reviewFree

    Orchestrates a structured design review, running the other skills as a diagnostic funnel from complexity triage to a full red-flags sweep. Use when the user asks for a comprehensive or prioritized design assessment of a file, module, or PR. Not for an open-ended "anything off here?" or "take a look at this" prompt that names no review goal (use red-flags), a plain diff review before merge or analyzing how code changed over time (use code-evolution), or applying one specific lens (use that skill directly).

  • diagnoseFree

    Routes a vague symptom or complaint to the most relevant Clairvoyance skill via a decision tree. Use when someone describes a problem but doesn't know which skill to reach for. Not for a comprehensive review (use design-review) or a checklist scan (use red-flags).

  • error-designFree

    Reviews error handling and exception design, applying the "define errors out of existence" principle. Use when reviewing error handling, when a module throws too many exceptions, or when callers must handle errors they shouldn't need to know about. Not for general caller-burden complexity (use pull-complexity-down); this skill is specifically for exception and error-condition strategy.

  • fetch-referenceFree

    Fetch a supporting file from a Clairvoyance skill's references/ folder, when the skill's instructions point to one. Available: information-hiding (back-door-leakage.md); pull-complexity-down (configuration-parameter-audit.md); comments-docs (comments-first-workflow.md); design-it-twice (pre-mortem-fallback.md); red-flags (flag-interaction-map.md); design-review (workflow-builder.md).

  • general-vs-specialFree

    Evaluates whether interfaces are appropriately general-purpose. Use when checking interface generality, when if-branches or parameters serve only one caller, or when getters/setters expose internal representation. Not for information leakage across boundaries (use information-hiding) or auditing configuration parameters (use pull-complexity-down).

  • information-hidingFree

    Checks for information leakage across module boundaries, including temporal decomposition and false encapsulation. Use when modules change together, implementation details leak across boundaries, or structure follows execution order rather than knowledge ownership. Not for merge/split decisions (use module-boundaries) or interfaces over-specialized for one caller (use general-vs-special).

  • module-boundariesFree

    Evaluates where module boundaries are drawn and whether modules should be merged or split. Use when deciding whether to combine or separate two modules, when modules are tightly coupled, or when a change to one forces changes to another. Not for depth within a single module (use deep-modules) or abstraction-layer quality (use abstraction-quality).

  • naming-obviousnessFree

    Reviews naming quality and code obviousness via the isolation test, scope-length principle, and consistency audit. Use when names feel vague, something is hard to name (a design signal, not a vocabulary problem), or behavior isn't obvious on first read. Not for comment quality or documentation (use comments-docs).

  • pull-complexity-downFree

    Checks whether complexity is pushed to callers or absorbed by implementations — the direction complexity flows. Use when callers must do significant setup, handle errors the module could resolve, or configure things they don't understand. Not for module depth (use deep-modules), knowledge leakage (use information-hiding), or exception strategy once an error must surface (use error-design).

  • red-flagsFree

    Scans code against 17 design smells (the book's 14 named Red Flags plus 3 process-stage signals) and produces a structured diagnostic report. Use when the user asks for a red flags or design smell scan, asks to check code against a checklist, is evaluating unfamiliar code, or asks open-endedly whether anything is off in a named or pasted file, class, or function, or asks you to look it over. Not for a specific bug, error, or failing test the user has already identified. Not for a plain diff or PR review before merge, or whether a PR maintains design trajectory (use code-evolution for both), or diagnosing why code feels complex (use complexity-recognition).

  • strategic-mindsetFree

    Assesses whether code reflects strategic or tactical thinking, including the 10-20% investment rule and tactical-tornado patterns. Use when evaluating design investment, when code was written under time pressure, or when working code consistently degrades the system. Not for judging whether a specific diff looks designed-in or bolted-on (use code-evolution).

Public scan report

scanner v0.1.10 · 2026-10-13 · same rubric, same numbers if you re-run it

no findings
  • –Code scanremote-only server, no package to scann/a
  • Live reliabilityremote reachable in 1656ms20/20
  • Tool poisoning17 tool descriptions checked15/15
  • Auth qualityopen endpoint, read-only tools10/15
  • Maintenancelast push 6 days ago15/15
  • Maintainer identityendpoint served from the registry-verified namespace domain8/10
Overall 91/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Clairvoyance compares

Against every graded Media MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
91/100
higher than 83% of 1,253 Media servers
Tools
17
the typical Media server has 7
Tools that change things
0%
typical: 5%. Fewer write tools means less an agent can break
Uptime
100%
of our recent checks; the typical remote Media server answers 100%
Response time
371 ms
faster than 54% of 785 Media servers
GitHub stars
12
more than 89% of 685 Media servers

What its tools let an agent do: 16 read · 1 send or post

Install Clairvoyance in Claude Code, Cursor or VS Code

claude mcp add --transport http mcp https://clairvoyance.fyi/mcp
Add to Cursor

What the publisher says

From the Clairvoyance repository's README, as published. We do not edit it. Read it on GitHub

Clairvoyance

AI agents can write working code, but they don't stop to consider effective design unless asked. Clairvoyance is a set of skills inspired by John Ousterhout's A Philosophy of Software Design. Each skill gives your agent extrasensory perspective around software design, with concrete tests to see ahead of obstacles during implementation and review.

How It Works

Skills activate automatically and push your agent to ask questions like:

  • Does this interface hide real complexity, or just pass things through?
  • Can this method be understood without reading another one in a different file?
  • Is error handling pushing work onto callers that the module could handle itself?

You can also invoke them directly. Use /clairvoyance:red-flags to trigger a design smell scan, /clairvoyance:deep-modules to check interface depth and /clairvoyance:design-it-twice to compare alternatives before committing. (On platforms that install the skills without the plugin namespace, such as skills.sh, drop the clairvoyance: prefix.)

Installation

Give your agent Clairvoyance: Claude Code, skills.sh, Codex, Cursor, OpenCode, Antigravity, Factory Droid, GitHub Copilot CLI, Kimi Code, Pi.

Note: Installation differs by platform. If you use more than one, install Clairvoyance separately for each.

Claude Code

/plugin marketplace add codybrom/clairvoyance
/plugin install clairvoyance@clairvoyance-plugins

skills.sh

npx skills add codybrom/clairvoyance --skill '*'

Codex

Requires Codex CLI ≥ 0.142.0 (codex --version). The Codex App and CLI share the same config, so this also makes Clairvoyance visible in the App's Plugins panel.

codex plugin marketplace add codybrom/clairvoyance
codex plugin add clairvoyance@clairvoyance

Older Codex versions only get the 16 skills, via a manual symlink — see .codex/INSTALL.md for that fallback and full troubleshooting.

Cursor

Cursor doesn't yet have a one-line "install from a GitHub URL" flow for unlisted plugins, so clone (or symlink) the repo into Cursor's local plugins folder and restart:

git clone https://github.com/codybrom/clairvoyance.git ~/.cursor/plugins/local/clairvoyance

Then check the Customize panel in the sidebar to confirm Clairvoyance and its 16 skills are listed.

OpenCode

Add Clairvoyance to the plugin array in your opencode.json (global or project-level):

{
  "plugin": ["clairvoyance@git+https://github.com/codybrom/clairvoyance.git"]
}

Restart OpenCode — no symlinks or manual skill paths needed. See .opencode/INSTALL.md for version pinning, troubleshooting, and migrating off the old symlink-based install.

Antigravity

agy plugin install https://github.com/codybrom/clairvoyance

Factory Droid

Droid translates Claude Code plugin format automatically — no Clairvoyance-specific files needed.

droid plugin marketplace add https://github.com/codybrom/clairvoyance
droid plugin install clairvoyance@clairvoyance-plugins

GitHub Copilot CLI

copilot plugin marketplace add codybrom/clairvoyance
copilot plugin install clairvoyance@clairvoyance-plugins

Kimi Code

In Kimi Code's plugin manager (/plugins), choose Custom, or run directly:

/plugins install https://github.com/codybrom/clairvoyance

Kimi Code will show a third-party trust prompt since this isn't an officially curated source — confirm to proceed.

Pi

pi install git:github.com/codybrom/clairvoyance

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Clairvoyance: common questions

Is Clairvoyance MCP server safe?
Yes, by our scan: it is graded A (91/100). Read the Clairvoyance safety report
How do I install Clairvoyance?
It runs remotely at clairvoyance.fyi. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
Does Clairvoyance need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Clairvoyance maintained?
The last commit was 18 days ago (2026-10-08). The latest release is v1.3.1.
Is Clairvoyance up?
100% of our last 28 checks got an answer. We check remote servers about four times a day.
What can I use instead of Clairvoyance?
Servers from other publishers that do the same job: memi MCP server, WunderUI MCP server and TypeUI MCP server. Compare all Clairvoyance alternatives.
How does Clairvoyance compare with other Media MCP servers?
safety score 91/100 (higher than 83% of 1,253 Media servers); tools 17 (the typical Media server has 7); tools that change things 0% (typical: 5%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Clairvoyance

Same job from other publishers: the closest match first, then the best rated.

All Clairvoyance alternatives →
  • memi
    Memi is the read-only design engineering audit and skill layer for coding agents.
    A
  • WunderUI
    The WunderUI design system for coding agents: components, props, tokens, rules and skills.
    B
  • TypeUI
    Design systems, UI prompts, and layout variations for AI coding tools.
    A
  • Designer Skill
    UI design MCP: design references, intent routing, anti-slop static detector and gate. No API key.
    A
  • Buoy
    The design system your coding agents check before they ship: tokens plus exact UI fixes.
    A