sessions_list

tool · Connected client

Before you start

Make one recognizable request through the capture Mac. Start with a short page of sessions to find its ID; listing does not require the response body.

Access: Your MCP client needs the sessionList capability for this tool.

Request

{
  "name": "sessions_list",
  "arguments": {
    "limit": 5
  }
}

limit

Bounds the page size. Follow the returned cursor to continue.

Illustrative tools/call parameters. Inspect the tool’s inputSchema in tools/list before sending them.

What to look for

List a bounded page of captured requests. Use an actual returned session identifier in subsequent reads.

If the result is unexpected

An empty page is not proof of a routing failure. Check filters, the target action and continuation.

What to check if access is denied

Effects and cleanup

This request reads information; it does not start a test or activate a traffic change. Treat returned metadata and any exported evidence as potentially sensitive.

Same underlying tool: joesproxyctl sessions list.

Browse all MCP reference entries →