Home / Servers / OpenAI API / list_agent_environment_files

List agent environment files

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

List agent environment files Lists live files on a connected execution environment with optional directory filtering and opaque cursor pagination. See environment files. [GET /agents/environments/{environment_id}/files]

Name on the gateway: openai_api__list_agent_environment_files · read-only.

Parameters

NameTypeDescription
environment_id requiredstringThe ID of the environment.
pathstringRestrict the listing to this absolute workspace directory.
limitintegerThe maximum number of files to return, between 1 and 100.
orderasc | descSort by case-sensitive path components. Defaults to descending.
pagestringThe opaque token from the previous page. Keep the same path, order, and limit.

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_environment_files",
  "arguments": {
    "environment_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 agent environment files tool with environment_id set to ….

More from OpenAI API