---
title: "List Mcp Server Instance Tool Policies"
method: GET
path: "/v1/workspaces/{workspace}/mcp-server-instances/tool-policies"
tags: ["v1", "protected", "mcp-server-instances"]
---

# List Mcp Server Instance Tool Policies

`GET /v1/workspaces/{workspace}/mcp-server-instances/tool-policies`

## Request

- The document declares no server URL.
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/agentarea/apis/agentarea-api/docs/v1/workspaces/:workspace/mcp-server-instances/tool-policies/get.ts> (a function with typed inputs; its response is checked against the schema)

Each connection's tools with their workspace default and verdict, in one read.

What the agent editor shows beside the tools of every server it can attach.

## Path parameters

- `workspace` string, required: Slug of the workspace the request acts in

## Response `200`

Successful Response

- MCPWorkspaceToolPolicies
  - `instances` MCPInstanceToolPoliciesOfInstance[], required
    - `instance_id` string, uuid, required
    - `tools` MCPInstanceToolPolicy[], required
      - `default` 'allow' | 'approval' | 'deny', required
      - `effective` 'allow' | 'approval' | 'deny', required
      - `name` string, required
      - `reason` string, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-01** `bf3884bf6de3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentarea/apis/agentarea-api/changes/v1/workspaces/:workspace/mcp-server-instances/tool-policies/get.md)

---

[API](https://skmtc.dev/agentarea/apis/agentarea-api.md) - [All operations](https://skmtc.dev/agentarea/apis/agentarea-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentarea/apis/agentarea-api/revisions/7a4e10cf159f?raw)