---
title: "Call Tool"
method: POST
path: "/mcp-server/call-tool"
tags: ["mcp-server"]
---

# Call Tool

`POST /mcp-server/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, MCP Handle will instantiates an MCP client and establishes a connection with the remote MCP server to call the tool.

## Request body

- CallToolRequest
  - `serverUrl` string, required — The full URL for connecting to the MCP server
  - `toolName` string, required — The name of the tool to call
  - `toolArgs` object — The input parameters for the tool
  - `connectionType` 'SSE' | 'StreamableHttp'
  - `headers` object, nullable — Optional HTTP headers to include when connecting to the server

## Response `200`

Successful Response

- CallToolResponse
  - `success` boolean, required — Whether the API call was successful
  - `result` CallToolResult — The server's response to a tool call.
    - `content` unknown[], required — The content of the tool call
      - unknown
    - `isError` boolean — Whether the tool call was successful
  - `error` string, nullable — Error message, if the tool call failed

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/weatherpal-ai/apis/mcp-handle-https-www-mcp-handle-dev.md) · [All operations](https://skmtc.net/weatherpal-ai/apis/mcp-handle-https-www-mcp-handle-dev/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/weatherpal-ai/mcp-handle-https-www-mcp-handle-dev/versions/58fc8af3b578/schema)