MCP server

Clairvoyance Official

fyi.clairvoyance/mcp

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Working at last checkVerified publisher: clairvoyance.fyiAbout 2,629 tokens per request once connected17 tools

Website Source

https://clairvoyance.fyi/mcp

At a glance

Type: MCP server
Publisher: clairvoyance.fyi (verified by the MCP Registry)
Status: Working at last check
Tools: 17
Token cost: About 2,629 tokens per request
Sets up in: Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok
Last checked: 26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to Cursor Add to VS Code VS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.clairvoyance]
url = "https://clairvoyance.fyi/mcp"

Gemini CLI

{"mcpServers":{"clairvoyance":{"httpUrl":"https://clairvoyance.fyi/mcp"}}}

Cursor

{"mcpServers":{"clairvoyance":{"url":"https://clairvoyance.fyi/mcp"}}}

VS Code

{"servers":{"clairvoyance":{"type":"http","url":"https://clairvoyance.fyi/mcp"}}}

Antigravity

agy mcp add clairvoyance https://clairvoyance.fyi/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"clairvoyance","server_url":"https://clairvoyance.fyi/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"clairvoyance","server_url":"https://clairvoyance.fyi/mcp"}

Tools

abstraction-quality ~140 tokens
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
code-evolution ~140 tokens
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-fl
comments-docs ~122 tokens
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-obviousn
complexity-recognition ~125 tokens
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-mo
deep-modules ~139 tokens
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 abstrac
design-it-twice ~193 tokens
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
design-review ~181 tokens
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
diagnose ~108 tokens
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-design ~146 tokens
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-
fetch-reference ~281 tokens
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-f
general-vs-special ~136 tokens
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 con
information-hiding ~148 tokens
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 ~135 tokens
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 abs
naming-obviousness ~126 tokens
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
pull-complexity-down ~148 tokens
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 (u
red-flags ~223 tokens
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 wheth
strategic-mindset ~138 tokens
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 specif

Related MCP servers

Skill Market
x402 skill catalog on lvlltd.com — search, quote, pay with Base USDC, unlock sealed packs.
Frankponcelet Profile
Read-only MCP server for Frank Poncelet: profile, career, projects, speaking, expertise, persona.
Aziel Runtime
Governed MCP: agent audit, provenance, deterministic checks, and receipt-backed FragGate execution.
TikTikLuck
Swipe, play, make. Free luck and skill games your agent can play and make. Play money only.
AdCritter for Builders
AdCritter ads platform: docs, API reference, app scaffolding, and white-label integration.
Pg Aiguide
Comprehensive PostgreSQL documentation and best practices, including ecosystem tools
GodPrompt MCP Server
GodPrompt MCP + Agent Skill for coding agents with TDD, debugging, verification, and task routing.
LoopingAgent
English blog + agentic workflows architect profile (Paris): search, full text, projects, booking.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/fyi.clairvoyance/mcp.svg)](https://aptlynx.net/servers/fyi.clairvoyance/mcp)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents