Call Tool - Bonsai

`tools/call`

Execute a tool.

This endpoint requires authentication. Ensure you have initialized the MCP connection before calling this method.

Parameters

name

string

required

Name of the tool to execute. Use tools/list to retrieve available tool names.

arguments

object

required

Arguments to pass to the tool. The structure depends on the tool’s inputSchema. For search_offerings, pass a question string containing the search query.

Request

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "search_offerings",
    "arguments": {
      "question": "What humidifiers do you have?"
    }
  }
}

Response

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Found 5 offerings for: What humidifiers do you have?"
      }
    ],
    "structuredContent": {
      "view": "search_results",
      "data": {
        "products": [...],
        "search_query": "What humidifiers do you have?",
        "count": 5
      }
    }
  }
}

The view field in structuredContent specifies the UI view type for rendering the results. The data object contains the actual search results and metadata.

Tools List

List Resources

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "search_offerings",
    "arguments": {
      "question": "What humidifiers do you have?"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Found 5 offerings for: What humidifiers do you have?"
      }
    ],
    "structuredContent": {
      "view": "search_results",
      "data": {
        "products": [...],
        "search_query": "What humidifiers do you have?",
        "count": 5
      }
    }
  }
}

​tools/call

​Parameters

​Request

​Response

`tools/call`

Parameters

Request

Response