Skip to content

All resources

mcp-oauth

5 endpoints

get /oauth/grants

List the apps connected to my account through MCP OAuth

Requires authentication

The caller's live MCP OAuth grants, newest first: which client, which organization, what it may do and when it last called. Keys created by hand are not listed here; they are on the API token routes.

Responses

  • 200 OK · object
  • 401 Unauthorized · apimodel.ErrorEnvelope

delete /oauth/grants/{id}

Revoke an app connected through MCP OAuth

Requires authentication

Ends the grant at once: its access token stops authenticating on the next call and its refresh token no longer redeems. Only the grant's owner can revoke it.

Parameters

NameInTypeRequiredDescription
idpathstringyesGrant id

Responses

  • 200 OK · object
  • 401 Unauthorized · apimodel.ErrorEnvelope
  • 404 Not Found · apimodel.ErrorEnvelope

get /oauth/requests/{id}

Read a pending MCP authorization request

Requires authentication

What the consent screen shows before a person approves a client's request to use their BugBoard through MCP: who is asking (the name it gave itself and, for a client that identifies itself by URL, the host that URL is on), where the browser goes afterwards, whether that is only the person's own machine, and the most they can grant. Session-authenticated; the request id is a 256-bit value from the consent URL.

Parameters

NameInTypeRequiredDescription
idpathstringyesRequest id

Responses

  • 200 OK · object
  • 401 Unauthorized · apimodel.ErrorEnvelope
  • 404 Not Found · apimodel.ErrorEnvelope
  • 409 Conflict · apimodel.ErrorEnvelope

post /oauth/requests/{id}/approve

Approve an MCP authorization request

Requires authentication

Records the signed-in person's decision: the organization, the scopes (at most what the client asked for) and the projects (none listed means every project they reach in the organization, including future ones) the client may use. Returns the client's redirect URL carrying the one-time authorization code. The grant narrows what the person can do and never adds to it.

Parameters

NameInTypeRequiredDescription
idpathstringyesRequest id

Request body: handler.MCPOAuthApproveRequest

NameTypeRequiredDescription
orgIdintegerno
projectIdsinteger[]noProjectIDs empty means every project the person reaches in the org, including ones created later.
scopesdomain.Action[]no

Responses

  • 200 OK · object
  • 400 Bad Request · apimodel.ErrorEnvelope
  • 401 Unauthorized · apimodel.ErrorEnvelope
  • 403 Forbidden · apimodel.ErrorEnvelope
  • 404 Not Found · apimodel.ErrorEnvelope
  • 409 Conflict · apimodel.ErrorEnvelope

post /oauth/requests/{id}/deny

Deny an MCP authorization request

Requires authentication

Records a refusal and returns the client's redirect URL carrying access_denied, so the person can end a request they did not start immediately.

Parameters

NameInTypeRequiredDescription
idpathstringyesRequest id

Responses

  • 200 OK · object
  • 401 Unauthorized · apimodel.ErrorEnvelope
  • 404 Not Found · apimodel.ErrorEnvelope
  • 409 Conflict · apimodel.ErrorEnvelope