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
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | yes | Grant 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
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | yes | Request 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
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | yes | Request id |
Request body: handler.MCPOAuthApproveRequest
| Name | Type | Required | Description |
|---|---|---|---|
| orgId | integer | no | |
| projectIds | integer[] | no | ProjectIDs empty means every project the person reaches in the org, including ones created later. |
| scopes | domain.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
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | yes | Request id |
Responses
- 200 OK · object
- 401 Unauthorized · apimodel.ErrorEnvelope
- 404 Not Found · apimodel.ErrorEnvelope
- 409 Conflict · apimodel.ErrorEnvelope