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.

post/mcp-server/call-tool

Request

  • Base URL
    https://api.mcp-handle.dev
  • URL
    https://api.mcp-handle.dev/mcp-server/call-tool
  • Auth
    HTTP bearer

Request body

serverUrlstring required

The full URL for connecting to the MCP server

toolNamestring required

The name of the tool to call

toolArgsobject

The input parameters for the tool

connectionType'SSE' | 'StreamableHttp'
headersobject nullable

Optional HTTP headers to include when connecting to the server

Response

Successful Response

successboolean required

Whether the API call was successful

errorstring nullable

Error message, if the tool call failed

Changes

No recorded changes to this operation across all 1 revision of this API.