sessions_search

tool · Connected client

Before you start

Trigger the request you want to find and note its method. Search the retained sessions on that Mac, not the app’s logs.

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

Request

{
  "name": "sessions_search",
  "arguments": {
    "method": "GET",
    "limit": 5
  }
}

method

An exact HTTP method such as GET.

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

Find a short page of matching GET requests without requesting response bodies.

If the result is unexpected

Broaden the method filter before assuming the app never sent a request.

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 search.

Browse all MCP reference entries →