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

# Get Mcp Gateway Sessions

`GET /v1/mcp/sessions`

## Request

- Base URL: `https://api.sea-lion.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sea-lion.ai/v1/mcp/sessions`
- Auth: API key in header `x-litellm-api-key`

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

## Response `200`

Successful Response

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

## Changes

- **2026-10-21** `f2fb14eab3f5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sea-lion/apis/litellm-api/changes/v1/mcp/sessions/get.md)

---

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