Koskamo

Candor UI MCP

A read-only MCP server that searches Candor UI documentation and suggests shadcn/ui components for AI agent tasks. It supports integration with various AI coding tools like Claude Code, Cursor, and VS Code Copilot, providing component recommendations based on typed data and adapters for AI SDKs.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Candor UI MCP logo, by Methodic LLCVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-08Operated by Methodic LLC
MCP endpoint (Streamable HTTP)
https://candor.themethodic.com/mcp
Vendor documentation

What its tools do

9 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

9 of 9 have a description · 9 of 9 declare behavior hints · 6 of 6 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Passed Official MCP Registry namespace is tied to themethodic.com ·
  • Passed Endpoint is on the registry namespace domain ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Search documentation for UI components
  • Suggest components for AI agent tasks
  • Integrate with Claude Code and other IDEs

Source and maintenance

Vendor evidenceRegistry 1.9.0
Maintenance checked

Protocol and capabilities

Server
candor-ui-docs 1.9.0
MCP protocol negotiated in check
2025-11-25
Tools
9 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": false
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Candor UI's docs: a shadcn/ui registry of React components for AI agent interfaces. Use suggest_components when starting a screen, search_docs to find something, and get_component_docs before using an item, for its props and the import paths an app uses. get_design has the colour roles, type, radius, motion and themes and how to re-token for a brand; get_review_checklist is the list to run after each screen; get_brief is an item's page to hand to another agent. Install with `npx candor-ui add <name>`. Pro and Premium items need the person's licence key, which they add themselves; never ask for it.

Tools

9 advertised

search_docs — Search Candor UI docs
Advertised by the server during the last successful anonymous check.
Advertised read-only

Search Candor UI's components, hooks, blocks and patterns by what they do ("approve a tool call", "cost estimate", "session list"). Returns names, tiers and one-line descriptions; read one with get_component_docs.

search_docs input schema
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "tier": {
      "enum": [
        "free",
        "pro",
        "premium"
      ],
      "type": "string",
      "description": "Only items this tier unlocks: free, pro (free and Pro) or premium (everything)."
    },
    "limit": {
      "type": "integer",
      "maximum": 25,
      "minimum": 1,
      "description": "At most this many items (default 10)."
    },
    "query": {
      "type": "string",
      "description": "What you're looking for, in words."
    }
  }
}
search_docs annotations
{
  "title": "Search Candor UI docs",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_component_docs — Read a Candor UI docs page
Advertised by the server during the last successful anonymous check.
Advertised read-only

Read one item's docs as Markdown: what it is, its tier and install command, an example with the import paths an app uses, every prop, function, type, and the LocaleProvider string keys.

get_component_docs input schema
{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "The registry name, e.g. \"thread\", \"approval-request\" or \"cost-guard-claude\"."
    }
  }
}
get_component_docs annotations
{
  "title": "Read a Candor UI docs page",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
suggest_components — Suggest Candor UI components for a task
Advertised by the server during the last successful anonymous check.
Advertised read-only

Describe the screen or feature you're building; get the Candor UI items that fit, why, the matching patterns, and one install command. Read each suggestion's docs before using it.

suggest_components input schema
{
  "type": "object",
  "required": [
    "task"
  ],
  "properties": {
    "task": {
      "type": "string",
      "description": "What you're building, e.g. \"a chat where the agent asks before deploying\"."
    },
    "tier": {
      "enum": [
        "free",
        "pro",
        "premium"
      ],
      "type": "string",
      "description": "Only suggest what this tier unlocks. Leave it out to see everything, with tiers marked."
    }
  }
}
suggest_components annotations
{
  "title": "Suggest Candor UI components",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
list_components — List Candor UI components
Advertised by the server during the last successful anonymous check.
Advertised read-only

List every item by group (Chat, Agent work, App shell, …), or one group's items with descriptions.

list_components input schema
{
  "type": "object",
  "properties": {
    "tier": {
      "enum": [
        "free",
        "pro",
        "premium"
      ],
      "type": "string",
      "description": "Only items this tier unlocks."
    },
    "group": {
      "type": "string",
      "description": "A group's title, e.g. \"Chat\" or \"Full-stack blocks\". Leave it out for the overview."
    }
  }
}
list_components annotations
{
  "title": "List Candor UI components",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_pattern — Read a Candor UI pattern
Advertised by the server during the last successful anonymous check.
Advertised read-only

Read a pattern as Markdown: a common problem in agent UIs (approvals, traces, cost guards, …) and the components that solve it.

get_pattern input schema
{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "The pattern's slug, as search_docs or suggest_components gives it."
    }
  }
}
get_pattern annotations
{
  "title": "Read a Candor UI pattern",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_started — How to set up Candor UI
Advertised by the server during the last successful anonymous check.
Advertised read-only

How to install Candor UI in a React or Next.js app, render a chat, connect an agent SDK, add licensed items and keep them updated.

get_started input schema
{
  "type": "object",
  "properties": {}
}
get_started annotations
{
  "title": "How to set up Candor UI",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_brief — A brief for a coding agent
Advertised by the server during the last successful anonymous check.
Advertised read-only

One item's brief to hand to the coding agent that builds the screen: the same Markdown the docs page's "Copy for a coding agent" button copies (what the item is, its tier and install command, an example with the import paths an app uses, every prop, the string keys, and the rules to keep).

get_brief input schema
{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "The registry name, e.g. \"thread\" or \"approval-request\"."
    }
  }
}
get_brief annotations
{
  "title": "A brief for a coding agent",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_design — Candor UI's design system
Advertised by the server during the last successful anonymous check.
Advertised read-only

The design system as Markdown: every colour role and what it's for, the type scale, radius, shadows, motion, density and themes, read from the shipped CSS; how an app re-tokens for its brand; and how to build the screens around Candor components (surfaces, rhythm, writing, do and don't).

get_design input schema
{
  "type": "object",
  "properties": {}
}
get_design annotations
{
  "title": "Candor UI's design system",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_review_checklist — Review checklist for agent UI screens
Advertised by the server during the last successful anonymous check.
Advertised read-only

The checklist to run after each screen where an AI agent acts, before moving on: one line per check, each tied to a rule (model output is text, unknown stays unknown, a locked control says why, nothing pre-selected, approve the exact change, reasoning is believed, the app names the agent, say what can be undone, plus status, progress and accessibility). From the candor-agent-ui skill; works with or without Candor.

get_review_checklist input schema
{
  "type": "object",
  "properties": {}
}
get_review_checklist annotations
{
  "title": "Review checklist for agent UI screens",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
391 ms
95th percentile latency
391 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 391 ms · metadata changed · 9 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http candor-ui-mcp https://candor.themethodic.com/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add candor-ui-mcp --url https://candor.themethodic.com/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable candor-ui-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "candor-ui-mcp": {
      "url": "https://candor.themethodic.com/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "candor-ui-mcp": {
      "type": "streamableHttp",
      "url": "https://candor.themethodic.com/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start candor-ui-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "candor-ui-mcp": {
      "type": "http",
      "url": "https://candor.themethodic.com/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http candor-ui-mcp https://candor.themethodic.com/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://candor.themethodic.com/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "candor-ui-mcp": {
      "serverUrl": "https://candor.themethodic.com/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Candor UI MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Do you run Candor UI MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing