Home / Servers / OpenAI API / list_roles
List organization roles
An MCP tool from the OpenAI API server, hosted on mcp.hjlabs.in.
List organization roles Lists the roles configured for the organization. [GET /organization/roles]
Name on the gateway: openai_api__list_roles · read-only.
Parameters
| Name | Type | Description |
|---|---|---|
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. |
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_roles",
"arguments": {}
}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 organization roles tool with limit set to ….