Skip to main content
POST
Grant an MCP tool to a role

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

authorization
string | null
x-ankra-organisation-id
string | null

Path Parameters

server_id
string<uuid>
required

The registered MCP server's id.

Body

application/json
tool_name
string
required
Required string length: 1 - 160
allowed_to_role
string
default:member

The role that may use the tool.

Maximum string length: 32

Response

The grant

id
string<uuid>
required
org_mcp_server_id
string<uuid>
required
tool_name
string
required
allowed_to_role
string
required
created_at
string<date-time>
required