---
title: "Get Mcp Gateway Sessions"
method: GET
path: "/v1/mcp/sessions"
tags: ["mcp"]
---

# Get Mcp Gateway Sessions

`GET /v1/mcp/sessions`

Live stateful MCP gateway sessions on this proxy worker, grouped by AI client and by user.

## Response `200`

Successful Response

- MCPGatewaySessionsResponse
  - `worker_pid` integer, required
  - `total_sessions` integer, required
  - `by_client` MCPGatewaySessionGroupCount[]
    - `label` string, nullable
    - `count` integer, required
  - `by_user` MCPGatewaySessionGroupCount[]
    - `label` string, nullable
    - `count` integer, required
  - `sessions` MCPGatewaySession[]
    - `session_id_prefix` string, required
    - `client_name` string, nullable
    - `client_version` string, nullable
    - `user_id` string, nullable
    - `user_email` string, nullable
    - `key_alias` string, nullable
    - `team_id` string, nullable
    - `team_alias` string, nullable
    - `client_ip` string, nullable
    - `idle_seconds` number, required
    - `in_flight_requests` integer, required

## Changes

- **2026-10-05** `611a0ed75fe8` — 2 info
  - api tag `mcp` added
  - api tag `mcp_management` removed
- **2026-10-04** `51c2ca10dc0b` — 2 info
  - api tag `mcp_management` added
  - api tag `mcp` removed
- **2026-09-30** `85ac4287140e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/flock/apis/litellm-api/changes/v1/mcp/sessions/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/ee3a9ebe33fd?raw)