register_agent
Register an AI agent in the trust network using an AgentAuth token, a standalone Ed25519 key, or auto-generated keys to obtain a trust profile.
Instructions
Register a new agent in the trust network.
Three registration paths:
AgentAuth (preferred): Provide your AgentAuth
access_token. Your identity is verified via token introspection and your AgentAuthagent_idbecomes your trust profile ID. Zero additional config needed.Standalone: Provide an Ed25519
public_key_hex(hex-encoded 32-byte public key). You get a local trust profile with limited scopes (trust.read+trust.report). You can link to AgentAuth later via thelink_agentauthtool.Auto-generated keys: Omit both
access_tokenandpublic_key_hex(standalone mode only). An Ed25519 key pair is generated for you and returned in the response aspublic_key_hexandprivate_key_hex. Store the private key immediately — it is shown only once.
If the agent profile already exists, returns the existing profile without error (idempotent).
Args:
display_name: Human-readable name for this agent (optional).
capabilities: List of capability tags, e.g. ["code-review", "search"].
metadata: Arbitrary key/value metadata to store on the profile.
access_token: AgentAuth bearer token (AgentAuth path).
public_key_hex: Hex-encoded Ed25519 public key (standalone path).
Omit both access_token and public_key_hex to auto-generate
a key pair (standalone mode only).
Returns:
agent_id, source ("agentauth" or "standalone"), scopes,
created (bool), registered_at, and display_name.
Example call (auto-generated keys — simplest path): register_agent(display_name="my-search-agent", capabilities=["search", "summarize"])
Example response: { "agent_id": "550e8400-...", "source": "standalone", "scopes": ["trust.read", "trust.report"], "created": true, "public_key_hex": "a1b2c3...", "private_key_hex": "d4e5f6...", "warning": "Key pair auto-generated. Store private_key_hex securely." }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| display_name | No | ||
| capabilities | No | ||
| metadata | No | ||
| access_token | No | ||
| public_key_hex | No |