Home / Servers / OpenAI API / list_agent_environments

List agent environments

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

List agent environments Lists OpenAI-hosted environments owned by the authenticated principal. Requires access to the prewarming beta. [GET /agents/environments]

Name on the gateway: openai_api__list_agent_environments · read-only.

Parameters

NameTypeDescription
limitintegerThe maximum number of resources to return, between 1 and 100. Defaults to 20.
orderasc | descThe order in which resources are returned. Defaults to desc.
afterstringReturn resources after this resource ID in the selected order.
typeopenai_hostedThe hosting type to list. Defaults to openai_hosted.

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_agent_environments",
  "arguments": {}
}

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 agent environments tool with limit set to ….

More from OpenAI API