Skip to main content

MCP Server

Model Context Protocol server for gentleduck/ui — use your component library directly from AI coding assistants.

9 tools

Everything your AI needs to build with duck‑ui

Each tool is purpose-built to minimize token usage while maximizing accuracy. Browse, search, read, and introspect the entire duck‑ui ecosystem — without leaving your AI assistant.

list_docs

Browse the documentation catalog with pagination. Filter by category — components, installation, packages, changelog, and more.

search_docs

Full-text search with typo tolerance across all 100+ pages. Results ranked by relevance — title matches score highest.

read_doc

Read any doc page with JSX/MDX stripped. Supports full, summary, and section modes to minimize token usage.

get_component_api

Extracts only the props table from a component page. The most token-efficient way to look up component APIs.

get_examples

Returns all code blocks from a doc page without the surrounding prose — just imports, JSX, and configuration.

get_changelog

Get changelog entries filtered by version or component. Useful for checking what changed in a specific release.

get_installation

Get the setup guide for a framework by name — Next.js, Vite, Remix, Astro. Fuzzy-matched so "nextjs" works too.

suggest_components

Describe what you need and get ranked component suggestions. Uses fuzzy matching across titles, descriptions, and content.

semantic_search

Natural language search using TF-IDF + cosine similarity. "popup overlay" finds dialog even without exact keyword matches.

Quick setup

One URL. Works with Claude, Cursor, and Windsurf.

# Claude Code (CLI)
claude mcp add duck-ui --transport http https://gentleduck.org/api/mcp

# Claude Desktop / Cursor / Windsurf (mcp.json)
{
  "mcpServers": {
    "duck-ui": {
      "url": "https://gentleduck.org/api/mcp"
    }
  }
}

Free & open source

gentleduck is MIT licensed and will always be free and open source. Every package ships with full source access — fork it, modify it, own it.

Become a Sponsor