useHostInfo

The same view runs inside every host — Claude, Cursor, Goose, and others. useHostInfo reports which one, taken from the MCP Apps ui/initialize handshake, so the view can adapt copy, shortcuts, or layout to the host it’s rendering in. It runs only on MCP Apps hosts; the name is normalized to a Host slug when recognized, otherwise passed through as a raw string.

Example

An empty state suggests the next action using the wording that fits the host.

import { useHostInfo } from "skybridge/web";

function EmptyState() {
  const { name } = useHostInfo();
  const hint =
    name === "claude"
      ? "Ask Claude to add your first item."
      : "Send a message to add your first item.";

  return <p className="empty">{hint}</p>;
}

Returns

`name`

name: Host | (string & {}) | undefined;

The host’s reported name. It resolves to a Host slug for recognized hosts, a raw string for hosts not yet mapped, and undefined until the handshake completes — the view renders first and re-renders once the host responds. The (string & {}) keeps the known slugs in autocomplete while still accepting any string.

`version`

version: string | undefined;

The host’s version string, or undefined until the handshake completes.

Host

The recognized hosts, as normalized slugs. An unrecognized host surfaces its raw reported name instead.

type Host =
  | "chatgpt"
  | "claude"
  | "cursor"
  | "goose"
  | "mistral-vibe"
  | "alpic";

Slug	Reported `hostInfo.name`
`chatgpt`	`chatgpt`
`claude`	`Claude`
`cursor`	`Cursor`
`goose`	`MCP-UI Host`
`mistral-vibe`	`Le Chat`
`alpic`	`alpic-playground`

useUser

Read the host’s locale and device capabilities

useMcpAppContext

Read a raw MCP Apps context value by key

Design for the Host

Adapt the view to the host it runs in

Server

Auth

Identity Providers

Hooks

Utilities

Types

Low-level

Example

Returns

`name`

`version`

Host

useUser

useMcpAppContext

Design for the Host

​Example

​Returns

​name

​version

​Host

useUser

useMcpAppContext

Design for the Host

Example

Returns

`name`

`version`

Host