---
title: "Call an MCP connector tool"
method: POST
path: "/mcp-connectors/tools/call"
tags: ["MCP Connectors"]
---

# Call an MCP connector tool

`POST /mcp-connectors/tools/call`

## Request

- Base URL: `https://api.sazabi.com/v1`
- URL: `https://api.sazabi.com/v1/mcp-connectors/tools/call`
- Auth: none declared

Invoke one executable third-party MCP connector tool using that connection's stored credential.

## Request body

- object
  - `projectId` string, uuid: Project the connector belongs to. Auto-filled from SDK context when omitted.
  - `connectionKey` string, required: Connector key from search or mcpConnectors.list.
  - `toolName` string, required: Tool name as invoked.
  - `arguments` object: Arguments matching the tool's input schema.

## Response `200`

OK

- union
  - object
    - `ok` unknown, required
    - `connectionKey` string, required: Connector that ran the tool.
    - `toolName` string, required: Tool name as invoked.
    - `result` unknown
    - `structuredContent` unknown
    - `content` object[], required: Raw MCP content parts from the vendor.
    - `text` string, nullable, required: Concatenated text content, if any.
  - object
    - `ok` unknown, required
    - `code` 'TOOL_NOT_ENABLED' | 'READ_ONLY' | 'MCP_ERROR', required: Why the tool did not run.
    - `message` string, required: Caller-facing error message.

---

[API](https://skmtc.dev/sazabi/apis/sazabi-public-api.md) - [All operations](https://skmtc.dev/sazabi/apis/sazabi-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sazabi/apis/sazabi-public-api/revisions/965b6230cf45?raw)