Home / Servers / OpenAI API / list_run_steps

List run steps

An MCP tool from the OpenAI API server, hosted on mcp.hjlabs.in.

List run steps Returns a list of run steps belonging to a run. [GET /threads/{thread_id}/runs/{run_id}/steps]

Name on the gateway: openai_api__list_run_steps · read-only.

Parameters

NameTypeDescription
thread_id requiredstringThe ID of the thread the run and run steps belong to.
run_id requiredstringThe ID of the run the run steps belong to.
limitintegerA limit on the number of objects to be returned. Limit can range between 1 and…
orderasc | descSort order by the created_at timestamp of the objects. asc for ascending order…
afterstringA cursor for use in pagination. after is an object ID that defines your place…
beforestringA cursor for use in pagination. before is an object ID that defines your place…
include[]arrayA list of additional fields to include in the response. Currently the only…

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:

call_tool arguments
{
  "name": "openai_api__list_run_steps",
  "arguments": {
    "thread_id": "…",
    "run_id": "…"
  }
}

Or connect the OpenAI API server directly, which lists 371 tools including this one:

Run in your terminal
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 run steps tool with thread_id set to ….

More from OpenAI API