---
title: "List Tool Rest Api"
method: GET
path: "/mcp-rest/tools/list"
tags: ["mcp_rest"]
---

# List Tool Rest Api

`GET /mcp-rest/tools/list`

List all available tools with information about the server they belong to.

Example response:
{
    "tools": [
        {
            "name": "create_zap",
            "description": "Create a new zap",
            "inputSchema": "tool_input_schema",
            "mcp_info": {
                "server_name": "zapier",
                "logo_url": "https://www.zapier.com/logo.png",
                "server_id": "a1b2c3d4-...",
                "alias": "zapier_prod",
            }
        }
    ],
    "error": null,
    "message": "Successfully retrieved tools"
}

## Query parameters

- `server_id` string, nullable — The server id to list tools for
- `mcp_server_name` string, nullable — Filter tools to a single MCP server by name or alias
- `toolset_name` string, nullable — Filter tools to a single toolset by name
- `include_disabled_tools` boolean — Admin only. Return the full server tool catalog without the allowed_tools filter or per-key tool permissions, so the MCP settings UI can configure the allowlist. Ignored for non-admins.

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-25** `a4fccd4bf54d` — 2 info
  - api tag `mcp_rest` added
  - api tag `mcp` removed
- **2026-09-24** `731afbea6a1b` — 2 info
  - api tag `mcp` added
  - api tag `mcp_rest` removed
- **2026-09-23** `7ed45f30a5f0` — 2 info
  - api tag `mcp_rest` added
  - api tag `mcp` removed
- **2026-09-21** `6246f8d427b7` — 2 info
  - api tag `mcp` added
  - api tag `mcp_rest` removed
- **2026-09-19** `c357baf422ab` — 2 info
  - api tag `mcp_rest` added
  - api tag `mcp` removed

[Full history](https://skmtc.dev/flock/apis/litellm-api/changes/mcp-rest/tools/list/get.md)

---

[API](https://skmtc.dev/flock/apis/litellm-api.md) · [All operations](https://skmtc.dev/flock/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flock/apis/litellm-api/revisions/b694deb1e459?raw)
