generateHelpers

Without it, useCallTool and useToolInfo need their tool types written by hand, duplicating your server. generateHelpers infers them from your server type, so you import already-typed hooks. Set it up once and use the hooks across your views.

Example

helpers.ts wires your server type to the hooks; views import the typed hooks from it.

helpers.ts

import type { AppType } from "./server"; // type-only import
import { generateHelpers } from "skybridge/web";

export const { useCallTool, useToolInfo } = generateHelpers<AppType>();

views/carousel.tsx

import { useCallTool, useToolInfo } from "../helpers.js";

function Carousel() {
  const { output } = useToolInfo<"search-products">(); // output typed from the tool
  const { callTool } = useCallTool("create-checkout"); // name autocompleted, input typed

  return (
    <button onClick={() => callTool({ items: output.products })}>Check out</button>
  );
}

Signature

const { useCallTool, useToolInfo } = generateHelpers<ServerType>();

Type Parameters

`ServerType`

ServerType extends McpServer<AnyToolRegistry>;

Your app’s type, typeof app. Export it from src/server.ts with export type AppType = typeof app, then pass it here.

Inference works only when handler chains .registerTool() calls on the server it receives and returns the result, so the tool types accumulate on typeof app.

Returns

Two hooks. Both autocomplete tool names and infer types from ServerType, so you write no generics; their surface is otherwise identical to the untyped versions.

`useCallTool`

The typed useCallTool: the name argument autocompletes, and the input and output types follow the named tool.

`useToolInfo`

The typed useToolInfo: the tool name (its type argument) autocompletes, and input, output, and responseMetadata follow it.

useCallTool

Call a tool from a view

useToolInfo

Read the tool result the view mounted with

McpServer

The server whose type you infer from

Server

Auth

Identity Providers

Hooks

Utilities

Types

Low-level

Example

Signature

Type Parameters

`ServerType`

Returns

`useCallTool`

`useToolInfo`

useCallTool

useToolInfo

McpServer

​Example

​Signature

​Type Parameters

​ServerType

​Returns

​useCallTool

​useToolInfo

useCallTool

useToolInfo

McpServer

Example

Signature

Type Parameters

`ServerType`

Returns

`useCallTool`

`useToolInfo`