Home / Servers / Discord API / create_guild_role

POST /guilds/{guild_id}/roles

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

POST /guilds/{guild_id}/roles [POST /guilds/{guild_id}/roles]

Name on the gateway: discord_api__create_guild_role · may change things.

Parameters

NameTypeDescription
guild_id requiredstringguild_id parameter
namestring
permissionsinteger
colorinteger
colorsobject
hoistboolean
mentionableboolean
iconstring
unicode_emojistring

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": "discord_api__create_guild_role",
  "arguments": {
    "guild_id": "…"
  }
}

Or connect the Discord API server directly, which lists 250 tools including this one:

Run in your terminal
claude mcp add --transport http hj-discord-api https://mcp.hjlabs.in/mcp/discord-api \
  --header "Authorization: Bearer YOUR_API_KEY"

Try asking

Use the post /guilds/{guild_id}/roles tool with guild_id set to ….

More from Discord API