---
title: "Get All Tools"
method: GET
path: "/v1/workspaces/{workspace}/agents/tools"
tags: ["v1", "protected", "agents"]
---

# Get All Tools

`GET /v1/workspaces/{workspace}/agents/tools`

Get all available tools across all types.

Returns a unified list of tools from:
- Code tools (static, YAML-based)
- MCP tools (dynamic, from running instances)

Query Parameters:
    include: Comma-separated tool types (default: "code,mcp")
    mcp_instance_id: Filter MCP tools by instance (optional)

Example:
    GET /v1/agents/tools?include=code,mcp
    GET /v1/agents/tools?include=code
    GET /v1/agents/tools?include=mcp&mcp_instance_id={uuid}

## Path parameters

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

## Query parameters

- `include` string — Comma-separated list of tool types to include (code, mcp)
- `mcp_instance_id` string, uuid, nullable — Filter MCP tools by specific instance ID

## Response `200`

Successful Response

- ToolResponse[]
  - `available_methods` ToolMethodResponse[]
    - `description` string, required
    - `display_name` string, required
    - `effect` 'read' | 'write' | 'destructive' | 'privileged', nullable
    - `name` string, required
    - `requires_user_confirmation` boolean
  - `category` string
  - `description` string, required
  - `display_name` string
  - `input_schema` object
  - `mcp_instance_id` string, uuid, nullable
  - `mcp_instance_name` string, nullable
  - `name` string, required
  - `plane` 'runtime' | 'build' | 'operate' | 'observe' | 'govern' | 'federate', nullable
  - `requires_user_confirmation` boolean
  - `type` 'code' | 'mcp', required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-26** `d3ad8e1a3681` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/agentarea/apis/agentarea-api/changes/v1/workspaces/:workspace/agents/tools/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/d3ad8e1a3681?raw)