Skip to main content
PUT
/
serverconfig
/
mcp-auth
Update MCP OAuth 2.1 Resource Server Configuration
curl --request PUT \
  --url https://use.hoop.dev/api/serverconfig/mcp-auth \
  --header 'Content-Type: application/json' \
  --data '
{
  "enabled": true,
  "groups_claim": "groups",
  "resource_uri": "https://use.hoop.dev/mcp"
}
'
{
  "enabled": true,
  "groups_claim": "groups",
  "resource_uri": "https://use.hoop.dev/mcp"
}

Documentation Index

Fetch the complete documentation index at: https://mintlify.hoop.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

Body

application/json

The request body resource

​
enabled
boolean

Whether the /mcp endpoint accepts IdP-issued OAuth 2.1 JWTs in addition to Hoop-issued bearer tokens.

​
groups_claim
string

JWT claim name from which user groups are extracted. Defaults to "groups".

Example:

"groups"

​
resource_uri
string

Canonical resource URI used for RFC 8707 audience binding. Defaults to "<API_URL>/mcp" when empty. Must match the aud claim of inbound JWTs.

Example:

"https://use.hoop.dev/mcp"

Response

OK

​
enabled
boolean

Whether the /mcp endpoint accepts IdP-issued OAuth 2.1 JWTs in addition to Hoop-issued bearer tokens.

​
groups_claim
string

JWT claim name from which user groups are extracted. Defaults to "groups".

Example:

"groups"

​
resource_uri
string

Canonical resource URI used for RFC 8707 audience binding. Defaults to "<API_URL>/mcp" when empty. Must match the aud claim of inbound JWTs.

Example:

"https://use.hoop.dev/mcp"