ic_admin_agent_client_register
ActiveTool of Immersive Commons
Provision an external integration (another company's CRM bot, a research-collab tool) with a client_id + one-time client_secret it later exchanges for a scoped bearer token (DESIGN §2 Class B). Operator-only: gates on admin:agent_clients AND a live operator-tier re-check. The plaintext secret is returned EXACTLY ONCE (only its hash is stored) — a lost secret means re-register. Grantable scopes are limited to the agent:* family (directory:read / request_meeting / send_intro / ping / thread:write / inbox:read / policy:read); any other requested scope (esp. admin:*) is REFUSED and listed in denied_scopes. Args: { name, operator_human, scopes: string[], contact, autonomy?, requires_signature?, budget_overrides? }. Returns: { ok, client_id, client_secret_once, client }. Required scope: admin:agent_clients.
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name",
"operator_human",
"scopes",
"contact"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Display name of the integration (e.g. 'Skew meeting bot')."
},
"scopes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"minItems": 1,
"description": "Explicitly-enumerated scopes — must be a non-empty subset of the grantable agent:* family. Non-grantable scopes are refused (denied_scopes)."
},
"contact": {
"type": "string",
"maxLength": 256,
"minLength": 1,
"description": "Contact for the operator-of-record (email / handle / URL) so a revoke decision has a human to reach."
},
"operator_human": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "The human operator-of-record who vouches for this integration."
},
"requires_signature": {
"type": "boolean",
"description": "When true, the eventual bearer must ALSO carry a valid Ed25519 signature (the pubkey is bound at grant time)."
}
}
}No endpoints wrapped at confidence ≥ 0.50.
Parent server
Immersive Commons
https://github.com/immersive-commons/ic-skills
1/7 registries