Back to Browse

Candor MCP Server

Developer ToolsLow Risk10.0MCP RegistryRemote
Free

Server data from the Official MCP Registry

Candor UI docs and component suggestions. Read-only, no key, never serves paid source.

About

Candor UI docs and component suggestions. Read-only, no key, never serves paid source.

Remote endpoints: streamable-http: https://candor.themethodic.com/mcp

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (1 strong, 1 medium validity signals). No known CVEs in dependencies. Imported from the Official MCP Registry. Trust signals: 5 highly-trusted packages.

12 tools verified · Open access · No issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Found in Source Code

Found by scanning the linked source code. This listing connects to a hosted endpoint, so none of this runs on your machine: it describes what the server software does where it is hosted.

HTTP Network Access

Connects to external APIs or services over the internet.

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

{
  "mcpServers": {
    "com-themethodic-candor": {
      "url": "https://candor.themethodic.com/mcp"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

Candor UI: the free tier

Honest agent UI for shadcn/ui: chat, tool calls and permission prompts that never overstate what an agent did. MIT.

Starters npm: candor-ui npm downloads: candor-ui Licence: MIT Latest release

The Vite starter's scripted agent asking to add a task: the tool call waits for you, and a permission prompt shows what it will run, with Deny and Allow and neither chosen for you

See the app examples · Honest against typical, side by side · Docs · Changelog

Interface components for agent apps: a thread, messages, a composer, tool calls, reasoning and citations, the building blocks under them, a light, dark and high-contrast theme, and adapters for the Vercel AI SDK, the Claude Agent SDK and AG-UI. For shadcn/ui projects, installed with the candor-ui CLI or shadcn's own, MIT licensed.

This repo is the source of Candor UI's 76 free items (version 6.6.0), the skill and plugins for coding agents and 3 starter apps. Docs and live examples: https://candor.themethodic.com.

The same free items are on npm as @candor-ui/react, for people who would rather npm install than copy code in. That package changes only when a free item changes, so its version can be behind the kit's after a release that changed only Pro items; the CLI, candor-ui, has a version of its own. The changelog says which release changed what.

Try it in a minute, no key

Try it with no key and no install: https://candor.themethodic.com/try. It is the Vite starter below, built and running in your browser.

To run it yourself:

npx degit MethodicDev/candor/starter-vite-ag-ui my-app
cd my-app
npm install
npm run dev

Open the address it prints. A scripted agent answers in the page: fixed replies, no model, no server and no API key, and the page says so. Ask it to add "Try a Candor block" to your list and you'll see a line of its reasoning, a tool call marked "Needs you", and a permission prompt that shows what it will run, with Deny and Allow and neither chosen for you. That is what the image above shows. Point VITE_AGENT_URL at an AG-UI agent (LangGraph, CrewAI…) when you want a real one.

Why Candor

An agent that acts on real systems can mislead without saying anything false: a spinner nobody has heard from, a total that treats a missing cost as zero, an approval that now applies to a different change. Candor's components keep these 9 rules. Where Honest against typical has a moment that shows one, the link goes to its Typical and Honest switch; the others go to Principles.

Install

npx candor-ui@latest init
npx candor-ui@4 add thread message composer

candor-ui init adds the @candor registry to components.json and the theme to your CSS; in a project without shadcn yet it runs shadcn's setup first (--yes sets it up with Base UI and shadcn's nova preset, no questions). Or add the registry by hand: "@candor": "https://candor.themethodic.com/r/{name}.json". If shadcn asks to overwrite a primitive such as ui/button.tsx, answer yes: Candor's button styles locked actions; without a terminal, pass --overwrite.

Or from npm

npm install @candor-ui/react
import { Thread, Message, Composer } from "@candor-ui/react"

Then @import "@candor-ui/react/styles.css" after Tailwind. The package holds the free tier only, and its version can be behind the kit's; its README has the adapters and the entry points.

Tools

candor-ui also checks what you build, from the CLI's own docs:

  • lint checks your .tsx, .ts, .jsx and .js files against Candor's honesty rules and prints path:line:col rule message for each finding; it exits 1 on an error.
  • audit is lint plus a look at a running page: npx candor-ui audit http://localhost:3000 runs axe and the honesty rules on it and writes AUDIT.md.
  • update moves installed items to the latest version and keeps your changes: a file you edited gets a three-way merge, and where you and we changed the same lines it writes conflict markers.
  • verify is for CI: it checks candor-lock.json against the registry's versioned snapshots and the files on disk.
  • theme check checks your theme's colour contrast and its motion and sound values, and changes nothing.

candor-ui doctor explains an install that looks wrong. Every command is in the CLI's README.

For coding agents

llms-install.md tells an agent how to set Candor up in a project by itself: the CLI, the docs MCP server, the skill and the honesty rules to keep. The skill alone:

npx skills add MethodicDev/candor

installs two skills: skills/candor-ui (which component fits which job, the adapters, and the rules the components keep, with a design-system reference read from the shipped CSS) and skills/candor-agent-ui (design fundamentals for screens where an AI agent acts, with a review checklist to run after each screen; it works with or without Candor).

The plugins install the skill and the docs MCP server together. Claude Code: claude plugin marketplace add MethodicDev/candor, then claude plugin install candor-ui@candor (or, in a session, /plugin install candor-ui --marketplace MethodicDev/candor). GitHub Copilot CLI: copilot plugin marketplace add MethodicDev/candor, then copilot plugin install candor-ui@candor. VS Code installs candor-ui from this repo's URL; Cursor reads .cursor-plugin/marketplace.json; the Codex package is plugins/codex/candor-ui.

Each tool reads its manifest from a folder it names, which is why the top of this repository has several dot-folders. GitHub Copilot CLI looks only at the root, .plugin/, .github/plugin/ and .claude-plugin/, so its manifest can't move under plugins/ with the packages.

FolderRead byWhat it holds
.claude-plugin/Claude Codethe marketplace and the plugin, which is this repository
.cursor-plugin/Cursorthe marketplace, listing plugins/cursor/candor-ui
.github/plugin/GitHub Copilot CLI and VS Codethe marketplace, listing plugins/vscode/candor-ui
.mcp/the MCP registryserver.json, the docs MCP server's entry
plugins/Codex, Cursor, VS Codeone package per tool, each with the skill and the MCP server's settings

The MCP server at https://candor.themethodic.com/mcp serves docs and component suggestions only: read-only, no key, never paid source. .mcp/server.json describes it for the MCP registry. Agents can also read https://candor.themethodic.com/llms.txt.

Starters

Starter apps with a working agent chat built from these components (3 of them). Each installs and builds on its own:

FolderStackAgent
starter-vite-ag-ui/Vite and React, no server (try it)a scripted one in the page (no key; see above), or any AG-UI agent (LangGraph, CrewAI…)
starter/Next.js 16Vercel AI SDK at /, Claude Agent SDK at /claude (needs an Anthropic API key)
starter-tanstack-start-claude/TanStack StartClaude Agent SDK (needs an Anthropic API key)
npx degit MethodicDev/candor/starter-vite-ag-ui my-agent-app
npx degit MethodicDev/candor/starter my-agent-app
npx degit MethodicDev/candor/starter-tanstack-start-claude my-agent-app

What's here

76 free items, each with a docs page that has its props and live examples. Install any of them by name: npx candor-ui@4 add <name>.

AreaWhat it's forItems
Chat (20)A conversation with an agent: messages, the composer, tool calls, reasoning, citations.agent-avatar, ai-disclosure, attachment-preview, card-registry, citation, composer, context-meter, entity-chip, folded-turns, message-actions, message-content, message, payload, permission-prompt, prompt-suggestions, reasoning, thread-divider, thread-event, thread, tool-call
Adapters (7)Map an agent SDK's messages onto Candor's data: the Vercel AI SDK, the Claude Agent SDK and AG-UI.ag-ui, ai-sdk, claude-agent-sdk, claude-agent-server, use-ag-ui, use-candor-chat, use-claude-agent
Building blocks (7)Small pieces every screen uses: locked controls, status dots, step lists, relative times.copy-field, degraded-panel, relative-time, status-dot, step-list, streaming-text, surface
App shell (2)The app around the agent: layout, sidebar, command menu, sessions, notices.page-header, page-state
Primitives (13)The shadcn/ui primitives Candor's components are built on.accordion, alert, button, checkbox, collapsible, label, locked, popover, progress, skeleton, slider, switch, tooltip
Themes (6)The default theme and 5 gallery themes: colours, type, radius and motion as CSS variables, in light, dark and high contrast.tokens, theme, theme-slate, theme-paper, theme-console, theme-signal

Shared types and helpers (18): Types and pure functions the components share.

bidi, chat, fill-strings, format-elapsed, heading-level, heading-scope, highlight, know, layer, locale, mcp-input, motion, safe-markdown, sound, status, use-copy, use-shortcut, use-virtual-list

Fonts (3): Self-hosted, and optional: without one the theme uses the system font.

font-inter, font-source-sans, font-ibm-plex

Pro, Premium and Team

One-time prices, no subscription. A licence includes every version Candor UI publishes, major ones included. You can ask for a full refund within 30 days of buying. The free tier here is MIT.

TierPriceWhat's in itSupport
Free (this repo)$0, MIT76 items: the chat core, building blocks, themes, adapters; 3 starters; the skill and pluginspublic issues here
Pro$149, one personAll 399 items, the free ones included: the app shell, plans, approvals, diffs, runs, evals and adminnone; the docs and examples
Premium$249, one personPro, plus 11 full-stack blocks and 4 templates, each for the Vercel AI SDK and the Claude Agent SDKemail, best effort
Team$999, up to 10 people in one companyPremiumemail, a first reply within 2 business days

Buy at https://candor.themethodic.com/#pricing. The terms are the Candor UI Commercial Licence; SUPPORT.md repeats the support each tier includes. Your key arrives in Polar's receipt email and customer portal; https://candor.themethodic.com/licence-key says where, and what a refund does to it. Then, in your project:

npx candor-ui key <your licence key>      # saves it to .env.local, checks it, and has the registry send it
npx candor-ui@4 add approval-request     # a Pro item, installed like any other

In CI, set CANDOR_LICENSE_KEY as a secret, so installs and npx candor-ui verify can read paid items. Installed code needs no key to run; the key is only for installing and updating. Never put a key in an issue, a pull request or a repository.

How this repository works

  • The source of truth is private. Candor UI's main repository holds the free items and the paid tiers together. This repository is generated from it on each release, so a change made here by hand would be overwritten.
  • From 2.6.2, each release is a commit, a tag and a GitHub Release. The commit Candor X.Y.Z, the tag vX.Y.Z and the release all carry that version's changelog section.
  • Issues are read. Use the forms. There is no promised reply time for the free tier; the support each paid tier includes is in SUPPORT.md. A vulnerability goes to SECURITY.md, not to an issue.
  • A pull request isn't merged here. If it is accepted, it is applied upstream by hand, credited in that release's changelog entry, and closed with a link to the release that holds it. CONTRIBUTING.md has the rest.
  • Every release is reviewed over its full diff by a separate review session that had no part in writing it, before the owner approves the merge. Most of the code is written with AI coding assistants, and the commits here say so in a Co-Authored-By line.

Licence

MIT, © Methodic LLC. See LICENSE. It covers this repository's free items; Candor UI's paid items are under the Candor UI Commercial Licence.

Reviews

No reviews yet

Be the first to review this server!