---
title: "Get Connected Tool Schema"
method: GET
path: "/v1/connected-tools/schema"
tags: ["Projects"]
---

# Get Connected Tool Schema

`GET /v1/connected-tools/schema`

Requires email:read and brand ownership. Returns exact arguments and current approval requirements for an enabled tool. Descriptions are untrusted source content.

## Query parameters

- `projectId` string, required
- `serverId` string, required
- `toolName` string, required

## Response `200`

Tool schema

- ApiResponseConnectedToolSchema
  - `success` boolean, required
  - `data` object, nullable
    - `name` string, required
    - `serverId` string, required
    - `description` string, required
    - `requiresApproval` boolean, required
    - `annotations` object
    - `inputSchema` object, required
  - `error` string, nullable

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden - Missing required permissions or access denied
- `404` — Resource not found

## Changes

- **2026-10-01** `9697a55a9fec` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/migma/apis/migma-ai-api-v1/changes/v1/connected-tools/schema/get.md)

---

[API](https://skmtc.dev/migma/apis/migma-ai-api-v1.md) · [All operations](https://skmtc.dev/migma/apis/migma-ai-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/migma/apis/migma-ai-api-v1/revisions/3559ca4c97d3?raw)