Home / Servers / OpenAI API / list_project_roles

List project roles

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

List project roles Lists the roles configured for a project. [GET /projects/{project_id}/roles]

Name on the gateway: openai_api__list_project_roles · read-only.

Parameters

Name	Type	Description
`project_id` required	`string`	The ID of the project to inspect.
`limit`	`integer`	A limit on the number of roles to return. Defaults to 1000.
`after`	`string`	Cursor for pagination. Provide the value from the previous response's next…
`order`	`asc \| desc`	Sort order for the returned roles.

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_project_roles",
  "arguments": {
    "project_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"

Use the list project roles tool with project_id set to ….