Skip to main content
POST

Call Tool

Call a specific tool on an MCP server. This is a convenience wrapper around the generic /mcp/call endpoint.

Request

Headers

X-API-Key
string
required
Your MCP Rank API key

Body Parameters

server_id
string
required
The MCP Rank server ID
name
string
required
Name of the tool to call
arguments
object
Tool arguments (structure depends on tool’s inputSchema)

Response

Returns the tool’s execution result. The structure depends on the specific tool.

Tool Result Format

MCP tools return results in a standard format: Content blocks can be:
  • Text: {"type": "text", "text": "..."}
  • Image: {"type": "image", "data": "base64...", "mimeType": "image/png"}
  • Resource: {"type": "resource", "resource": {...}}

Error Responses

Error Response