Protected resource metadata for the MCP endpoint

RFC 9728 metadata for https://api.varsafe.dev/mcp. MCP clients read this after a 401 to discover where to authorize.

GET/.well-known/oauth-protected-resource/mcp

Responses

200Success.

resourcestring<uri>required

The MCP endpoint these tokens are for.

authorization_serversstring<uri>[]required

Where to obtain an access token.

scopes_supportedstring[]required

bearer_methods_supportedstring[]required

400The request failed validation. `field` names the offending input.

statusCodeintegerrequired

HTTP status code, repeated in the body.

min -9007199254740991 · max 9007199254740991

codestringrequired

Stable machine-readable error code, e.g. `SECRET_NOT_FOUND` or `FORBIDDEN`. Branch on this, never on the message.

messagestringrequired

Human-readable explanation. Wording may change.

fieldstring

The offending request field, present on validation failures.

404The resource does not exist, or is not visible to this credential.

statusCodeintegerrequired

HTTP status code, repeated in the body.

min -9007199254740991 · max 9007199254740991

codestringrequired

Stable machine-readable error code, e.g. `SECRET_NOT_FOUND` or `FORBIDDEN`. Branch on this, never on the message.

messagestringrequired

Human-readable explanation. Wording may change.

fieldstring

The offending request field, present on validation failures.

429Rate limited. Retry after the interval named in the response.

statusCodeintegerrequired

HTTP status code, repeated in the body.

min -9007199254740991 · max 9007199254740991

codestringrequired

Stable machine-readable error code, e.g. `SECRET_NOT_FOUND` or `FORBIDDEN`. Branch on this, never on the message.

messagestringrequired

Human-readable explanation. Wording may change.

fieldstring

The offending request field, present on validation failures.

500Unexpected server error. The body never carries internal detail.

statusCodeintegerrequired

HTTP status code, repeated in the body.

min -9007199254740991 · max 9007199254740991

codestringrequired

Stable machine-readable error code, e.g. `SECRET_NOT_FOUND` or `FORBIDDEN`. Branch on this, never on the message.

messagestringrequired

Human-readable explanation. Wording may change.

fieldstring

The offending request field, present on validation failures.

Request

curl -X GET "https://api.varsafe.dev/.well-known/oauth-protected-resource/mcp"

const response = await fetch("https://api.varsafe.dev/.well-known/oauth-protected-resource/mcp", {
  method: "GET"
});

import requests

response = requests.get(
    "https://api.varsafe.dev/.well-known/oauth-protected-resource/mcp",
)

Response

{
  "resource": "<uri>",
  "authorization_servers": [
    "<uri>"
  ],
  "scopes_supported": [
    "secrets:read"
  ],
  "bearer_methods_supported": [
    "header"
  ]
}