refactor: rename request methods to remove send prefix

Following the MCP TS SDK convention where request methods don't have
the "send" prefix (reserved for notifications):

- App.sendMessage() → App.message()
- App.sendOpenLink() → App.openLink()
- AppBridge.sendResourceTeardown() → AppBridge.resourceTeardown()

The old method names are kept as deprecated aliases for backwards
compatibility.

Updated all examples to use the new method names.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: ochafik

examples/basic-host/src/index.tsx

@@ -289,7 +289,7 @@ function AppIFramePanel({ toolCallInfo, isDestroying, onTeardownComplete }: AppI
     }
 
     log.info("Sending teardown notification to MCP App");
-    appBridgeRef.current.sendResourceTeardown({})
+    appBridgeRef.current.resourceTeardown({})
       .catch((err) => {
         log.warn("Teardown request failed (app may have already closed):", err);
       })

examples/basic-server-react/README.md

@@ -9,7 +9,7 @@ An MCP App example with a React UI.
 
 - Tool registration with a linked UI resource
 - React UI using the [`useApp()`](https://modelcontextprotocol.github.io/ext-apps/api/functions/_modelcontextprotocol_ext-apps_react.useApp.html) hook
-- App communication APIs: [`callServerTool`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#callservertool), [`sendMessage`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#sendmessage), [`sendLog`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#sendlog), [`sendOpenLink`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#sendopenlink)
+- App communication APIs: [`callServerTool`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#callservertool), [`message`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#message), [`sendLog`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#sendlog), [`openLink`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#openlink)
 
 ## Key Files
 

examples/basic-server-react/src/mcp-app.tsx

@@ -93,7 +93,7 @@ function GetTimeAppInner({ app, toolResult }: GetTimeAppInnerProps) {
     const signal = AbortSignal.timeout(5000);
     try {
       log.info("Sending message text to Host:", messageText);
-      const { isError } = await app.sendMessage(
+      const { isError } = await app.message(
         { role: "user", content: [{ type: "text", text: messageText }] },
         { signal },
       );
@@ -110,7 +110,7 @@ function GetTimeAppInner({ app, toolResult }: GetTimeAppInnerProps) {
 
   const handleOpenLink = useCallback(async () => {
     log.info("Sending open link request to Host:", linkUrl);
-    const { isError } = await app.sendOpenLink({ url: linkUrl });
+    const { isError } = await app.openLink({ url: linkUrl });
     log.info("Open link request", isError ? "rejected" : "accepted");
   }, [app, linkUrl]);
 

examples/basic-server-vanillajs/README.md

@@ -9,7 +9,7 @@ An MCP App example with a vanilla JavaScript UI (no framework).
 
 - Tool registration with a linked UI resource
 - Vanilla JS UI using the [`App`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html) class directly
-- App communication APIs: [`callServerTool`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#callservertool), [`sendMessage`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#sendmessage), [`sendLog`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#sendlog), [`sendOpenLink`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#sendopenlink)
+- App communication APIs: [`callServerTool`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#callservertool), [`message`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#message), [`sendLog`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#sendlog), [`openLink`](https://modelcontextprotocol.github.io/ext-apps/api/classes/app.App.html#openlink)
 
 ## Key Files
 

examples/basic-server-vanillajs/src/mcp-app.ts

@@ -75,7 +75,7 @@ sendMessageBtn.addEventListener("click", async () => {
   const signal = AbortSignal.timeout(5000);
   try {
     log.info("Sending message text to Host:", messageText.value);
-    const { isError } = await app.sendMessage(
+    const { isError } = await app.message(
       { role: "user", content: [{ type: "text", text: messageText.value }] },
       { signal },
     );
@@ -92,7 +92,7 @@ sendLogBtn.addEventListener("click", async () => {
 
 openLinkBtn.addEventListener("click", async () => {
   log.info("Sending open link request to Host:", linkUrl.value);
-  const { isError } = await app.sendOpenLink({ url: linkUrl.value });
+  const { isError } = await app.openLink({ url: linkUrl.value });
   log.info("Open link request", isError ? "rejected" : "accepted");
 });
 

examples/threejs-server/src/mcp-app-wrapper.tsx

@@ -30,9 +30,9 @@ export interface WidgetProps<TToolInput = Record<string, unknown>> {
   /** Call a tool on the MCP server */
   callServerTool: App["callServerTool"];
   /** Send a message to the host's chat */
-  sendMessage: App["sendMessage"];
+  message: App["message"];
   /** Request the host to open a URL */
-  sendOpenLink: App["sendOpenLink"];
+  openLink: App["openLink"];
   /** Send log messages to the host */
   sendLog: App["sendLog"];
 }
@@ -77,12 +77,12 @@ function McpAppWrapper() {
     (params, options) => app!.callServerTool(params, options),
     [app],
   );
-  const sendMessage = useCallback<App["sendMessage"]>(
-    (params, options) => app!.sendMessage(params, options),
+  const message = useCallback<App["message"]>(
+    (params, options) => app!.message(params, options),
     [app],
   );
-  const sendOpenLink = useCallback<App["sendOpenLink"]>(
-    (params, options) => app!.sendOpenLink(params, options),
+  const openLink = useCallback<App["openLink"]>(
+    (params, options) => app!.openLink(params, options),
     [app],
   );
   const sendLog = useCallback<App["sendLog"]>(
@@ -105,8 +105,8 @@ function McpAppWrapper() {
       toolResult={toolResult}
       hostContext={hostContext}
       callServerTool={callServerTool}
-      sendMessage={sendMessage}
-      sendOpenLink={sendOpenLink}
+      message={message}
+      openLink={openLink}
       sendLog={sendLog}
     />
   );

examples/threejs-server/src/threejs-app.tsx

@@ -142,8 +142,8 @@ export default function ThreeJSApp({
   toolResult: _toolResult,
   hostContext: _hostContext,
   callServerTool: _callServerTool,
-  sendMessage: _sendMessage,
-  sendOpenLink: _sendOpenLink,
+  message: _message,
+  openLink: _openLink,
   sendLog: _sendLog,
 }: ThreeJSAppProps) {
   const [error, setError] = useState<string | null>(null);

examples/wiki-explorer-server/src/mcp-app.ts

@@ -270,7 +270,7 @@ resetBtn.addEventListener("click", async () => {
 // Open button - opens the Wikipedia page in browser
 openBtn.addEventListener("click", async () => {
   if (selectedNodeUrl) {
-    await app.sendOpenLink({ url: selectedNodeUrl });
+    await app.openLink({ url: selectedNodeUrl });
     hidePopup();
   }
 });

src/app-bridge.ts

@@ -1174,15 +1174,15 @@ export class AppBridge extends Protocol<
    * @example
    * ```typescript
    * try {
-   *   await bridge.sendResourceTeardown({});
+   *   await bridge.resourceTeardown({});
    *   // Guest UI is ready, safe to unmount iframe
    *   iframe.remove();
    * } catch (error) {
    *   console.error("Teardown failed:", error);
    * }
    * ```
    */
-  sendResourceTeardown(
+  resourceTeardown(
     params: McpUiResourceTeardownRequest["params"],
     options?: RequestOptions,
   ) {
@@ -1196,6 +1196,16 @@ export class AppBridge extends Protocol<
     );
   }
 
+  /**
+   * @deprecated Use {@link resourceTeardown} instead
+   */
+  sendResourceTeardown(
+    params: McpUiResourceTeardownRequest["params"],
+    options?: RequestOptions,
+  ) {
+    return this.resourceTeardown(params, options);
+  }
+
   /**
    * Connect to the Guest UI via transport and optionally set up message forwarding.
    *

src/app.ts

@@ -758,7 +758,7 @@ export class App extends Protocol<AppRequest, AppNotification, AppResult> {
    * @example Send a text message from user interaction
    * ```typescript
    * try {
-   *   await app.sendMessage({
+   *   await app.message({
    *     role: "user",
    *     content: [{ type: "text", text: "Show me details for item #42" }]
    *   });
@@ -770,7 +770,7 @@ export class App extends Protocol<AppRequest, AppNotification, AppResult> {
    *
    * @see {@link McpUiMessageRequest} for request structure
    */
-  sendMessage(params: McpUiMessageRequest["params"], options?: RequestOptions) {
+  message(params: McpUiMessageRequest["params"], options?: RequestOptions) {
     return this.request(
       <McpUiMessageRequest>{
         method: "ui/message",
@@ -781,6 +781,13 @@ export class App extends Protocol<AppRequest, AppNotification, AppResult> {
     );
   }
 
+  /**
+   * @deprecated Use {@link message} instead
+   */
+  sendMessage(params: McpUiMessageRequest["params"], options?: RequestOptions) {
+    return this.message(params, options);
+  }
+
   /**
    * Send log messages to the host for debugging and telemetry.
    *
@@ -823,7 +830,7 @@ export class App extends Protocol<AppRequest, AppNotification, AppResult> {
    * @example Open documentation link
    * ```typescript
    * try {
-   *   await app.sendOpenLink({ url: "https://docs.example.com" });
+   *   await app.openLink({ url: "https://docs.example.com" });
    * } catch (error) {
    *   console.error("Failed to open link:", error);
    *   // Optionally show fallback: display URL for manual copy
@@ -832,7 +839,7 @@ export class App extends Protocol<AppRequest, AppNotification, AppResult> {
    *
    * @see {@link McpUiOpenLinkRequest} for request structure
    */
-  sendOpenLink(
+  openLink(
     params: McpUiOpenLinkRequest["params"],
     options?: RequestOptions,
   ) {
@@ -846,6 +853,16 @@ export class App extends Protocol<AppRequest, AppNotification, AppResult> {
     );
   }
 
+  /**
+   * @deprecated Use {@link openLink} instead
+   */
+  sendOpenLink(
+    params: McpUiOpenLinkRequest["params"],
+    options?: RequestOptions,
+  ) {
+    return this.openLink(params, options);
+  }
+
   /**
    * Request a change to the display mode.
    *