---
title: "Get Mcp Unique Users"
method: GET
path: "/organization/surfaces/mcp"
---

# Get Mcp Unique Users

`GET /organization/surfaces/mcp`

## Request

- Base URL: `https://api.traversal.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.traversal.com/organization/surfaces/mcp`
- Auth: none declared

Distinct humans who started a Traversal MCP session, the last 7 days unless bounded.

The organization is always the caller's. The count is a floor: follow-ups
collapse into the parent session, read-only MCP calls write no session,
and a shared API key attributes everyone to the key owner.

## Query parameters

- `start_time` string, date-time, nullable: Start timestamp (inclusive), ISO 8601 with timezone. Defaults to 7 days before end_time.
- `end_time` string, date-time, nullable: End timestamp (exclusive), ISO 8601 with timezone. Defaults to now.

## Response `200`

Successful Response

- McpUniqueUsersResponse: How many unique humans started a Traversal MCP session in the requested window.
  - `unique_user_count` integer, required

## Other responses

- `422`: Validation Error

## Changes

> 66 revisions in range; 9 not diffed.

- **2026-09-26** `75b9e4398c46`: 1 breaking, 3 info
  - removed the required property `window_days` from the response with the `200` status
  - added the new optional `query` request parameter `end_time`
  - added the new optional `query` request parameter `start_time`
  - added the non-success response with the status `422`
- **2026-09-17** `4a4435773444`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/traversal/apis/traversal-api/changes/organization/surfaces/mcp/get.md)

---

[API](https://skmtc.dev/traversal/apis/traversal-api.md) - [All operations](https://skmtc.dev/traversal/apis/traversal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/traversal/apis/traversal-api/revisions/31e1a8b7cf89?raw)