Home / Servers / OpenAI API / list_conversation_items

List items

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

List items List all items for a conversation with the given ID. [GET /conversations/{conversation_id}/items]

Name on the gateway: openai_api__list_conversation_items · read-only.

Parameters

NameTypeDescription
conversation_id requiredstringThe ID of the conversation to list items for.
limitintegerA limit on the number of objects to be returned. Limit can range between 1 and…
orderasc | descThe order to return the input items in. Default is desc. - asc: Return the…
afterstringAn item ID to list items after, used in pagination.
includearraySpecify additional output data to include in the model response. Currently…

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_conversation_items",
  "arguments": {
    "conversation_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 items tool with conversation_id set to ….

More from OpenAI API