Home / Servers / OpenAI API / list_messages
List messages
An MCP tool from the OpenAI API server, hosted on mcp.hjlabs.in.
List messages Returns a list of messages for a given thread. [GET /threads/{thread_id}/messages]
Name on the gateway: openai_api__list_messages · read-only.
Parameters
| Name | Type | Description |
|---|---|---|
thread_id required | string | The ID of the thread the messages belong to. |
limit | integer | A limit on the number of objects to be returned. Limit can range between 1 and… |
order | asc | desc | Sort order by the created_at timestamp of the objects. asc for ascending order… |
after | string | A cursor for use in pagination. after is an object ID that defines your place… |
before | string | A cursor for use in pagination. before is an object ID that defines your place… |
run_id | string | Filter messages by the run ID that generated them. |
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_messages",
"arguments": {
"thread_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 messages tool with thread_id set to ….