auth_service.proto

path agntcy/identity/service/v1alpha1/auth_service.proto

package agntcy.identity.service.v1alpha1

---

Messages

AppInfoResponse

Name	Type	Description
app	App	The App information.

ApproveTokenRequest

Name	Type	Description
device_id	string	The device id used to handle the approval requestion
session_id	string	The session id related to the token that needs to be approved
otp	string	The OTP sent to the device related to the request
approve	bool	The action made by the user (true: allow the token, false: deny the token)

AuthorizeRequest

Name	Type	Description
resolver_metadata_id	optional string	The resolver metadata id for which authorization is requested.
tool_name	optional string	The MCP Server tool name.
user_token	optional string	The User context in the form of an id or access token. Mandatory for User Approval Flows.

AuthorizeResponse

Name	Type	Description
authorization_code	string	If authorization is successful, return a code to be used for the token endpoint.

ExtAuthzRequest

Name	Type	Description
access_token	string	The access token to be authorized.
tool_name	optional string	The tool name that will be invoked

TokenRequest

Name	Type	Description
authorization_code	string	Pass the code received from the authorization endpoint.

TokenResponse

Name	Type	Description
access_token	string	The access token issued to the Agent or MCP Server.

---

Services

AuthService

AuthService manages auth.

AppInfo

Method	AppInfo
Request	Empty
Response	AppInfoResponse
Description	App info endpoint

Authorize

Method	Authorize
Request	AuthorizeRequest
Response	AuthorizeResponse
Description	Authorize a request from an Agent or MCP Server

Token

Method	Token
Request	TokenRequest
Response	TokenResponse
Description	Request token for an Agent or MCP Server

ExtAuthz

Method	ExtAuthz
Request	ExtAuthzRequest
Response	Empty
Description	Handle external authorization requests

ApproveToken

Method	ApproveToken
Request	ApproveTokenRequest
Response	Empty
Description	Handle manual approval of external authorization requets

---