@assistant-ui/mcp-docs-server 0.1.35 → 0.1.38

package/.docs/raw/docs/tools/mcp-apps.mdx

@@ -24,6 +24,12 @@ Capability presence is determined at mount time by which handlers you provide. U
 
 The renderer talks to a backend route you expose — the MCP client lives server-side so credentials and transport stay out of the browser. The route receives `{ method, params }` POSTs and dispatches to your MCP client.
 
+### Install the MCP client
+
+Install the AI SDK MCP client package used by the route handler:
+
+<InstallCommand npm={["@ai-sdk/mcp"]} />
+
 ### Client
 
 Compose `McpAppRenderer({...})` into your `Tools` resource. Provide `host.url` pointing at your route. Any tool-call part carrying `mcp.app` metadata renders the MCP App widget automatically.
@@ -61,12 +67,15 @@ The route accepts `POST` requests with `{ method, params }` JSON bodies. Dispatc
 
 ```ts
 // app/api/mcp-apps/route.ts
-import { experimental_createMCPClient } from "ai";
+import { createMCPClient } from "@ai-sdk/mcp";
 
-let clientPromise: ReturnType<typeof experimental_createMCPClient> | undefined;
+let clientPromise: ReturnType<typeof createMCPClient> | undefined;
 const getClient = () => {
-  clientPromise ??= experimental_createMCPClient({
+  clientPromise ??= createMCPClient({
     transport: { type: "sse", url: process.env.MCP_SERVER_URL! },
+  }).catch((error) => {
+    clientPromise = undefined;
+    throw error;
   });
   return clientPromise;
 };

package/.docs/raw/docs/tools/mcp.mdx

@@ -7,10 +7,10 @@ description: Connect MCP servers as a tool catalog in your assistant-ui app.
 
 ## How it works
 
-```
-client  ──►  /api/chat  ──►  MCP client  ──►  MCP server (HTTP, SSE, stdio)
-                            │
-                            └─ tools()  ──►  passed to streamText({ tools })
+```mermaid
+flowchart LR
+    client["client"] --> api["/api/chat"] --> mcp["MCP client"] --> server["MCP server<br/>(HTTP, SSE, stdio)"]
+    mcp --> tools["tools()"] --> stream["passed to<br/>streamText({ tools })"]
 ```
 
 The MCP client lives on the server inside your AI SDK route handler. It connects to one or more MCP servers, calls `tools()` to get a tool map, and hands that map to `streamText`. assistant-ui's existing tool-call UI (`ToolFallback`, or toolkit entries with `render`) renders the results.
@@ -93,6 +93,7 @@ export default defineToolkit({
     github: {
       type: "http",
       url: "https://mcp.example.com/mcp",
+      connectionTimeout: 10_000,
     },
   }),
 });
