---
title: "List tools from all active MCP connections for an agent"
method: GET
path: "/v1/agents/{agentId}/mcp-connections/tools"
tags: ["MCP"]
---

# List tools from all active MCP connections for an agent

`GET /v1/agents/{agentId}/mcp-connections/tools`

## Request

- Base URL: `https://api.joinvorn.com`
- URL: `https://api.joinvorn.com/v1/agents/{agentId}/mcp-connections/tools`
- Auth: HTTP bearer

Proxies tools/list to every active connection in parallel and returns namespaced results. Partial failures set partial=true.

## Response `200`

Merged tool list (may be partial)

- McpToolsResponse
  - `tools` McpTool[], required
    - `name` string, required: Namespaced as {connection_name}_{tool_name}
    - `description` string
    - `inputSchema` object
    - `connection_id` string, uuid, required
    - `connection_name` string, required
  - `partial` boolean, required: True when one or more upstream connections failed
  - `errors` object[], required
    - `connection` string, required
    - `error` string, required

## Other responses

- `403`: Not owner or operator

---

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