{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "mcp-servers",
  "title": "MCP servers",
  "description": "Manage Model Context Protocol (MCP) servers connected to an AI agent: connection status, OAuth reconnect, and an expandable tool drawer with per-tool switches and call counts.",
  "dependencies": [
    "lucide-react",
    "motion"
  ],
  "registryDependencies": [
    "utils"
  ],
  "files": [
    {
      "path": "registry/components/mcp-servers.tsx",
      "content": "\"use client\";\n\nimport { useEffect, useId, useRef, useState } from \"react\";\nimport { ChevronDown, ExternalLink, Plug, RefreshCw, Wrench } from \"lucide-react\";\nimport { AnimatePresence, motion, useReducedMotion } from \"motion/react\";\nimport { cn } from \"@/lib/utils\";\n\nexport type McpServerStatus = \"connected\" | \"auth-required\" | \"connecting\" | \"error\";\n\nexport type McpTool = {\n  name: string;\n  description: string;\n  enabled: boolean;\n  /** Times the agent called this tool in the current session. */\n  calls?: number;\n  /** Short signature, e.g. \"(query: string, limit?: number) → Match[]\". */\n  schema?: string;\n};\n\nexport type McpServer = {\n  id: string;\n  name: string;\n  transport?: \"stdio\" | \"http\" | \"sse\";\n  status: McpServerStatus;\n  latencyMs?: number;\n  authUrl?: string;\n  error?: string;\n  tools: McpTool[];\n};\n\nexport type McpServersProps = {\n  servers?: McpServer[];\n  title?: string;\n  /** Called when a tool's enabled switch is toggled. */\n  onToggleTool?: (serverId: string, toolName: string, enabled: boolean) => void;\n  /** Called when Reconnect / Sign in is clicked on a server. */\n  onReconnect?: (serverId: string) => void;\n  /** Loop a scripted connection & tool-call demo. */\n  autoPlay?: boolean;\n  className?: string;\n};\n\nconst DEFAULT_SERVERS: McpServer[] = [\n  {\n    id: \"code\",\n    name: \"Code Host\",\n    transport: \"http\",\n    status: \"connected\",\n    latencyMs: 38,\n    tools: [\n      { name: \"search_code\", description: \"Search code across repositories\", enabled: true, calls: 7, schema: \"(query: string, repo?: string) → Match[]\" },\n      { name: \"create_pull_request\", description: \"Open a pull request from a branch\", enabled: true, calls: 2, schema: \"(head: string, base: string, title: string) → PR\" },\n      { name: \"merge_pull_request\", description: \"Merge an approved pull request\", enabled: false, schema: \"(number: number, method?: \\\"squash\\\") → void\" },\n    ],\n  },\n  {\n    id: \"warehouse\",\n    name: \"Warehouse SQL\",\n    transport: \"stdio\",\n    status: \"error\",\n    error: \"Handshake timed out after 10s\",\n    tools: [\n      { name: \"run_query\", description: \"Run read-only SQL against the warehouse\", enabled: true, calls: 4, schema: \"(sql: string, limit?: number) → Row[]\" },\n      { name: \"list_tables\", description: \"List schemas, tables and row counts\", enabled: true, calls: 1, schema: \"(schema?: string) → Table[]\" },\n      { name: \"write_rows\", description: \"Insert or update rows in staging\", enabled: true, schema: \"(table: string, rows: Row[]) → number\" },\n    ],\n  },\n  {\n    id: \"tracker\",\n    name: \"Issue Tracker\",\n    transport: \"sse\",\n    status: \"auth-required\",\n    authUrl: \"#\",\n    tools: [\n      { name: \"list_issues\", description: \"Query assigned issues and cycles\", enabled: true, schema: \"(assignee?: string) → Issue[]\" },\n      { name: \"create_issue\", description: \"File a new issue in a team\", enabled: true, schema: \"(team: string, title: string) → Issue\" },\n    ],\n  },\n];\n\nconst EASE = [0.22, 1, 0.36, 1] as const;\nconst TICK = 100;\nconst LOOP = 9400;\n\n/** Steps a demo clock while the card is on screen. Stops when off screen or paused. */\nfunction useDemoClock(enabled: boolean, loop: number) {\n  const ref = useRef<HTMLDivElement>(null);\n  const [visible, setVisible] = useState(false);\n  const [elapsed, setElapsed] = useState(0);\n  useEffect(() => {\n    const el = ref.current;\n    if (!el || !enabled) return;\n    const io = new IntersectionObserver(([entry]) => setVisible(entry.isIntersecting));\n    io.observe(el);\n    return () => io.disconnect();\n  }, [enabled]);\n  useEffect(() => {\n    if (!enabled || !visible) return;\n    const id = setInterval(() => setElapsed((e) => e + TICK), TICK);\n    return () => clearInterval(id);\n  }, [enabled, visible]);\n  return { ref, t: elapsed % loop };\n}\n\ntype View = { servers: McpServer[]; openId: string | null; active: string | null; pressing: string | null };\n\nfunction clone(servers: McpServer[]) {\n  return servers.map((s) => ({ ...s, tools: s.tools.map((t) => ({ ...t })) }));\n}\n\nfunction demoView(t: number): View {\n  const servers = clone(DEFAULT_SERVERS);\n  const [code, wh] = servers;\n  const bump = (s: McpServer, name: string) => {\n    const tool = s.tools.find((x) => x.name === name);\n    if (tool) tool.calls = (tool.calls ?? 0) + 1;\n  };\n  if (t >= 1700) bump(code, \"search_code\");\n  if (t >= 3300) bump(code, \"create_pull_request\");\n  if (t >= 4300 && t < 5600) wh.status = \"connecting\";\n  if (t >= 5600) Object.assign(wh, { status: \"connected\", latencyMs: 41, error: undefined });\n  if (t >= 7400) bump(wh, \"run_query\");\n  if (t >= 8200) wh.tools[2].enabled = false;\n  const active =\n    t >= 600 && t < 1700 ? \"code:search_code\"\n    : t >= 2300 && t < 3300 ? \"code:create_pull_request\"\n    : t >= 6500 && t < 7400 ? \"warehouse:run_query\"\n    : null;\n  return {\n    servers,\n    openId: t >= 6000 ? \"warehouse\" : \"code\",\n    active,\n    pressing: t >= 3900 && t < 4300 ? \"warehouse\" : t >= 7900 && t < 8200 ? \"warehouse:write_rows\" : null,\n  };\n}\n\nconst STATUS_META: Record<McpServerStatus, { label: string; dot: string; text: string; bar: string }> = {\n  connected: { label: \"Connected\", dot: \"bg-emerald-500\", text: \"text-emerald-700 dark:text-emerald-300\", bar: \"bg-emerald-500\" },\n  \"auth-required\": { label: \"Needs OAuth\", dot: \"bg-amber-500\", text: \"text-amber-700 dark:text-amber-300\", bar: \"bg-amber-500\" },\n  connecting: { label: \"Connecting\", dot: \"bg-sky-500\", text: \"text-sky-700 dark:text-sky-300\", bar: \"bg-sky-500\" },\n  error: { label: \"Error\", dot: \"bg-red-500\", text: \"text-red-600 dark:text-red-400\", bar: \"bg-red-500\" },\n};\n\n/** MCP servers attached to an agent: live status, OAuth / reconnect, and a tool drawer with per-tool switches, schemas and call counts. */\nexport function McpServers({\n  servers: controlledServers,\n  title = \"MCP servers\",\n  onToggleTool,\n  onReconnect,\n  autoPlay = false,\n  className,\n}: McpServersProps) {\n  const reduce = useReducedMotion() ?? false;\n  const baseId = useId();\n  const [touched, setTouched] = useState(false);\n  const [view, setView] = useState<View>({ servers: DEFAULT_SERVERS, openId: \"code\", active: null, pressing: null });\n  const demo = autoPlay && !reduce && !touched && !controlledServers;\n  const { ref, t } = useDemoClock(demo, LOOP);\n\n  // Sync the scripted frame during render (no effect → no extra commit per tick).\n  const [syncedT, setSyncedT] = useState(-1);\n  if (demo && t !== syncedT) {\n    setSyncedT(t);\n    setView(demoView(t));\n  }\n\n  const servers = controlledServers ?? view.servers;\n  const { openId, active, pressing } = view;\n\n  const setServers = (fn: (prev: McpServer[]) => McpServer[]) => setView((v) => ({ ...v, servers: fn(v.servers) }));\n\n  const toggleOpen = (id: string) => {\n    setTouched(true);\n    setView((v) => ({ ...v, openId: v.openId === id ? null : id, active: null, pressing: null }));\n  };\n\n  const handleToggleTool = (serverId: string, toolName: string) => {\n    setTouched(true);\n    const tool = servers.find((s) => s.id === serverId)?.tools.find((x) => x.name === toolName);\n    if (!tool) return;\n    const next = !tool.enabled;\n    onToggleTool?.(serverId, toolName, next);\n    if (!controlledServers)\n      setServers((prev) =>\n        prev.map((s) => (s.id === serverId ? { ...s, tools: s.tools.map((x) => (x.name === toolName ? { ...x, enabled: next } : x)) } : s)),\n      );\n  };\n\n  const handleReconnect = (serverId: string) => {\n    setTouched(true);\n    onReconnect?.(serverId);\n    if (controlledServers) return;\n    setServers((prev) => prev.map((s) => (s.id === serverId ? { ...s, status: \"connecting\" } : s)));\n    setTimeout(() => {\n      setServers((prev) =>\n        prev.map((s) => (s.id === serverId ? { ...s, status: \"connected\", latencyMs: 44, error: undefined } : s)),\n      );\n    }, 1200);\n  };\n\n  const live = servers.filter((s) => s.status === \"connected\");\n  const toolCount = live.reduce((n, s) => n + s.tools.filter((x) => x.enabled).length, 0);\n\n  return (\n    <div ref={ref} className={cn(\"w-full max-w-md text-sm\", className)}>\n      <div className=\"overflow-hidden rounded-2xl border bg-card text-card-foreground shadow-[0_1px_2px_rgb(0_0_0/0.04),0_12px_32px_-18px_rgb(0_0_0/0.25)]\">\n        {/* Header */}\n        <div className=\"flex items-center gap-3 border-b bg-gradient-to-b from-muted/50 to-transparent px-4 py-3\">\n          <span className=\"grid size-8 shrink-0 place-items-center rounded-lg border bg-background shadow-xs\">\n            <Plug className=\"size-4\" aria-hidden />\n          </span>\n          <div className=\"min-w-0 flex-1\">\n            <p className=\"truncate font-medium leading-tight\">{title}</p>\n            <p className=\"mt-0.5 text-xs text-muted-foreground tabular-nums\" aria-live=\"polite\">\n              {live.length} of {servers.length} connected · {toolCount} tools live\n            </p>\n          </div>\n          <div className=\"flex shrink-0 items-center gap-1\" aria-hidden>\n            {servers.map((s) => (\n              <motion.span\n                key={s.id}\n                layout\n                className={cn(\"h-4 w-1.5 rounded-full transition-colors duration-500\", STATUS_META[s.status].bar, s.status === \"connecting\" && \"animate-pulse\")}\n              />\n            ))}\n          </div>\n        </div>\n\n        <ul className=\"divide-y\">\n          {servers.map((server) => {\n            const isOpen = openId === server.id;\n            const panelId = `${baseId}-${server.id}`;\n            const meta = STATUS_META[server.status];\n            const enabled = server.tools.filter((x) => x.enabled).length;\n            const calls = server.tools.reduce((n, x) => n + (x.calls ?? 0), 0);\n            const needsAction = server.status === \"auth-required\" || server.status === \"error\";\n            return (\n              <li key={server.id} className={cn(\"transition-colors duration-300\", isOpen && \"bg-muted/30\")}>\n                <div className=\"flex items-center gap-3 px-4 py-2.5\">\n                  <button\n                    type=\"button\"\n                    aria-expanded={isOpen}\n                    aria-controls={panelId}\n                    onClick={() => toggleOpen(server.id)}\n                    className=\"flex min-w-0 flex-1 cursor-pointer items-center gap-3 rounded-md text-left outline-none focus-visible:ring-2 focus-visible:ring-ring\"\n                  >\n                    <span className=\"relative grid size-8 shrink-0 place-items-center rounded-lg border bg-gradient-to-br from-background to-muted font-mono text-[11px] font-semibold tracking-tight\">\n                      {monogram(server.name)}\n                      <span className=\"absolute -right-0.5 -bottom-0.5 grid size-2.5 place-items-center\">\n                        {server.status === \"connecting\" && !reduce && (\n                          <span className={cn(\"absolute inset-0 animate-ping rounded-full opacity-70\", meta.dot)} />\n                        )}\n                        <span className={cn(\"relative size-2.5 rounded-full ring-2 ring-card transition-colors duration-500\", meta.dot)} />\n                      </span>\n                    </span>\n                    <span className=\"min-w-0 flex-1\">\n                      <span className=\"flex items-center gap-1.5\">\n                        <span className=\"truncate font-medium\">{server.name}</span>\n                        {server.transport && (\n                          <span className=\"rounded border bg-background px-1 font-mono text-[9px] uppercase tracking-wide text-muted-foreground\">\n                            {server.transport}\n                          </span>\n                        )}\n                      </span>\n                      <AnimatePresence mode=\"popLayout\" initial={false}>\n                        <motion.span\n                          key={server.status}\n                          initial={reduce ? false : { opacity: 0, y: 6, filter: \"blur(2px)\" }}\n                          animate={{ opacity: 1, y: 0, filter: \"blur(0px)\" }}\n                          exit={reduce ? undefined : { opacity: 0, y: -6, filter: \"blur(2px)\" }}\n                          transition={{ duration: 0.28, ease: EASE }}\n                          className={cn(\"block truncate text-xs\", server.status === \"error\" ? meta.text : \"text-muted-foreground\")}\n                        >\n                          {server.status === \"connected\"\n                            ? `${enabled}/${server.tools.length} tools · ${server.latencyMs ?? \"—\"}ms · ${calls} calls`\n                            : server.status === \"connecting\"\n                              ? \"Handshaking · listing tools…\"\n                              : server.status === \"auth-required\"\n                                ? \"Sign in to grant access\"\n                                : (server.error ?? \"Connection lost\")}\n                        </motion.span>\n                      </AnimatePresence>\n                    </span>\n                  </button>\n\n                  <AnimatePresence mode=\"popLayout\" initial={false}>\n                    {needsAction ? (\n                      <motion.button\n                        key=\"action\"\n                        type=\"button\"\n                        onClick={() => handleReconnect(server.id)}\n                        initial={reduce ? false : { opacity: 0, scale: 0.9 }}\n                        animate={{ opacity: 1, scale: pressing === server.id ? 0.92 : 1 }}\n                        exit={reduce ? undefined : { opacity: 0, scale: 0.9 }}\n                        transition={{ type: \"spring\", stiffness: 500, damping: 30 }}\n                        className={cn(\n                          \"inline-flex h-7 shrink-0 cursor-pointer items-center gap-1.5 rounded-md border px-2.5 text-xs font-medium shadow-xs outline-none transition-colors focus-visible:ring-2 focus-visible:ring-ring\",\n                          server.status === \"error\" ? \"bg-foreground text-background hover:opacity-90\" : \"bg-background hover:bg-muted\",\n                        )}\n                      >\n                        {server.status === \"error\" ? (\n                          <>\n                            <RefreshCw className=\"size-3\" aria-hidden />\n                            Reconnect\n                          </>\n                        ) : (\n                          <>\n                            Sign in\n                            <ExternalLink className=\"size-3 text-muted-foreground\" aria-hidden />\n                          </>\n                        )}\n                      </motion.button>\n                    ) : (\n                      <motion.span\n                        key=\"badge\"\n                        initial={reduce ? false : { opacity: 0, scale: 0.9 }}\n                        animate={{ opacity: 1, scale: 1 }}\n                        exit={reduce ? undefined : { opacity: 0, scale: 0.9 }}\n                        transition={{ type: \"spring\", stiffness: 500, damping: 30 }}\n                        className={cn(\"inline-flex h-6 shrink-0 items-center gap-1.5 rounded-full border bg-background px-2 text-[11px] font-medium\", meta.text)}\n                      >\n                        {server.status === \"connecting\" ? (\n                          <RefreshCw className={cn(\"size-3\", !reduce && \"animate-spin\")} aria-hidden />\n                        ) : (\n                          <span className={cn(\"size-1.5 rounded-full\", meta.dot)} />\n                        )}\n                        {meta.label}\n                      </motion.span>\n                    )}\n                  </AnimatePresence>\n\n                  <button\n                    type=\"button\"\n                    aria-label={`${isOpen ? \"Hide\" : \"Show\"} ${server.name} tools`}\n                    onClick={() => toggleOpen(server.id)}\n                    className=\"grid size-6 shrink-0 cursor-pointer place-items-center rounded-md text-muted-foreground outline-none transition-colors hover:bg-muted hover:text-foreground focus-visible:ring-2 focus-visible:ring-ring\"\n                  >\n                    <ChevronDown className={cn(\"size-3.5 transition-transform duration-300\", isOpen && \"rotate-180\")} aria-hidden />\n                  </button>\n                </div>\n\n                <AnimatePresence initial={false}>\n                  {isOpen && (\n                    <motion.div\n                      id={panelId}\n                      initial={reduce ? false : { height: 0, opacity: 0 }}\n                      animate={{ height: \"auto\", opacity: 1 }}\n                      exit={reduce ? undefined : { height: 0, opacity: 0 }}\n                      transition={{ duration: 0.35, ease: EASE }}\n                      className=\"overflow-hidden\"\n                    >\n                      <div className=\"px-4 pb-3\">\n                        <div className=\"divide-y overflow-hidden rounded-xl border bg-background\">\n                        {server.tools.map((tool, i) => {\n                          const running = active === `${server.id}:${tool.name}`;\n                          const off = !tool.enabled || server.status !== \"connected\";\n                          return (\n                            <motion.div\n                              key={tool.name}\n                              initial={reduce ? false : { opacity: 0, y: 6 }}\n                              animate={{ opacity: 1, y: 0 }}\n                              transition={{ duration: 0.3, delay: 0.05 + i * 0.05, ease: EASE }}\n                              className={cn(\n                                \"relative flex items-center gap-2.5 px-2.5 py-2 transition-colors duration-300\",\n                                running && \"bg-muted/50\",\n                              )}\n                            >\n                              {running && !reduce && <span className=\"mcp-sweep pointer-events-none absolute inset-0\" aria-hidden />}\n                              <span className={cn(\"grid size-6 shrink-0 place-items-center rounded-md bg-muted text-muted-foreground transition-opacity\", off && \"opacity-50\")}>\n                                <Wrench className=\"size-3\" aria-hidden />\n                              </span>\n                              <div className={cn(\"relative min-w-0 flex-1 transition-opacity duration-300\", off && \"opacity-55\")}>\n                                <div className=\"flex items-center gap-1.5\">\n                                  <span className=\"truncate font-mono text-[11px] font-medium\">{tool.name}</span>\n                                  {!!tool.calls && (\n                                    <motion.span\n                                      key={tool.calls}\n                                      initial={reduce ? false : { scale: 1.5, opacity: 0.4 }}\n                                      animate={{ scale: 1, opacity: 1 }}\n                                      transition={{ type: \"spring\", stiffness: 600, damping: 18 }}\n                                      className=\"rounded-full bg-muted px-1.5 font-mono text-[10px] tabular-nums text-muted-foreground\"\n                                      title={`${tool.calls} calls this session`}\n                                    >\n                                      {tool.calls}×\n                                    </motion.span>\n                                  )}\n                                  {running && (\n                                    <span className=\"inline-flex items-center gap-1 rounded-full bg-foreground px-1.5 text-[10px] font-medium text-background\">\n                                      <span className={cn(\"size-1 rounded-full bg-background\", !reduce && \"animate-pulse\")} />\n                                      calling\n                                    </span>\n                                  )}\n                                </div>\n                                <p className=\"mt-0.5 truncate font-mono text-[10px] text-muted-foreground\" title={tool.description}>\n                                  {tool.schema ?? tool.description}\n                                </p>\n                              </div>\n                              <Switch\n                                checked={tool.enabled}\n                                pressing={pressing === `${server.id}:${tool.name}`}\n                                label={`Allow ${tool.name}`}\n                                onChange={() => handleToggleTool(server.id, tool.name)}\n                                reduce={reduce}\n                              />\n                            </motion.div>\n                          );\n                        })}\n                        </div>\n                      </div>\n                    </motion.div>\n                  )}\n                </AnimatePresence>\n              </li>\n            );\n          })}\n        </ul>\n      </div>\n      <style>{`\n        .mcp-sweep {\n          background: linear-gradient(100deg, transparent 30%, color-mix(in oklab, var(--foreground) 7%, transparent) 50%, transparent 70%);\n          background-size: 250% 100%;\n          animation: mcp-sweep 1.2s linear infinite;\n        }\n        @keyframes mcp-sweep { from { background-position: 120% 0; } to { background-position: -20% 0; } }\n      `}</style>\n    </div>\n  );\n}\n\nfunction monogram(name: string) {\n  return name\n    .split(/\\s+/)\n    .slice(0, 2)\n    .map((w) => w[0])\n    .join(\"\")\n    .toUpperCase();\n}\n\nfunction Switch({\n  checked,\n  onChange,\n  label,\n  pressing,\n  reduce,\n}: {\n  checked: boolean;\n  onChange: () => void;\n  label: string;\n  pressing?: boolean;\n  reduce: boolean;\n}) {\n  return (\n    <motion.button\n      type=\"button\"\n      role=\"switch\"\n      aria-checked={checked}\n      aria-label={label}\n      onClick={onChange}\n      animate={{ scale: pressing ? 0.9 : 1 }}\n      className={cn(\n        \"relative h-[18px] w-8 shrink-0 cursor-pointer rounded-full outline-none transition-colors duration-300 focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2\",\n        checked ? \"bg-foreground\" : \"bg-muted-foreground/25\",\n      )}\n    >\n      <motion.span\n        className=\"absolute top-[2px] left-[2px] size-[14px] rounded-full bg-background shadow-sm\"\n        animate={{ x: checked ? 14 : 0 }}\n        transition={reduce ? { duration: 0 } : { type: \"spring\", stiffness: 700, damping: 32 }}\n      />\n    </motion.button>\n  );\n}\n\nexport default function McpServersDemo() {\n  return (\n    <div className=\"flex h-[420px] w-full items-start justify-center pt-2\">\n      <McpServers autoPlay />\n    </div>\n  );\n}\n",
      "type": "registry:component",
      "target": "components/nextui/mcp-servers.tsx"
    }
  ],
  "meta": {
    "kind": "component",
    "category": "ai",
    "previewHeight": 440,
    "new": true,
    "free": true,
    "openSource": true,
    "added": "2026-11-06"
  },
  "categories": [
    "ai"
  ],
  "type": "registry:component"
}