Skip to main content

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.