Home / Servers / OpenAI API / create_role

Create organization role

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

Create organization role Creates a custom role for the organization. [POST /organization/roles]

Name on the gateway: openai_api__create_role · may change things.

Parameters

NameTypeDescription
role_name requiredstringUnique name for the role.
permissions requiredarrayPermissions to grant to the role.
descriptionstringOptional description of the role.

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__create_role",
  "arguments": {
    "role_name": "…",
    "permissions": []
  }
}

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 create organization role tool with role_name set to ….

More from OpenAI API