@elizaos/ui 2.0.0-beta.2 → 2.0.3-beta.3

package/cloud/mcps/McpsSection.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Settings-section wrapper for the MCPs surface (Cloud/Developer group mount).
+ *
+ * The settings-section registry renders a no-prop `Component`, so this is the
+ * zero-prop adapter handed to `registerSettingsSection({ id: "mcps", Component:
+ * McpsSection, ... })`. It reuses the exact same {@link McpsSurface} as the
+ * standalone route, so the section and any direct mount stay identical.
+ */
+import { McpsSurface } from "./McpsRoute.js";
+export function McpsSection() {
+    return _jsx(McpsSurface, {});
+}

package/cloud/mcps/McpsView.d.ts

@@ -0,0 +1,13 @@
+/**
+ * MCP registry management view (app-hosted Eliza Cloud surface).
+ *
+ * Replaces the cloud-frontend `demoMcpServers` larp with the REAL registry:
+ *   - "My MCPs" tab  → `GET /api/v1/mcps?scope=own`  (CRUD + publish)
+ *   - "Registry" tab → `GET /api/v1/mcps?scope=public` (live community MCPs)
+ *   - "Built-in" tab → `GET /api/mcp/list`            (platform MCPs)
+ *
+ * Cards open a detail drawer; owner cards get edit/publish/delete + a real
+ * connection test. The header CTA registers a new external MCP.
+ */
+export declare function McpsView(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=McpsView.d.ts.map

package/cloud/mcps/McpsView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpsView.d.ts","sourceRoot":"","sources":["../../../../../../src/cloud/mcps/McpsView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAqBH,wBAAgB,QAAQ,4CA8NvB"}

package/cloud/mcps/McpsView.js

@@ -0,0 +1,149 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * MCP registry management view (app-hosted Eliza Cloud surface).
+ *
+ * Replaces the cloud-frontend `demoMcpServers` larp with the REAL registry:
+ *   - "My MCPs" tab  → `GET /api/v1/mcps?scope=own`  (CRUD + publish)
+ *   - "Registry" tab → `GET /api/v1/mcps?scope=public` (live community MCPs)
+ *   - "Built-in" tab → `GET /api/mcp/list`            (platform MCPs)
+ *
+ * Cards open a detail drawer; owner cards get edit/publish/delete + a real
+ * connection test. The header CTA registers a new external MCP.
+ */
+import { Plus, Puzzle, Search, Zap } from "lucide-react";
+import { memo, useCallback, useMemo, useState } from "react";
+import { BrandButton } from "../../cloud-ui/components/brand/brand-button.js";
+import { DashboardPageContainer } from "../../cloud-ui/components/layout/dashboard-page.js";
+import { useSetPageHeader } from "../../cloud-ui/components/layout/page-header-context.hooks.js";
+import { Input } from "../../components/ui/input.js";
+import { cn } from "../../lib/utils.js";
+import { useCloudT } from "../shell/CloudI18nProvider.js";
+import { testBuiltinMcpConnection, } from "./lib/test-connection.js";
+import { useBuiltinMcps, usePublicMcps, useUserMcps } from "./lib/use-mcps.js";
+import { McpDetailDrawer, StatusBadge } from "./McpDetailDrawer.js";
+import { McpEditorDialog } from "./McpEditorDialog.js";
+export function McpsView() {
+    const t = useCloudT();
+    const [tab, setTab] = useState("own");
+    const [search, setSearch] = useState("");
+    const [category, setCategory] = useState("all");
+    const [editorOpen, setEditorOpen] = useState(false);
+    const [editing, setEditing] = useState(null);
+    const [detailId, setDetailId] = useState(null);
+    const ownQuery = useUserMcps({ scope: "own" });
+    const publicQuery = usePublicMcps();
+    const builtinQuery = useBuiltinMcps();
+    useSetPageHeader({
+        title: t("cloud.mcps.pageTitle", { defaultValue: "MCP Servers" }),
+        description: t("cloud.mcps.pageDescription", {
+            defaultValue: "Register, publish and connect Model Context Protocol servers for your agents.",
+        }),
+        actions: (_jsxs(BrandButton, { variant: "primary", size: "sm", onClick: () => {
+                setEditing(null);
+                setEditorOpen(true);
+            }, children: [_jsx(Plus, { className: "h-4 w-4" }), t("cloud.mcps.registerCta", { defaultValue: "Register MCP" })] })),
+    }, [t]);
+    const records = tab === "own"
+        ? (ownQuery.data?.mcps ?? [])
+        : tab === "registry"
+            ? (publicQuery.data?.mcps ?? [])
+            : [];
+    const builtins = tab === "builtin" ? (builtinQuery.data?.mcps ?? []) : [];
+    const categories = useMemo(() => {
+        const set = new Set();
+        for (const r of records)
+            set.add(r.category);
+        for (const b of builtins)
+            set.add(b.category);
+        return ["all", ...[...set].sort()];
+    }, [records, builtins]);
+    const filteredRecords = useMemo(() => {
+        const needle = search.trim().toLowerCase();
+        const matches = (text) => needle === "" || text.toLowerCase().includes(needle);
+        return records.filter((r) => (category === "all" || r.category === category) &&
+            (matches(r.name) || matches(r.description)));
+    }, [records, category, search]);
+    const filteredBuiltins = useMemo(() => {
+        const needle = search.trim().toLowerCase();
+        const matches = (text) => needle === "" || text.toLowerCase().includes(needle);
+        return builtins.filter((b) => (category === "all" || b.category === category) &&
+            (matches(b.name) || matches(b.description)));
+    }, [builtins, category, search]);
+    const handleSelect = useCallback((id) => setDetailId(id), []);
+    const isLoading = (tab === "own" && ownQuery.isLoading) ||
+        (tab === "registry" && publicQuery.isLoading) ||
+        (tab === "builtin" && builtinQuery.isLoading);
+    const tabs = [
+        {
+            id: "own",
+            label: t("cloud.mcps.tabOwn", { defaultValue: "My MCPs" }),
+        },
+        {
+            id: "registry",
+            label: t("cloud.mcps.tabRegistry", { defaultValue: "Registry" }),
+        },
+        {
+            id: "builtin",
+            label: t("cloud.mcps.tabBuiltin", { defaultValue: "Built-in" }),
+        },
+    ];
+    return (_jsxs(DashboardPageContainer, { className: "flex flex-col gap-5", children: [_jsx("div", { className: "flex gap-1 border-b border-white/10", children: tabs.map((tabDef) => (_jsx("button", { type: "button", onClick: () => setTab(tabDef.id), className: cn("px-4 py-2 text-sm font-medium border-b-2 -mb-px transition-colors", tab === tabDef.id
+                        ? "border-accent text-white"
+                        : "border-transparent text-white/50 hover:text-white/80"), children: tabDef.label }, tabDef.id))) }), _jsxs("div", { className: "flex flex-col gap-3 sm:flex-row sm:items-center", children: [_jsxs("div", { className: "relative flex-1 max-w-md", children: [_jsx(Search, { className: "absolute left-3 top-1/2 -translate-y-1/2 h-4 w-4 text-white/40" }), _jsx(Input, { value: search, onChange: (e) => setSearch(e.target.value), placeholder: t("cloud.mcps.searchPlaceholder", {
+                                    defaultValue: "Search MCPs...",
+                                }), className: "pl-9" })] }), _jsx("div", { className: "flex flex-wrap gap-1.5", children: categories.map((cat) => (_jsx("button", { type: "button", onClick: () => setCategory(cat), className: cn("h-8 px-3 text-xs rounded-full border transition-colors capitalize", category === cat
+                                ? "border-accent/50 bg-accent/15 text-white"
+                                : "border-white/10 bg-white/5 text-white/60 hover:bg-white/10 hover:text-white"), children: cat }, cat))) })] }), isLoading ? (_jsx(GridSkeleton, {})) : tab === "builtin" ? (filteredBuiltins.length === 0 ? (_jsx(EmptyState, { message: t("cloud.mcps.noBuiltin", {
+                    defaultValue: "No built-in MCPs match your search.",
+                }) })) : (_jsx("div", { className: "grid gap-4 sm:grid-cols-2", children: filteredBuiltins.map((b) => (_jsx(BuiltinCard, { mcp: b }, b.id))) }))) : filteredRecords.length === 0 ? (_jsx(EmptyState, { message: tab === "own"
+                    ? t("cloud.mcps.noOwn", {
+                        defaultValue: "You haven't registered any MCP servers yet.",
+                    })
+                    : t("cloud.mcps.noRegistry", {
+                        defaultValue: "No public MCP servers match your search.",
+                    }), action: tab === "own" ? (_jsxs(BrandButton, { variant: "primary", size: "sm", onClick: () => {
+                        setEditing(null);
+                        setEditorOpen(true);
+                    }, children: [_jsx(Plus, { className: "h-4 w-4" }), t("cloud.mcps.registerCta", { defaultValue: "Register MCP" })] })) : undefined })) : (_jsx("div", { className: "grid gap-4 sm:grid-cols-2", children: filteredRecords.map((mcp) => (_jsx(UserMcpCard, { mcp: mcp, onSelect: handleSelect }, mcp.id))) })), _jsx(McpEditorDialog, { open: editorOpen, onOpenChange: (open) => {
+                    setEditorOpen(open);
+                    if (!open)
+                        setEditing(null);
+                }, editing: editing }), _jsx(McpDetailDrawer, { mcpId: detailId, onClose: () => setDetailId(null), onEdit: (mcp) => {
+                    setDetailId(null);
+                    setEditing(mcp);
+                    setEditorOpen(true);
+                } })] }));
+}
+const UserMcpCard = memo(function UserMcpCard({ mcp, onSelect, }) {
+    const t = useCloudT();
+    return (_jsxs("button", { type: "button", onClick: () => onSelect(mcp.id), className: "text-left rounded-sm border border-white/10 bg-white/5 p-4 transition-colors hover:border-white/20 hover:bg-white/[0.07]", children: [_jsxs("div", { className: "flex items-start justify-between gap-2", children: [_jsxs("div", { className: "flex items-center gap-3 min-w-0", children: [_jsx("div", { className: "p-2 rounded-sm border border-white/10 bg-white/5 shrink-0", children: _jsx(Puzzle, { className: "h-4 w-4 text-accent" }) }), _jsxs("div", { className: "min-w-0", children: [_jsxs("h3", { className: "font-semibold text-white truncate flex items-center gap-2", children: [mcp.name, mcp.x402_enabled && (_jsx(Zap, { className: "h-3 w-3 text-accent shrink-0" }))] }), _jsxs("p", { className: "text-xs text-white/50", children: ["v", mcp.version, " \u00B7", " ", t("cloud.mcps.toolsCount", {
+                                                defaultValue: "{{n}} tools",
+                                                n: mcp.tools.length,
+                                            })] })] })] }), _jsx(StatusBadge, { status: mcp.status })] }), _jsx("p", { className: "mt-3 text-xs text-white/60 line-clamp-2 min-h-[2.5rem]", children: mcp.description }), _jsxs("div", { className: "mt-3 flex items-center justify-between text-xs text-white/40", children: [_jsx("span", { className: "capitalize", children: mcp.category }), _jsx("span", { className: "text-white/30 group-hover:text-white", children: t("cloud.mcps.viewDetails", { defaultValue: "View details" }) })] })] }));
+});
+const BuiltinCard = memo(function BuiltinCard({ mcp, }) {
+    const t = useCloudT();
+    const [testing, setTesting] = useState(false);
+    const [result, setResult] = useState(null);
+    const runTest = async () => {
+        setTesting(true);
+        setResult(null);
+        const r = await testBuiltinMcpConnection(mcp.endpoint, mcp.name);
+        setResult(r);
+        setTesting(false);
+    };
+    return (_jsxs("div", { className: "rounded-sm border border-white/10 bg-white/5 p-4", children: [_jsxs("div", { className: "flex items-start justify-between gap-2", children: [_jsxs("div", { className: "flex items-center gap-3 min-w-0", children: [_jsx("div", { className: "p-2 rounded-sm border border-white/10 bg-white/5 shrink-0", children: _jsx(Puzzle, { className: "h-4 w-4 text-accent" }) }), _jsxs("div", { className: "min-w-0", children: [_jsx("h3", { className: "font-semibold text-white truncate", children: mcp.name }), _jsxs("p", { className: "text-xs text-white/50", children: ["v", mcp.version, " \u00B7", " ", t("cloud.mcps.toolsCount", {
+                                                defaultValue: "{{n}} tools",
+                                                n: mcp.tools.length,
+                                            })] })] })] }), _jsx("span", { className: "text-[10px] px-1.5 py-0 rounded-full border border-emerald-500/30 bg-emerald-500/15 text-emerald-300 capitalize", children: mcp.status })] }), _jsx("p", { className: "mt-3 text-xs text-white/60 line-clamp-2 min-h-[2.5rem]", children: mcp.description }), _jsxs("div", { className: "mt-3 flex items-center justify-between", children: [_jsx("code", { className: "text-xs text-white/40 truncate", children: mcp.endpoint }), _jsx(BrandButton, { variant: "outline", size: "sm", onClick: () => void runTest(), disabled: testing, children: testing
+                            ? t("cloud.mcps.testing", { defaultValue: "Testing..." })
+                            : t("cloud.mcps.test", { defaultValue: "Test" }) })] }), result && (_jsx("pre", { className: cn("mt-3 rounded-sm border p-2 font-mono text-[11px] max-h-32 overflow-auto", result.ok
+                    ? "border-white/10 bg-white/5 text-white/60"
+                    : "border-red-500/30 bg-red-500/10 text-red-200"), children: result.summary }))] }));
+});
+function GridSkeleton() {
+    return (_jsx("div", { className: "grid gap-4 sm:grid-cols-2", "aria-busy": "true", children: [0, 1, 2, 3].map((i) => (_jsx("div", { className: "h-32 rounded-sm border border-white/10 bg-white/5 animate-pulse" }, i))) }));
+}
+function EmptyState({ message, action, }) {
+    return (_jsxs("div", { className: "flex flex-col items-center justify-center gap-4 rounded-sm border border-white/10 bg-white/[0.03] py-16 text-center", children: [_jsx(Puzzle, { className: "h-10 w-10 text-white/30" }), _jsx("p", { className: "text-sm text-white/50", children: message }), action] }));
+}

package/cloud/mcps/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * MCPs cloud domain — barrel + route/section registration.
+ *
+ * The REAL MCP registry management surface (DECISIONS §D4 "build and test a
+ * REAL registry"). It replaces the cloud-frontend `demoMcpServers` larp with
+ * live data from the registry backend:
+ *
+ *   - `GET/POST     /api/v1/mcps`              list (own/public/all) + create
+ *   - `GET/PUT/DELETE /api/v1/mcps/:mcpId`     detail / update / delete
+ *   - `POST/DELETE  /api/v1/mcps/:mcpId/publish` publish / unpublish
+ *   - `GET /api/mcp/list`                       built-in platform catalog
+ *   - `GET /api/mcp/proxy/:mcpId`              real connection test (live MCP)
+ *
+ * Mount points (mirroring `api-keys` / `documents`):
+ *  - {@link McpsSection} is the zero-prop component for
+ *    `registerSettingsSection({ id: "mcps", Component: McpsSection })`. Exposed
+ *    via {@link registerMcpsSettingsSection} (opt-in; the settings IA decision
+ *    belongs to the host, and the pinned `settings-section-meta` is owned
+ *    elsewhere — so MCPs registers under the existing `system` group).
+ *  - {@link mcpsCloudRoute} is registered **at import time** at `dashboard/mcps`
+ *    (no `CloudRouterShell` redirect collides with it), so the standalone deep
+ *    link is live. {@link registerMcpsCloudRoute} re-registers at a custom path.
+ */
+import { type CloudRouteDef } from "../shell/cloud-route-registry.js";
+export type { BuiltinMcpDefinition, CreateUserMcpInput, McpCategory, McpPricingType, McpStats, McpStatus, McpTool, UpdateUserMcpInput, UserMcpDetailResponse, UserMcpRecord, } from "./lib/api-types.js";
+export { useCreateMcp, useDeleteMcp, usePublishMcp, useUnpublishMcp, useUpdateMcp, } from "./lib/mcp-mutations.js";
+export { builtinMetadataUrl, type McpConnectionTestResult, testBuiltinMcpConnection, testUserMcpConnection, } from "./lib/test-connection.js";
+export { MCPS_QUERY_KEY, useBuiltinMcps, usePublicMcps, useUserMcpDetail, useUserMcps, } from "./lib/use-mcps.js";
+export { McpDetailDrawer } from "./McpDetailDrawer.js";
+export { McpEditorDialog } from "./McpEditorDialog.js";
+export { default as McpsRoute, McpsSurface } from "./McpsRoute.js";
+export { McpsSection } from "./McpsSection.js";
+export { McpsView } from "./McpsView.js";
+/** Stable settings-section id + URL hash for the MCPs surface. */
+export declare const MCPS_SECTION_ID = "mcps";
+/** Stable URL path slug for the standalone MCPs route. */
+export declare const MCPS_ROUTE_PATH = "dashboard/mcps";
+/** Cloud-route definition for the standalone MCPs surface. */
+export declare const mcpsCloudRoute: CloudRouteDef;
+/**
+ * Register (or re-register) the standalone MCPs route. The default registration
+ * below runs at import time since `dashboard/mcps` has no shell redirect to
+ * collide with.
+ */
+export declare function registerMcpsCloudRoute(override?: Partial<CloudRouteDef>): void;
+/**
+ * Register the MCPs surface as a Settings section. Idempotent (the registry
+ * replaces by id). Not invoked at import time — the host's cloud boot path calls
+ * this so the settings IA stays the host's decision. Uses the existing `system`
+ * group (the pinned settings-section-meta has no separate "cloud" group).
+ */
+export declare function registerMcpsSettingsSection(): void;
+//# sourceMappingURL=index.d.ts.map

package/cloud/mcps/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/cloud/mcps/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,+BAA+B,CAAC;AAGvC,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,QAAQ,EACR,SAAS,EACT,OAAO,EACP,kBAAkB,EAClB,qBAAqB,EACrB,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,eAAe,EACf,YAAY,GACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,kBAAkB,EAClB,KAAK,uBAAuB,EAC5B,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,cAAc,EACd,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,WAAW,GACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,kEAAkE;AAClE,eAAO,MAAM,eAAe,SAAS,CAAC;AACtC,0DAA0D;AAC1D,eAAO,MAAM,eAAe,mBAAmB,CAAC;AAKhD,8DAA8D;AAC9D,eAAO,MAAM,cAAc,EAAE,aAI5B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAChC,IAAI,CAEN;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAalD"}

package/cloud/mcps/index.js

@@ -0,0 +1,77 @@
+/**
+ * MCPs cloud domain — barrel + route/section registration.
+ *
+ * The REAL MCP registry management surface (DECISIONS §D4 "build and test a
+ * REAL registry"). It replaces the cloud-frontend `demoMcpServers` larp with
+ * live data from the registry backend:
+ *
+ *   - `GET/POST     /api/v1/mcps`              list (own/public/all) + create
+ *   - `GET/PUT/DELETE /api/v1/mcps/:mcpId`     detail / update / delete
+ *   - `POST/DELETE  /api/v1/mcps/:mcpId/publish` publish / unpublish
+ *   - `GET /api/mcp/list`                       built-in platform catalog
+ *   - `GET /api/mcp/proxy/:mcpId`              real connection test (live MCP)
+ *
+ * Mount points (mirroring `api-keys` / `documents`):
+ *  - {@link McpsSection} is the zero-prop component for
+ *    `registerSettingsSection({ id: "mcps", Component: McpsSection })`. Exposed
+ *    via {@link registerMcpsSettingsSection} (opt-in; the settings IA decision
+ *    belongs to the host, and the pinned `settings-section-meta` is owned
+ *    elsewhere — so MCPs registers under the existing `system` group).
+ *  - {@link mcpsCloudRoute} is registered **at import time** at `dashboard/mcps`
+ *    (no `CloudRouterShell` redirect collides with it), so the standalone deep
+ *    link is live. {@link registerMcpsCloudRoute} re-registers at a custom path.
+ */
+import { Boxes } from "lucide-react";
+import { lazy } from "react";
+import { registerSettingsSection } from "../../components/settings/settings-section-registry.js";
+import { registerCloudRoute, } from "../shell/cloud-route-registry.js";
+import { McpsSection } from "./McpsSection.js";
+export { useCreateMcp, useDeleteMcp, usePublishMcp, useUnpublishMcp, useUpdateMcp, } from "./lib/mcp-mutations.js";
+export { builtinMetadataUrl, testBuiltinMcpConnection, testUserMcpConnection, } from "./lib/test-connection.js";
+export { MCPS_QUERY_KEY, useBuiltinMcps, usePublicMcps, useUserMcpDetail, useUserMcps, } from "./lib/use-mcps.js";
+export { McpDetailDrawer } from "./McpDetailDrawer.js";
+export { McpEditorDialog } from "./McpEditorDialog.js";
+export { default as McpsRoute, McpsSurface } from "./McpsRoute.js";
+export { McpsSection } from "./McpsSection.js";
+export { McpsView } from "./McpsView.js";
+/** Stable settings-section id + URL hash for the MCPs surface. */
+export const MCPS_SECTION_ID = "mcps";
+/** Stable URL path slug for the standalone MCPs route. */
+export const MCPS_ROUTE_PATH = "dashboard/mcps";
+/** Lazy route element for the standalone MCPs surface (code-split). */
+const McpsRouteLazy = lazy(() => import("./McpsRoute.js"));
+/** Cloud-route definition for the standalone MCPs surface. */
+export const mcpsCloudRoute = {
+    path: MCPS_ROUTE_PATH,
+    element: McpsRouteLazy,
+    group: "dashboard",
+};
+/**
+ * Register (or re-register) the standalone MCPs route. The default registration
+ * below runs at import time since `dashboard/mcps` has no shell redirect to
+ * collide with.
+ */
+export function registerMcpsCloudRoute(override) {
+    registerCloudRoute({ ...mcpsCloudRoute, ...override });
+}
+/**
+ * Register the MCPs surface as a Settings section. Idempotent (the registry
+ * replaces by id). Not invoked at import time — the host's cloud boot path calls
+ * this so the settings IA stays the host's decision. Uses the existing `system`
+ * group (the pinned settings-section-meta has no separate "cloud" group).
+ */
+export function registerMcpsSettingsSection() {
+    registerSettingsSection({
+        id: MCPS_SECTION_ID,
+        label: "settings.sections.mcps.label",
+        defaultLabel: "MCP Servers",
+        icon: Boxes,
+        tone: "accent",
+        hue: "accent",
+        group: "system",
+        titleKey: "settings.sections.mcps.title",
+        defaultTitle: "MCP Servers",
+        Component: McpsSection,
+    });
+}
+registerMcpsCloudRoute();

package/cloud/mcps/lib/api-types.d.ts

@@ -0,0 +1,213 @@
+/**
+ * MCP registry DTO types (app-hosted Eliza Cloud surface).
+ *
+ * Mirrors the real cloud-api MCP registry contract:
+ *   - `GET/POST  /api/v1/mcps`             (user-created MCP CRUD + list)
+ *   - `GET/PUT/DELETE /api/v1/mcps/:mcpId` (detail / update / delete)
+ *   - `POST/DELETE   /api/v1/mcps/:mcpId/publish` (publish / unpublish)
+ *   - `GET /api/mcp/list`                  (built-in platform MCP catalog)
+ *   - `GET /api/mcp/proxy/:mcpId`          (live user-MCP info / connection probe)
+ *
+ * The backend persists snake_case columns (`UserMcp` Drizzle row); these types
+ * intentionally re-state that snake_case shape rather than inventing a camelCase
+ * transport DTO, because the registry routes return the row verbatim
+ * (`c.json({ mcp })`). Keeping the field names identical to the DB row is the
+ * single source of truth — the UI reads exactly what the API returns.
+ */
+/** Pricing model for a monetizable user MCP. */
+export type McpPricingType = "free" | "credits" | "x402";
+/** Lifecycle status of a user MCP. `live` == published + discoverable. */
+export type McpStatus = "draft" | "pending_review" | "live" | "suspended" | "deprecated";
+/** Where the MCP server actually runs. */
+export type McpEndpointType = "container" | "external";
+/** MCP wire transport. */
+export type McpTransportType = "streamable-http" | "stdio";
+/** Curated category for discovery/filtering (matches the create-route enum). */
+export type McpCategory = "utilities" | "finance" | "data" | "communication" | "productivity" | "ai" | "search" | "platform" | "other";
+/** A single tool exposed by a user MCP. */
+export interface McpTool {
+    name: string;
+    description: string;
+    inputSchema?: Record<string, unknown>;
+    /** Display-only cost label, e.g. `"1 credit"` / `"$0.001"`. */
+    cost?: string;
+}
+/**
+ * A user-created MCP as returned by the v1 registry routes — the persisted
+ * `UserMcp` row (snake_case), serialized over JSON (timestamps become ISO
+ * strings / null).
+ */
+export interface UserMcpRecord {
+    id: string;
+    name: string;
+    slug: string;
+    description: string;
+    version: string;
+    organization_id: string;
+    created_by_user_id: string;
+    endpoint_type: McpEndpointType;
+    container_id: string | null;
+    external_endpoint: string | null;
+    endpoint_path: string | null;
+    transport_type: McpTransportType;
+    mcp_version: string | null;
+    tools: McpTool[];
+    category: string;
+    tags: string[];
+    icon: string | null;
+    color: string | null;
+    pricing_type: McpPricingType;
+    credits_per_request: string | null;
+    x402_price_usd: string | null;
+    x402_enabled: boolean;
+    creator_share_percentage: string;
+    platform_share_percentage: string;
+    total_requests: number;
+    total_credits_earned: string | null;
+    total_x402_earned_usd: string | null;
+    unique_users: number;
+    status: McpStatus;
+    is_public: boolean;
+    is_featured: boolean;
+    is_verified: boolean;
+    documentation_url: string | null;
+    source_code_url: string | null;
+    support_email: string | null;
+    created_at: string;
+    updated_at: string;
+    last_used_at: string | null;
+    published_at: string | null;
+    /** Present on the detail (`GET /:mcpId`) response — resolved public URL. */
+    endpointUrl?: string;
+}
+/** Owner-only usage stats returned by `GET /api/v1/mcps/:mcpId`. */
+export interface McpStats {
+    totalRequests: number;
+    totalCreditsEarned: number;
+    totalX402EarnedUsd: number;
+    uniqueUsers: number;
+}
+/** Response shape of `GET /api/v1/mcps`. */
+export interface ListUserMcpsResponse {
+    mcps: UserMcpRecord[];
+    total: number;
+    scope: "own" | "public" | "all";
+    filters: {
+        category?: string;
+        search?: string;
+        status?: McpStatus;
+    };
+    pagination: {
+        limit: number;
+        offset: number;
+    };
+}
+/** Response shape of `GET /api/v1/mcps/:mcpId`. */
+export interface UserMcpDetailResponse {
+    mcp: UserMcpRecord;
+    stats: McpStats | null;
+    isOwner: boolean;
+}
+/** Response shape of `POST /api/v1/mcps`. */
+export interface CreateUserMcpResponse {
+    mcp: UserMcpRecord;
+}
+/** Response shape of `PUT /api/v1/mcps/:mcpId` and the publish/unpublish routes. */
+export interface MutateUserMcpResponse {
+    mcp: UserMcpRecord;
+    message?: string;
+}
+/** Request body for `POST /api/v1/mcps` (matches the route's create schema). */
+export interface CreateUserMcpInput {
+    name: string;
+    slug: string;
+    description: string;
+    category?: McpCategory;
+    endpointType?: McpEndpointType;
+    containerId?: string;
+    externalEndpoint?: string;
+    endpointPath?: string;
+    transportType?: McpTransportType;
+    tools?: McpTool[];
+    pricingType?: McpPricingType;
+    creditsPerRequest?: number;
+    x402PriceUsd?: number;
+    x402Enabled?: boolean;
+    creatorSharePercentage?: number;
+    documentationUrl?: string;
+    sourceCodeUrl?: string;
+    supportEmail?: string;
+    tags?: string[];
+    icon?: string;
+    color?: string;
+}
+/** Request body for `PUT /api/v1/mcps/:mcpId` (matches the route's update schema). */
+export interface UpdateUserMcpInput {
+    name?: string;
+    description?: string;
+    version?: string;
+    category?: McpCategory;
+    endpointPath?: string;
+    transportType?: McpTransportType;
+    tools?: McpTool[];
+    pricingType?: McpPricingType;
+    creditsPerRequest?: number;
+    x402PriceUsd?: number;
+    x402Enabled?: boolean;
+    creatorSharePercentage?: number;
+    documentationUrl?: string | null;
+    sourceCodeUrl?: string | null;
+    supportEmail?: string | null;
+    tags?: string[];
+    icon?: string;
+    color?: string;
+    isPublic?: boolean;
+}
+/**
+ * A built-in platform MCP definition from `GET /api/mcp/list`. These are the
+ * first-party MCP servers (eliza-cloud-mcp, time, weather, crypto, …) — not
+ * user-owned, so they have no CRUD; they are browse + connection-test only.
+ */
+export interface BuiltinMcpDefinition {
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    endpoint: string;
+    category: string;
+    status: string;
+    x402Enabled: boolean;
+    pricing: {
+        type: McpPricingType;
+        description: string;
+        creditsPerRequest?: number | string;
+    };
+    tools: Array<{
+        name: string;
+        description: string;
+        cost?: string;
+        parameters?: Record<string, unknown>;
+    }>;
+}
+/** Response shape of `GET /api/mcp/list`. */
+export interface BuiltinMcpListResponse {
+    mcps: BuiltinMcpDefinition[];
+    total: number;
+    categories: string[];
+}
+/** Live-MCP info from `GET /api/mcp/proxy/:mcpId` (connection probe target). */
+export interface McpProxyInfoResponse {
+    id: string;
+    name: string;
+    description: string;
+    tools: McpTool[];
+    pricing: {
+        type: McpPricingType;
+        creditsPerRequest: string | null;
+        x402PriceUsd: string | null;
+        x402Enabled: boolean;
+    };
+    endpoint: string;
+    transport: McpTransportType;
+}
+//# sourceMappingURL=api-types.d.ts.map

package/cloud/mcps/lib/api-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-types.d.ts","sourceRoot":"","sources":["../../../../../../../src/cloud/mcps/lib/api-types.ts"],"names":[],"mappings":"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"}

package/cloud/mcps/lib/api-types.js

@@ -0,0 +1,17 @@
+/**
+ * MCP registry DTO types (app-hosted Eliza Cloud surface).
+ *
+ * Mirrors the real cloud-api MCP registry contract:
+ *   - `GET/POST  /api/v1/mcps`             (user-created MCP CRUD + list)
+ *   - `GET/PUT/DELETE /api/v1/mcps/:mcpId` (detail / update / delete)
+ *   - `POST/DELETE   /api/v1/mcps/:mcpId/publish` (publish / unpublish)
+ *   - `GET /api/mcp/list`                  (built-in platform MCP catalog)
+ *   - `GET /api/mcp/proxy/:mcpId`          (live user-MCP info / connection probe)
+ *
+ * The backend persists snake_case columns (`UserMcp` Drizzle row); these types
+ * intentionally re-state that snake_case shape rather than inventing a camelCase
+ * transport DTO, because the registry routes return the row verbatim
+ * (`c.json({ mcp })`). Keeping the field names identical to the DB row is the
+ * single source of truth — the UI reads exactly what the API returns.
+ */
+export {};

package/cloud/mcps/lib/mcp-mutations.d.ts

@@ -0,0 +1,17 @@
+/**
+ * MCP registry mutations: create / update / delete / publish / unpublish.
+ *
+ * All write to the real `/api/v1/mcps` CRUD + `:mcpId/publish` routes through
+ * the shared cloud `apiFetch` client (auth injection + structured `ApiError`)
+ * and invalidate {@link MCPS_QUERY_KEY} so the list + detail re-fetch.
+ */
+import type { CreateUserMcpInput, CreateUserMcpResponse, MutateUserMcpResponse, UpdateUserMcpInput } from "./api-types.js";
+export declare function useCreateMcp(): import("@tanstack/react-query").UseMutationResult<CreateUserMcpResponse, Error, CreateUserMcpInput, unknown>;
+export declare function useUpdateMcp(): import("@tanstack/react-query").UseMutationResult<MutateUserMcpResponse, Error, {
+    mcpId: string;
+    input: UpdateUserMcpInput;
+}, unknown>;
+export declare function useDeleteMcp(): import("@tanstack/react-query").UseMutationResult<void, Error, string, unknown>;
+export declare function usePublishMcp(): import("@tanstack/react-query").UseMutationResult<MutateUserMcpResponse, Error, string, unknown>;
+export declare function useUnpublishMcp(): import("@tanstack/react-query").UseMutationResult<MutateUserMcpResponse, Error, string, unknown>;
+//# sourceMappingURL=mcp-mutations.d.ts.map

package/cloud/mcps/lib/mcp-mutations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-mutations.d.ts","sourceRoot":"","sources":["../../../../../../../src/cloud/mcps/lib/mcp-mutations.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EACV,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAOrB,wBAAgB,YAAY,iHAc3B;AAED,wBAAgB,YAAY;WAOf,MAAM;WACN,kBAAkB;YAY9B;AAED,wBAAgB,YAAY,oFAU3B;AAED,wBAAgB,aAAa,qGAa5B;AAED,wBAAgB,eAAe,qGAa9B"}