Home / Servers / OpenAI API / list_agent_session_turns
List agent session turns
An MCP tool from the OpenAI API server, hosted on mcp.hjlabs.in.
List agent session turns Lists turns by creation time and turn ID. The after cursor is exclusive in the selected order. See session turns. [GET /agents/sessions/{session_id}/turns]
Name on the gateway: openai_api__list_agent_session_turns · read-only.
Parameters
| Name | Type | Description |
|---|---|---|
session_id required | string | The ID of the session. |
limit | integer | The maximum number of resources to return, between 1 and 100. Defaults to 20. |
order | asc | desc | The order in which resources are returned. Defaults to desc. |
after | string | Return resources after this resource ID in the selected order. |
How to call it
Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:
{
"name": "openai_api__list_agent_session_turns",
"arguments": {
"session_id": "…"
}
}Or connect the OpenAI API server directly, which lists 371 tools including this one:
claude mcp add --transport http hj-openai-api https://mcp.hjlabs.in/mcp/openai-api \
--header "Authorization: Bearer YOUR_API_KEY"Try asking
Use the list agent session turns tool with session_id set to ….