Skip to content

Register a public client of the remote MCP server

POST
/oauth/register
curl --request POST \
--url https://beta-api.plune.ai/oauth/register \
--header 'Content-Type: application/json' \
--data '{ "client_name": "Assistant", "redirect_uris": [ "https://assistant.example/callback" ] }'

RFC 7591, for a client that has no metadata document. Public clients only: no secret is issued. Each of the one to ten redirect_uris is https, or http on localhost, 127.0.0.1 or [::1], without a fragment. The name is what the client says of itself and proves nothing: the consent screen shows the host of the return address beside it. 20 registrations in 15 minutes from one client address. Mounted only where the remote MCP server is switched on (MCP_PUBLIC_URL); elsewhere 404.

Media type application/json
object
redirect_uris
required
Array<string>
client_name
string
token_endpoint_auth_method
string
Allowed values: none
Example
{
"client_name": "Assistant",
"redirect_uris": [
"https://assistant.example/callback"
]
}

The client

Media type application/json
object
client_id
required
string
client_name
string
redirect_uris
required
Array<string>
token_endpoint_auth_method
string
grant_types
Array<string>
response_types
Array<string>
client_id_issued_at
integer
Example
{
"client_id": "6f1d1c0e-8a57-4a37-9c0b-2f4f3c1d9a10",
"client_name": "Assistant",
"redirect_uris": [
"https://assistant.example/callback"
],
"token_endpoint_auth_method": "none",
"grant_types": [
"authorization_code",
"refresh_token"
],
"response_types": [
"code"
],
"client_id_issued_at": 1795168800
}

invalid_redirect_uri or invalid_client_metadata

Media type application/json
object
error
required
string
error_description
string
Example
{
"error": "invalid_redirect_uri",
"error_description": "redirect_uris: one to ten addresses, each https or http on localhost, without a fragment"
}

Rate-limited: the per-route throttle, or the per-minute request limit of the plan an API token counts by (#1442; the body names the plan, #2092). Retry-After carries the seconds until the window rolls over.

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}
Retry-After
integer

Seconds until the window rolls over