useCallServerTool

sunpeak API

Overview

Returns a function to invoke other MCP tools registered on the server. Useful for multi-step workflows where one app needs to trigger another tool.

Wraps callServerTool

MCP Apps SDK reference

Import

import { useCallServerTool } from 'sunpeak';

Signature

function useCallServerTool(): (params: CallServerToolParams) => Promise<CallServerToolResult | undefined>

CallServerToolParams

name

string

required

Name of the MCP tool to call.

arguments

Record<string, unknown>

Arguments to pass to the tool.

Returns

callTool

(params: CallServerToolParams) => Promise<CallServerToolResult | undefined>

Function to call an MCP server tool.

CallServerToolResult

content

Array<{ type: string; text?: string }>

Tool response content (human-readable text for the host model).

structuredContent

Record<string, unknown>

Structured data from the tool response. Use this for machine-readable data the calling resource needs to render (e.g., { status: 'success', message: '...' }).

isError

boolean

Whether the tool call resulted in an error. Only set for actual execution failures — not for expected outcomes like cancellations.

Usage

import { useCallServerTool } from 'sunpeak';

function ReviewResource() {
  const callTool = useCallServerTool();

  const handleApply = async () => {
    const result = await callTool({
      name: 'apply_changes',
      arguments: { changesetId: 'cs_789' },
    });
    console.log('Tool result:', result);
  };

  return <button onClick={handleApply}>Apply Changes</button>;
}

useCreateSamplingMessageRequest LLM completions from the host.

​Overview

Wraps callServerTool

​Import

​Signature

​CallServerToolParams

​Returns

​CallServerToolResult

​Usage