@@ -101,6 +102,10 @@ export default defineToolkit({
 Use `AISDKToolkit` in the route. It opens the MCP clients, merges their tools
 with the rest of your toolkit, and closes them when you call `close()`:
 
+`connectionTimeout` is optional and measured in milliseconds. Set it to fail
+the server-side MCP readiness flow (`createMCPClient()` plus `tools()`) before
+a bad URL or hanging local process can stall the route.
+
 ```ts title="app/api/chat/route.ts"
 import { AISDKToolkit } from "@assistant-ui/react-ai-sdk";
 import { openai } from "@ai-sdk/openai";

package/.docs/raw/docs/tools/multi-agent.mdx

@@ -16,6 +16,10 @@ Key behaviors:
 - **Recursive** — Sub-agent messages can contain tool calls that themselves have nested messages. Just use `MessagePartPrimitive.Messages` again.
 - **Read-only** — Sub-agent messages are rendered in a readonly context. No editing, branching, or composing.
 
+<Callout type="info">
+  This renders a sub-agent's **messages**. To visualize a sub-agent's **execution trace** instead (timing, span hierarchy, waterfalls), see [react-o11y](/docs/utilities/react-o11y), which renders observability spans as collapsible trees and timelines.
+</Callout>
+
 ## Quick Start
 
 <Steps>
@@ -226,6 +230,7 @@ function SubConversation({
 ## Related
 
 - [Generative UI](/docs/tools/tool-ui) — Creating tool call UIs
+- [react-o11y](/docs/utilities/react-o11y) — Visualize sub-agent execution as collapsible span trees, waterfalls, and call timelines
 - [MessagePartPrimitive](/docs/api-reference/primitives/message-part) — API reference for message part primitives
 - [Sub-Agent Model Tracking](/docs/cloud/ai-sdk#sub-agent-model-tracking) — Track delegated model usage and costs in the Cloud dashboard
 - [LangGraph Streaming](/docs/runtimes/langgraph/streaming) — Event handlers, subgraph events, and message metadata

package/.docs/raw/docs/tools/user-managed-mcp.mdx

@@ -59,20 +59,28 @@ const connectors = [
     name: "Weather",
     url: "https://mcp.example.com/weather",
     auth: { type: "none" },
+    connectionTimeout: 10_000,
   }),
 ];
 
 export function Providers({ children }: { children: React.ReactNode }) {
-  const aui = useAui({ mcp: McpManagerResource({ connectors }) });
+  const aui = useAui({
+    mcp: McpManagerResource({
+      connectors,
+      connectionTimeout: 15_000,
+    }),
+  });
   return <AuiProvider value={aui}>{children}</AuiProvider>;
 }
 ```
 
-Defaults baked in:
+Defaults and useful options:
 
 - `storage` — `McpLocalStorage()` (override for production; see [Storage](#storage))
 - `oauthRedirectUri` — `${window.location.origin}/mcp/callback`
 - `autoConnect` — `true` (connect on mount when usable auth is persisted)
+- `connectionTimeout` — optional timeout in milliseconds. Set it on the manager as a default or on a connector/custom server to bound the MCP readiness flow (`connect()` plus `listTools()`) with a clear error.
+- Connector `id` values must be unique. The id is used for server lookup, OAuth routing, and model-visible tool names such as `linear__search`.
 
 </Step>
 <Step>
@@ -208,14 +216,20 @@ The callback reads `?state=...&code=...` from the URL, derives the target server
 
 ```tsx
 "use client";
+import { lastAssistantMessageIsCompleteWithToolCalls } from "ai";
 import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
 
 export function Chat() {
-  const runtime = useChatRuntime({ api: "/api/chat" });
+  const runtime = useChatRuntime({
+    api: "/api/chat",
+    sendAutomaticallyWhen: lastAssistantMessageIsCompleteWithToolCalls,
+  });
   /* … */
 }
 ```
 
+`sendAutomaticallyWhen` sends completed frontend tool results back to the server so the model can continue after a tool call.
+
 Tool names are prefixed `serverId__toolName` to avoid collisions across connected servers. The toolkit re-registers whenever a server connects / disconnects or its tool list changes.
 
 If no chat runtime is mounted, `McpManagerResource` brings its own minimal `modelContext` along. Tools are still callable directly:

package/.docs/raw/docs/ui/composer-trigger-popover.mdx

@@ -185,6 +185,8 @@ The popover implements the WAI-ARIA editable combobox pattern.
 | `backLabel` | `string` | `"Back"` | Back button label |
 | `emptyCategoriesLabel` | `string` | `"No items available"` | Shown when no categories are available |
 | `emptyItemsLabel` | `string` | `"No matching items"` | Shown when no items match |
+| `isLoading` | `boolean` | `false` | Whether the adapter is resolving items (async sources). Pair with `unstable_useLiveCompletionAdapter`. |
+| `loadingLabel` | `string` | `"Loading…"` | Shown in place of `emptyItemsLabel` while `isLoading` and no items are present |
 
 All other props (`className`, etc.) forward to the underlying popover `div`.
 

package/.docs/raw/docs/ui/file.mdx

@@ -27,7 +27,7 @@ Pass `File` to `MessagePrimitive.Parts`:
 ```tsx title="/components/assistant-ui/thread.tsx" {1,8}
 import { File } from "@/components/assistant-ui/file";
 
-const AssistantMessage: FC = () => {
+const UserMessage: FC = () => {
   return (
     <MessagePrimitive.Root className="...">
       <MessagePrimitive.Parts>

package/.docs/raw/docs/ui/follow-up-suggestions.mdx

@@ -0,0 +1,80 @@
+---
+title: Follow-Up Suggestions
+description: Render runtime-generated follow-up prompt chips after an assistant response.
+platforms: ["react"]
+---
+
+import { FollowUpSuggestionsSample } from "@/components/docs/samples/follow-up-suggestions";
+
+<FollowUpSuggestionsSample />
+
+`ThreadFollowupSuggestions` renders the current thread's runtime suggestions as clickable prompt chips. Use it for follow-up prompts that arrive after a response, such as suggested next questions, refinements, or task shortcuts.
+
+<Callout type="info">
+  This component reads from `thread.suggestions`. For static welcome-screen prompts, use `ThreadPrimitive.Suggestions` instead.
+</Callout>
+
+## Getting Started
+
+<Steps>
+  <Step>
+
+### Add `follow-up-suggestions`
+
+<InstallCommand shadcn={["follow-up-suggestions"]} />
+
+This adds a `/components/assistant-ui/follow-up-suggestions.tsx` file to your project.
+
+  </Step>
+  <Step>
+
+### Provide runtime suggestions
+
+Pass suggestions through your runtime. External-store runtimes, AI SDK runtimes, and local runtimes can all surface follow-up prompts through `thread.suggestions`.
+
+```tsx title="/app/assistant.tsx" {7-10}
+const runtime = useExternalStoreRuntime({
+  messages,
+  convertMessage,
+  onNew: async (message) => {
+    // append the message in your store
+  },
+  suggestions: [
+    { prompt: "Summarize this as action items" },
+    { prompt: "Write a shorter version" },
+  ],
+});
+```
+
+  </Step>
+  <Step>
+
+### Render after messages
+
+Place `ThreadFollowupSuggestions` near the bottom of your thread viewport, after the assistant message list and before the composer.
+
+```tsx title="/components/assistant-ui/thread.tsx" {1,10}
+import { ThreadFollowupSuggestions } from "@/components/assistant-ui/follow-up-suggestions";
+
+const ThreadViewportFooter = () => {
+  return (
+    <ThreadPrimitive.ViewportFooter>
+      <ThreadPrimitive.ScrollToBottom />
+      <ThreadFollowupSuggestions />
+      <Composer />
+    </ThreadPrimitive.ViewportFooter>
+  );
+};
+```
+
+  </Step>
+</Steps>
+
+## Behavior
+
+The component only renders when the thread is not empty and not currently running. Each suggestion uses `ThreadPrimitive.Suggestion`, replaces the composer text with the prompt, and sends it immediately.
+
+## Related Components
+
+- [Thread](/docs/ui/thread) - Complete chat interface with message list and composer
+- [Suggestions guide](/docs/guides/suggestions) - Runtime and static suggestion patterns

package/.docs/raw/docs/ui/model-selector.mdx

@@ -149,7 +149,7 @@ Search is opt-in. Pass `searchable` to the default component:
 <ModelSelector models={models} searchable />
 ```
 
-Or compose `ModelSelector.Search` into a custom layout. Matching runs against each model's `id`, `name`, and `keywords`; add the provider name to `keywords` so typing "openai" finds its models.
+The same prop works on `ModelSelector.Content` when it renders its default children. Or compose `ModelSelector.Search` into a custom layout. Matching runs against each model's `id`, `name`, and `keywords`; add the provider name to `keywords` so typing "openai" finds its models.
 
 ## Composition
 
@@ -204,6 +204,7 @@ import {
 | `ModelSelector.Value` | Selected model name, icon, and active effort |
 | `ModelSelector.Content` | Popover content wrapping a Command |
 | `ModelSelector.Search` | Search input that filters the list |
+| `ModelSelector.FocusAnchor` | Visually hidden input that anchors keyboard navigation when there is no search box |
 | `ModelSelector.List` | List of model items (renders all models by default) |
 | `ModelSelector.Empty` | Empty state shown when search has no matches |
 | `ModelSelector.Group` | Labeled group of items (e.g. by provider) |
@@ -213,12 +214,20 @@ import {
 
 `ModelSelector.List` is a Command list, so filtering and keyboard navigation work across groups automatically. Custom sorting is plain code: order the models before rendering items.
 
+Keyboard navigation needs a focused input to drive it. When content is unfiltered (`searchable={false}` on `ModelSelector.Content`, or the default children), `ModelSelector.Content` renders a visually hidden `ModelSelector.FocusAnchor` automatically, so custom layouts without a search box stay keyboard-operable. In a custom layout that renders neither `ModelSelector.Search` nor `searchable={false}`, place `ModelSelector.FocusAnchor` yourself to keep the list reachable from the keyboard.
+
 <Callout type="warn">
   `ModelSelector.Content` wraps a Command whose root keydown handler claims
-  <kbd>Enter</kbd> to select the highlighted model. Interactive elements
-  composed inside it (filter chips, custom effort controls) should stop
-  propagation for Enter in their own `onKeyDown` so the focused control
-  activates instead. `ModelSelector.Effort` already does this.
+  <Kbd>Enter</Kbd> to select the highlighted model and the arrow keys to move
+  through the list. Interactive elements composed inside it (filter chips,
+  custom effort controls) should stop propagation for the keys they handle in
+  their own `onKeyDown` so the focused control responds instead.
+  `ModelSelector.Effort` does this for <Kbd>Home</Kbd> / <Kbd>End</Kbd> (which
+  cmdk would otherwise use to jump to the first / last model), lets its
+  radiogroup own <Kbd>ArrowLeft</Kbd> / <Kbd>ArrowRight</Kbd>, and hands
+  <Kbd>ArrowUp</Kbd> / <Kbd>ArrowDown</Kbd> back to the model list by
+  refocusing cmdk's input, so the highlight only moves while a following
+  <Kbd>Enter</Kbd> can act on it.
 </Callout>
 
 ## Variants
@@ -247,6 +256,30 @@ Use the `size` prop to control the trigger dimensions.
 <ModelSelector size="lg" />      // Large (h-10)
 ```
 
+## Keyboard Navigation
+
+The picker is fully operable from the keyboard, including when search is disabled.
+
+| Key | Action |
+| --- | --- |
+| <Kbd>ArrowDown</Kbd> / <Kbd>ArrowUp</Kbd> | Open the popover from the focused trigger; move between models once open, returning focus to the list from the Thinking row |
+| <Kbd>Enter</Kbd> | Select the highlighted model and close |
+| <Kbd>Escape</Kbd> | Close the popover and return focus to the trigger |
+| <Kbd>Tab</Kbd> | Move from the model list to the Thinking row |
+| <Kbd>ArrowLeft</Kbd> / <Kbd>ArrowRight</Kbd> | Move between reasoning effort levels (Thinking row) |
+| <Kbd>Home</Kbd> / <Kbd>End</Kbd> | Jump to the first / last model (list) or effort level (Thinking row) |
+
+When `searchable` is set, typing filters the list; otherwise the keys above drive selection directly.
+
+## Accessibility
+
+The picker implements the WAI-ARIA combobox pattern over Popover + Command.
+
+- The trigger is `role="combobox"` with `aria-haspopup="listbox"`; Radix Popover manages `aria-expanded` and `aria-controls`.
+- The model list is a Command (cmdk) listbox: each item is `role="option"` with `aria-selected`, and the active item is tracked with `aria-activedescendant`.
+- Keyboard navigation works without a visible search box: `ModelSelector.Content` renders a visually hidden input (`ModelSelector.FocusAnchor`) that anchors cmdk's focus so the list stays reachable. Pass `searchable` to surface a real search input instead.
+- The Thinking row (`ModelSelector.Effort`) is a `role="radiogroup"` of `role="radio"` toggles with roving tabindex, so it is a single tab stop and <Kbd>ArrowLeft</Kbd> / <Kbd>ArrowRight</Kbd> move focus and select in one step. <Kbd>ArrowUp</Kbd> / <Kbd>ArrowDown</Kbd> return focus to the model list.
+
 ## How It Works
 
 The default `ModelSelector` export registers the selection with assistant-ui's `ModelContext` system:

package/.docs/raw/docs/ui/part-grouping.mdx

@@ -252,6 +252,44 @@ The synthetic `"standalone-tool-call"` key on `groupPartByType` matches all of t
   The `"mcp-app"` key is deprecated in favor of `"standalone-tool-call"`, which is a superset (it also matches MCP-app tool calls). Existing `"mcp-app"` usage keeps working.
 </Callout>
 
+### Render Tool Calls as Flat Rows
+
+The previous section keeps `"tool-call"` folded into the chain-of-thought and only lifts standalone tool UIs out. To keep reasoning collapsed in a group while every tool call renders as its own row in the message flow, map both tool keys to `[]`:
+
+```tsx
+<MessagePrimitive.GroupedParts
+  groupBy={groupPartByType({
+    reasoning: ["group-thought", "group-reasoning"],
+    "tool-call": [],
+    "standalone-tool-call": [],
+  })}
+>
+  {({ part, children }) => {
+    switch (part.type) {
+      case "group-thought":
+      case "group-reasoning":
+        return <ReasoningBlock>{children}</ReasoningBlock>;
+      case "reasoning":
+        return <Reasoning {...part} />;
+      case "tool-call":
+        return part.toolUI ?? <ToolFallback {...part} />;
+      case "text":
+        return <MarkdownText />;
+      case "indicator":
+        return <LoadingDots />;
+      default:
+        return null;
+    }
+  }}
+</MessagePrimitive.GroupedParts>
+```
+
+Adjacent `reasoning` parts still coalesce into one `group-thought`, while each tool call is a leaf at the same level as text — the `"standalone-tool-call"` entry is mapped to `[]` too so human-in-the-loop and generative-UI tools stay flat alongside routine calls instead of falling through to `"tool-call"`. Tool-call leaves keep their stable identity keys across re-renders, so rows don't remount as the message streams.
+
+<Callout type="warn">
+  This renders tool calls flat **in the message flow** — each leaf sits where the part appears, in order. It does not pin, portal, float, or otherwise move tool UIs out of the flow into a sidebar or fixed region. For out-of-flow placement you still own the layout outside `GroupedParts`.
+</Callout>
+
 ### Group by Custom Metadata
 
 Use any custom metadata in your parts for grouping:

package/.docs/raw/docs/utilities/react-o11y.mdx

@@ -1,11 +1,18 @@
 ---
 title: react-o11y
-description: Headless primitives for visualizing observability spans (traces, waterfalls).
+description: Headless primitives for visualizing observability spans as collapsible trace trees, waterfalls, and agent and LLM call timelines.
 platforms: ["react"]
 ---
 
+import { WaterfallSample } from "@/components/docs/samples/o11y/waterfall";
+import {
+  StatusSample,
+  CollapseSample,
+  StreamingSample,
+} from "@/components/docs/samples/o11y/capability-samples";
+
 <Callout type="warn">
-`@assistant-ui/react-o11y` is currently v0.0.11 and experimental. The API may change without notice.
+`@assistant-ui/react-o11y` is experimental. The API may change without notice.
 </Callout>
 
 `@assistant-ui/react-o11y` provides headless, Radix-style primitives for rendering observability spans as collapsible, indented hierarchical UIs. Use it to build trace inspectors, waterfall debug panels, or LLM call timelines on top of your own span data source.
@@ -15,6 +22,10 @@ platforms: ["react"]
 - **Tree-aware** — Automatic depth, parent / child collapse, time range computation.
 - **Reactive** — Built on the same reactive core as the runtimes, so spans stream into your UI as they change.
 
+<div className="not-prose my-6">
+  <WaterfallSample />
+</div>
+
 ## Installation
 
 <InstallCommand npm={["@assistant-ui/react-o11y"]} />
@@ -43,13 +54,12 @@ function SpanRow() {
       <SpanPrimitive.StatusIndicator className="size-2 rounded-full data-[span-status=running]:bg-yellow-500 data-[span-status=completed]:bg-green-500 data-[span-status=failed]:bg-red-500" />
       <SpanPrimitive.TypeBadge className="rounded bg-muted px-1.5 text-xs" />
       <SpanPrimitive.Name className="text-sm" />
-      <SpanPrimitive.Children components={{ Span: SpanRow }} />
     </SpanPrimitive.Root>
   );
 }
 
 export function TraceView({ spans }: { spans: SpanData[] }) {
-  const aui = useAui({ resource: SpanResource({ spans }) });
+  const aui = useAui({ span: SpanResource({ spans }) });
 
   return (
     <AuiProvider value={aui}>
@@ -61,6 +71,32 @@ export function TraceView({ spans }: { spans: SpanData[] }) {
 
 `SpanData` is the input shape your code produces (see [SpanData](#spandata)). `SpanResource` enriches it with depth, child counts, time range, and collapse state.
 
+## Examples
+
+### Status states
+
+`data-span-status` exposes each span's lifecycle, so running, completed, failed, and skipped are styled with pure CSS.
+
+<div className="not-prose my-6">
+  <StatusSample />
+</div>
+
+### Collapsible subtrees
+
+`SpanPrimitive.CollapseToggle` removes a span's descendants from the visible flat list, not just hides them. Click a chevron to collapse a subtree.
+
+<div className="not-prose my-6">
+  <CollapseSample />
+</div>
+
+### Streaming spans
+
+`SpanResource` re-derives the tree whenever the `spans` prop changes, so spans stream in and update live.
+
+<div className="not-prose my-6">
+  <StreamingSample />
+</div>
+
 ## Anatomy
 
 ```tsx
@@ -71,7 +107,7 @@ import {
 } from "@assistant-ui/react-o11y";
 
 // Top-level: mount SpanResource via useAui
-const aui = useAui({ resource: SpanResource({ spans }) });
+const aui = useAui({ span: SpanResource({ spans }) });
 
 <AuiProvider value={aui}>
   {/* Render visible spans (flat-list output respecting collapsed state) */}
@@ -104,7 +140,7 @@ Resource that ingests raw span data and exposes a tree-aware reactive state to p
 SpanResource({ spans }: { spans: SpanData[] }): ClientOutput<"span">;
 ```
 
-Mount through `useAui({ resource: SpanResource({ spans }) })`.
+Mount through `useAui({ span: SpanResource({ spans }) })`.
 
 The resource computes:
 
@@ -243,6 +279,56 @@ Convenience component that pairs `SpanByIndexProvider` with a render component:
 
 Useful when you want explicit control over which child indices to render (e.g. for virtualization).
 
+### SpanPrimitive.Timeline
+
+A `<div>` that provides a timeline range to descendant `TimelineBar` primitives and exposes range CSS variables.
+
+| Prop | Type | Default | Description |
+| --- | --- | --- | --- |
+| `timeRange` | `{ min: number; max: number }` | `span.timeRange` | Override the range used for positioning bars. |
+| `paddingEnd` | `number` | `0` | Extends the max by this ratio of the range duration, useful for right-side breathing room. |
+
+Exposes `data-span-timeline` and CSS variables:
+
+| Variable | Description |
+| --- | --- |
+| `--span-timeline-min-ms` | Timeline start timestamp. |
+| `--span-timeline-max-ms` | Timeline end timestamp after padding. |
+| `--span-timeline-range-ms` | Timeline duration after padding. |
+
+### SpanPrimitive.TimelineBar
+
+A `<div>` that positions the current span within the nearest `SpanPrimitive.Timeline` range. It reads `startedAt`, `endedAt`, `status`, `type`, and `timeRange` from the current span scope.
+
+```tsx
+<SpanPrimitive.Timeline>
+  <SpanPrimitive.Children>
+    {() => (
+      <div className="relative h-8">
+        <SpanPrimitive.TimelineBar className="top-1 h-6 rounded bg-blue-500" />
+      </div>
+    )}
+  </SpanPrimitive.Children>
+</SpanPrimitive.Timeline>
+```
+
+Running spans use the timeline range max when `now` is omitted, keeping SSR and hydration deterministic. For live ticking, update a timestamp from an effect or animation loop and pass it as `now`.
+
+| Prop | Type | Default | Description |
+| --- | --- | --- | --- |
+| `now` | `number` | `undefined` | Explicit timestamp used as the end of running spans. |
+| `timeRange` | `{ min: number; max: number }` | nearest `Timeline` range | Override the range used for this bar. |
+
+Exposes `data-span-status`, `data-span-type`, `data-span-running`, and these CSS variables:
+
+| Variable | Description |
+| --- | --- |
+| `--span-timeline-left` | Bar start position as a percentage. |
+| `--span-timeline-end` | Bar end position as a percentage. |
+| `--span-timeline-width` | Bar width as a percentage. |
+| `--span-timeline-duration-ms` | Bar duration in milliseconds. |
+| `--span-timeline-min-width` | Optional consumer-set minimum width used by the default inline size. |
+
 ## Styling
 
 All primitives forward refs and accept standard DOM props (`className`, `style`, etc.). Use the data attributes for state-based styling:

package/README.md

@@ -1,6 +1,6 @@
 # `@assistant-ui/mcp-docs-server`
 
-Model Context Protocol (MCP) server that gives AI assistants direct access to assistant-ui's documentation and example projects. Exposes `assistantUIDocs` (retrieve documentation by path) and `assistantUIExamples` (access complete example projects).
+Model Context Protocol (MCP) server that gives AI assistants direct access to assistant-ui's documentation and example projects. Exposes `assistantUIDocs` (retrieve documentation by path), `assistantUIExamples` (access complete example projects), and `assistantUISearch` (keyword search across the bundled docs), and serves the same docs and examples as readable MCP **resources** (`aui-docs:///{path}`, `aui-example:///{name}`).
 
 > [!NOTE]
 > Detailed installation, troubleshooting, and advanced usage at [assistant-ui.com/docs/llm#mcp](https://www.assistant-ui.com/docs/llm#mcp).

package/dist/constants.d.ts

@@ -7,7 +7,8 @@ declare const CODE_EXAMPLES_PATH: string;
 declare const MDX_EXTENSION = ".mdx";
 declare const MD_EXTENSION = ".md";
 declare const MAX_FILE_SIZE: number;
+declare const MAX_DIRECTORY_CONTENT_SIZE: number;
 declare const IS_PREPARE_MODE: boolean | undefined;
 //#endregion
-export { CODE_EXAMPLES_PATH, DOCS_PATH, EXAMPLES_PATH, IS_PREPARE_MODE, MAX_FILE_SIZE, MDX_EXTENSION, MD_EXTENSION, PACKAGE_DIR, ROOT_DIR };
+export { CODE_EXAMPLES_PATH, DOCS_PATH, EXAMPLES_PATH, IS_PREPARE_MODE, MAX_DIRECTORY_CONTENT_SIZE, MAX_FILE_SIZE, MDX_EXTENSION, MD_EXTENSION, PACKAGE_DIR, ROOT_DIR };
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","names":[],"sources":["../src/constants.ts"],"mappings":";cAKa,QAAA;AAAA,cACA,WAAA;AAAA,cAEA,aAAA;AAAA,cAGA,SAAA;AAAA,cACA,kBAAA;AAAA,cAEA,aAAA;AAAA,cACA,YAAA;AAAA,cAEA,aAAA;AAAA,cAEA,eAAA"}
+{"version":3,"file":"constants.d.ts","names":[],"sources":["../src/constants.ts"],"mappings":";cAKa,QAAA;AAAA,cACA,WAAA;AAAA,cAEA,aAAA;AAAA,cAGA,SAAA;AAAA,cACA,kBAAA;AAAA,cAEA,aAAA;AAAA,cACA,YAAA;AAAA,cAEA,aAAA;AAAA,cAEA,0BAAA;AAAA,cAEA,eAAA"}

package/dist/constants.js

@@ -11,8 +11,9 @@ const CODE_EXAMPLES_PATH = join(DOCS_BASE, "organized/code-examples");
 const MDX_EXTENSION = ".mdx";
 const MD_EXTENSION = ".md";
 const MAX_FILE_SIZE = 10 * 1024 * 1024;
+const MAX_DIRECTORY_CONTENT_SIZE = 1024 * 1024;
 const IS_PREPARE_MODE = process.argv[1]?.includes("prepare-docs/prepare");
 //#endregion
-export { CODE_EXAMPLES_PATH, DOCS_PATH, EXAMPLES_PATH, IS_PREPARE_MODE, MAX_FILE_SIZE, MDX_EXTENSION, MD_EXTENSION, PACKAGE_DIR, ROOT_DIR };
+export { CODE_EXAMPLES_PATH, DOCS_PATH, EXAMPLES_PATH, IS_PREPARE_MODE, MAX_DIRECTORY_CONTENT_SIZE, MAX_FILE_SIZE, MDX_EXTENSION, MD_EXTENSION, PACKAGE_DIR, ROOT_DIR };
 
 //# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","names":[],"sources":["../src/constants.ts"],"sourcesContent":["import { fileURLToPath } from \"node:url\";\nimport { dirname, join } from \"node:path\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\nexport const ROOT_DIR = join(__dirname, \"../../../\");\nexport const PACKAGE_DIR = join(__dirname, \"../\");\n\nexport const EXAMPLES_PATH = join(ROOT_DIR, \"examples\");\n\nconst DOCS_BASE = join(PACKAGE_DIR, \".docs\");\nexport const DOCS_PATH = join(DOCS_BASE, \"raw/docs\");\nexport const CODE_EXAMPLES_PATH = join(DOCS_BASE, \"organized/code-examples\");\n\nexport const MDX_EXTENSION = \".mdx\";\nexport const MD_EXTENSION = \".md\";\n\nexport const MAX_FILE_SIZE = 10 * 1024 * 1024;\n\nexport const IS_PREPARE_MODE = process.argv[1]?.includes(\n  \"prepare-docs/prepare\",\n);\n"],"mappings":";;;AAGA,MAAM,YAAY,QAAQ,cAAc,OAAO,KAAK,GAAG,CAAC;AAExD,MAAa,WAAW,KAAK,WAAW,WAAW;AACnD,MAAa,cAAc,KAAK,WAAW,KAAK;AAEhD,MAAa,gBAAgB,KAAK,UAAU,UAAU;AAEtD,MAAM,YAAY,KAAK,aAAa,OAAO;AAC3C,MAAa,YAAY,KAAK,WAAW,UAAU;AACnD,MAAa,qBAAqB,KAAK,WAAW,yBAAyB;AAE3E,MAAa,gBAAgB;AAC7B,MAAa,eAAe;AAE5B,MAAa,gBAAgB,KAAK,OAAO;AAEzC,MAAa,kBAAkB,QAAQ,KAAK,EAAE,EAAE,SAC9C,sBACF"}
+{"version":3,"file":"constants.js","names":[],"sources":["../src/constants.ts"],"sourcesContent":["import { fileURLToPath } from \"node:url\";\nimport { dirname, join } from \"node:path\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\nexport const ROOT_DIR = join(__dirname, \"../../../\");\nexport const PACKAGE_DIR = join(__dirname, \"../\");\n\nexport const EXAMPLES_PATH = join(ROOT_DIR, \"examples\");\n\nconst DOCS_BASE = join(PACKAGE_DIR, \".docs\");\nexport const DOCS_PATH = join(DOCS_BASE, \"raw/docs\");\nexport const CODE_EXAMPLES_PATH = join(DOCS_BASE, \"organized/code-examples\");\n\nexport const MDX_EXTENSION = \".mdx\";\nexport const MD_EXTENSION = \".md\";\n\nexport const MAX_FILE_SIZE = 10 * 1024 * 1024;\n\nexport const MAX_DIRECTORY_CONTENT_SIZE = 1024 * 1024;\n\nexport const IS_PREPARE_MODE = process.argv[1]?.includes(\n  \"prepare-docs/prepare\",\n);\n"],"mappings":";;;AAGA,MAAM,YAAY,QAAQ,cAAc,OAAO,KAAK,GAAG,CAAC;AAExD,MAAa,WAAW,KAAK,WAAW,WAAW;AACnD,MAAa,cAAc,KAAK,WAAW,KAAK;AAEhD,MAAa,gBAAgB,KAAK,UAAU,UAAU;AAEtD,MAAM,YAAY,KAAK,aAAa,OAAO;AAC3C,MAAa,YAAY,KAAK,WAAW,UAAU;AACnD,MAAa,qBAAqB,KAAK,WAAW,yBAAyB;AAE3E,MAAa,gBAAgB;AAC7B,MAAa,eAAe;AAE5B,MAAa,gBAAgB,KAAK,OAAO;AAEzC,MAAa,6BAA6B,OAAO;AAEjD,MAAa,kBAAkB,QAAQ,KAAK,EAAE,EAAE,SAC9C,sBACF"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;cAca,MAAA,EAAM,SAGjB;AAAA,iBAeoB,SAAA,IAAS,OAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;cAgBa,MAAA,EAAM,SAGjB;AAAA,iBAmCoB,SAAA,IAAS,OAAA"}

package/dist/index.js

@@ -2,6 +2,8 @@ import { PACKAGE_DIR } from "./constants.js";
 import { logger } from "./utils/logger.js";
 import { docsTools } from "./tools/docs.js";
 import { examplesTools } from "./tools/examples.js";
+import { searchTools } from "./tools/search.js";
+import { registerResources } from "./tools/resources.js";
 import { join } from "node:path";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -12,8 +14,34 @@ const server = new McpServer({
 	name: "assistant-ui-docs",
 	version: packageJson.version
 });
-server.tool(docsTools.name, docsTools.description, docsTools.parameters, docsTools.execute);
-server.tool(examplesTools.name, examplesTools.description, examplesTools.parameters, examplesTools.execute);
+server.registerTool(docsTools.name, {
+	title: "assistant-ui Documentation",
+	description: docsTools.description,
+	inputSchema: docsTools.parameters,
+	annotations: {
+		readOnlyHint: true,
+		openWorldHint: false
+	}
+}, docsTools.execute);
+server.registerTool(examplesTools.name, {
+	title: "assistant-ui Examples",
+	description: examplesTools.description,
+	inputSchema: examplesTools.parameters,
+	annotations: {
+		readOnlyHint: true,
+		openWorldHint: false
+	}
+}, examplesTools.execute);
+server.registerTool(searchTools.name, {
+	title: "Search assistant-ui Documentation",
+	description: searchTools.description,
+	inputSchema: searchTools.parameters,
+	annotations: {
+		readOnlyHint: true,
+		openWorldHint: false
+	}
+}, searchTools.execute);
+registerResources(server);
 async function runServer() {
 	try {
 		logger.info(`Starting assistant-ui MCP docs server v${packageJson.version}`);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { docsTools } from \"./tools/docs.js\";\nimport { examplesTools } from \"./tools/examples.js\";\nimport { logger } from \"./utils/logger.js\";\nimport { PACKAGE_DIR } from \"./constants.js\";\n\nimport { readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nconst packageJson = JSON.parse(\n  readFileSync(join(PACKAGE_DIR, \"package.json\"), \"utf-8\"),\n);\n\nexport const server = new McpServer({\n  name: \"assistant-ui-docs\",\n  version: packageJson.version,\n});\n\nserver.tool(\n  docsTools.name,\n  docsTools.description,\n  docsTools.parameters,\n  docsTools.execute,\n);\nserver.tool(\n  examplesTools.name,\n  examplesTools.description,\n  examplesTools.parameters,\n  examplesTools.execute,\n);\n\nexport async function runServer() {\n  try {\n    logger.info(\n      `Starting assistant-ui MCP docs server v${packageJson.version}`,\n    );\n    const transport = new StdioServerTransport();\n    await server.connect(transport);\n  } catch (error) {\n    logger.error(\"Failed to start MCP server\", error);\n    process.exit(1);\n  }\n}\n\nif (import.meta.url === `file://${process.argv[1]}`) {\n  void runServer().catch((error) => {\n    console.error(\"Failed to start server:\", error);\n    process.exit(1);\n  });\n}\n"],"mappings":";;;;;;;;;AAUA,MAAM,cAAc,KAAK,MACvB,aAAa,KAAK,aAAa,cAAc,GAAG,OAAO,CACzD;AAEA,MAAa,SAAS,IAAI,UAAU;CAClC,MAAM;CACN,SAAS,YAAY;AACvB,CAAC;AAED,OAAO,KACL,UAAU,MACV,UAAU,aACV,UAAU,YACV,UAAU,OACZ;AACA,OAAO,KACL,cAAc,MACd,cAAc,aACd,cAAc,YACd,cAAc,OAChB;AAEA,eAAsB,YAAY;CAChC,IAAI;EACF,OAAO,KACL,0CAA0C,YAAY,SACxD;EACA,MAAM,YAAY,IAAI,qBAAqB;EAC3C,MAAM,OAAO,QAAQ,SAAS;CAChC,SAAS,OAAO;EACd,OAAO,MAAM,8BAA8B,KAAK;EAChD,QAAQ,KAAK,CAAC;CAChB;AACF;AAEA,IAAI,OAAO,KAAK,QAAQ,UAAU,QAAQ,KAAK,MAC7C,UAAe,CAAC,CAAC,OAAO,UAAU;CAChC,QAAQ,MAAM,2BAA2B,KAAK;CAC9C,QAAQ,KAAK,CAAC;AAChB,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { docsTools } from \"./tools/docs.js\";\nimport { examplesTools } from \"./tools/examples.js\";\nimport { searchTools } from \"./tools/search.js\";\nimport { registerResources } from \"./tools/resources.js\";\nimport { logger } from \"./utils/logger.js\";\nimport { PACKAGE_DIR } from \"./constants.js\";\n\nimport { readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nconst packageJson = JSON.parse(\n  readFileSync(join(PACKAGE_DIR, \"package.json\"), \"utf-8\"),\n);\n\nexport const server = new McpServer({\n  name: \"assistant-ui-docs\",\n  version: packageJson.version,\n});\n\nserver.registerTool(\n  docsTools.name,\n  {\n    title: \"assistant-ui Documentation\",\n    description: docsTools.description,\n    inputSchema: docsTools.parameters,\n    annotations: { readOnlyHint: true, openWorldHint: false },\n  },\n  docsTools.execute,\n);\nserver.registerTool(\n  examplesTools.name,\n  {\n    title: \"assistant-ui Examples\",\n    description: examplesTools.description,\n    inputSchema: examplesTools.parameters,\n    annotations: { readOnlyHint: true, openWorldHint: false },\n  },\n  examplesTools.execute,\n);\nserver.registerTool(\n  searchTools.name,\n  {\n    title: \"Search assistant-ui Documentation\",\n    description: searchTools.description,\n    inputSchema: searchTools.parameters,\n    annotations: { readOnlyHint: true, openWorldHint: false },\n  },\n  searchTools.execute,\n);\n\nregisterResources(server);\n\nexport async function runServer() {\n  try {\n    logger.info(\n      `Starting assistant-ui MCP docs server v${packageJson.version}`,\n    );\n    const transport = new StdioServerTransport();\n    await server.connect(transport);\n  } catch (error) {\n    logger.error(\"Failed to start MCP server\", error);\n    process.exit(1);\n  }\n}\n\nif (import.meta.url === `file://${process.argv[1]}`) {\n  void runServer().catch((error) => {\n    console.error(\"Failed to start server:\", error);\n    process.exit(1);\n  });\n}\n"],"mappings":";;;;;;;;;;;AAYA,MAAM,cAAc,KAAK,MACvB,aAAa,KAAK,aAAa,cAAc,GAAG,OAAO,CACzD;AAEA,MAAa,SAAS,IAAI,UAAU;CAClC,MAAM;CACN,SAAS,YAAY;AACvB,CAAC;AAED,OAAO,aACL,UAAU,MACV;CACE,OAAO;CACP,aAAa,UAAU;CACvB,aAAa,UAAU;CACvB,aAAa;EAAE,cAAc;EAAM,eAAe;CAAM;AAC1D,GACA,UAAU,OACZ;AACA,OAAO,aACL,cAAc,MACd;CACE,OAAO;CACP,aAAa,cAAc;CAC3B,aAAa,cAAc;CAC3B,aAAa;EAAE,cAAc;EAAM,eAAe;CAAM;AAC1D,GACA,cAAc,OAChB;AACA,OAAO,aACL,YAAY,MACZ;CACE,OAAO;CACP,aAAa,YAAY;CACzB,aAAa,YAAY;CACzB,aAAa;EAAE,cAAc;EAAM,eAAe;CAAM;AAC1D,GACA,YAAY,OACd;AAEA,kBAAkB,MAAM;AAExB,eAAsB,YAAY;CAChC,IAAI;EACF,OAAO,KACL,0CAA0C,YAAY,SACxD;EACA,MAAM,YAAY,IAAI,qBAAqB;EAC3C,MAAM,OAAO,QAAQ,SAAS;CAChC,SAAS,OAAO;EACd,OAAO,MAAM,8BAA8B,KAAK;EAChD,QAAQ,KAAK,CAAC;CAChB;AACF;AAEA,IAAI,OAAO,KAAK,QAAQ,UAAU,QAAQ,KAAK,MAC7C,UAAe,CAAC,CAAC,OAAO,UAAU;CAChC,QAAQ,MAAM,2BAA2B,KAAK;CAC9C,QAAQ,KAAK,CAAC;AAChB,CAAC"}

package/dist/prepare-docs/copy-raw.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"copy-raw.d.ts","names":[],"sources":["../../src/prepare-docs/copy-raw.ts"],"mappings":";iBAkCsB,OAAA,IAAW,OAAO"}
+{"version":3,"file":"copy-raw.d.ts","names":[],"sources":["../../src/prepare-docs/copy-raw.ts"],"mappings":";iBAiCsB,OAAA,IAAW,OAAO"}

package/dist/prepare-docs/copy-raw.js

@@ -4,7 +4,6 @@ import { extname, join } from "node:path";
 import { copyFile, mkdir, readdir, rm } from "node:fs/promises";
 //#region src/prepare-docs/copy-raw.ts
 const DOCS_SOURCE = join(ROOT_DIR, "apps/docs/content/docs");
-const BLOG_SOURCE = join(ROOT_DIR, "apps/docs/content/blog");
 const DOCS_DEST = join(ROOT_DIR, "packages/mcp-docs-server/.docs/raw");
 async function copyDir(src, dest) {
 	try {
@@ -38,9 +37,6 @@ async function copyRaw() {
 		const docsPath = join(DOCS_DEST, "docs");
 		await copyDir(DOCS_SOURCE, docsPath);
 		logger.info(`Copied documentation to ${docsPath}`);
-		const blogPath = join(DOCS_DEST, "blog");
-		await copyDir(BLOG_SOURCE, blogPath);
-		logger.info(`Copied blog posts to ${blogPath}`);
 		logger.info("Raw documentation copy complete");
 	} catch (error) {
 		logger.error("Failed to copy raw documentation", error);