Call Tool

Calls a tool on a specific remote MCP server, used for function calling. Eliminates the need for manual MCP code implementation. Under the hood, Klavis will instantiates an MCP client and establishes a connection with the remote MCP server to call the tool.

POST /mcp-server/call-tool

Call Tool

cURL

curl --request POST \
  --url https://api.klavis.ai/mcp-server/call-tool \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "serverUrl": "<string>",
  "toolName": "<string>",
  "toolArgs": {},
  "connectionType": "StreamableHttp",
  "headers": {}
}
'

200

{
  "success": true,
  "result": {
    "content": [
      "<unknown>"
    ],
    "isError": false
  },
  "error": "<string>"
}

Authorizations

Authorization · string · header · required

Your Klavis AI API key.

Body

application/json

serverUrl · string · required

The full URL for connecting to the MCP server

toolName · string · required

The name of the tool to call

toolArgs · Toolargs · object

The input parameters for the tool

connectionType · enum<string> · default: StreamableHttp

The connection type to use for the MCP server. Default is STREAMABLE_HTTP.

Available options: SSE, StreamableHttp

headers · Headers · object

Optional HTTP headers to include when connecting to the server

Show child attributes

Response

200

application/json

Successful Response

success · boolean · required

Whether the API call was successful

result · CallToolResult · object

The result of the tool call, if successful

Show child attributes

error · string | null

Error message, if the tool call failed