Skip to main content

Oauth Connections

MCP tools for the Oauth Connections module. See the Oauth Connections module docs for permissions and data model.

list-oauth-connections​

List OAuth connections

Arguments​

ArgumentTypeRequiredDescription
project_idstringnoProject ID (required if not using project key auth)
actor_idstringnoOnly this actor's connections
oauth_client_idstringnoOnly connections through this OAuth client
limitnumbernoResults per page. Above the maximum it is clamped; below 1 or not an integer it is 400 VALIDATION_FAILED.
cursorstringnoThe previous page's next_cursor; omit it for the first page. Send it with the same filters as the request that returned it: a malformed cursor, or one sent with other filters, is 400 INVALID_CURSOR.

create-oauth-connection​

Start an OAuth connection

Arguments​

ArgumentTypeRequiredDescription
oauth_client_idstringyesThe OAuth client to connect through.
actor_idstringyesThe actor the grant is for.
return_urlstringnoWhere the callback redirects the person's browser when it completes, with oauth_connection_id and status (connected or failed) added to its query.

complete-oauth-connection​

Complete an OAuth connection

Arguments​

ArgumentTypeRequiredDescription
statestringnoThe state of the authorize URL
codestringnoThe authorization code
errorstringnoThe provider's refusal, such as access_denied
error_descriptionstringnoThe provider's refusal, in words
error_uristringnoSent by some providers with a refusal; ignored
scopestringnoSent by some providers; ignored
issstringnoSent by some providers (RFC 9207); ignored

get-oauth-connection​

Get an OAuth connection

Arguments​

ArgumentTypeRequiredDescription
oauth_connection_idstringyesOAuth connection ID

delete-oauth-connection​

Delete an OAuth connection

Arguments​

ArgumentTypeRequiredDescription
oauth_connection_idstringyesOAuth connection ID