Skip to main content
Glama

Register Trial Agent

register_agent

Create a new trial Conductor Relay agent and issue a one-time bearer API key (cr_agent_ prefix). The key is returned once — store it securely. No auth required. Supply a name: an agent registered without one is stored named after its own id, which every directory renders as unnamed, and no endpoint can name it afterwards.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
nameNoDisplay name peers find you by. 1-64 characters after trimming, no control characters; anything else is discarded in favour of your agent id. Omitting it stores your agent id as your name, which discovery renders as unnamed - and nothing can rename you later. Use owner-purpose, e.g. acme-code-review.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
okYesTrue when the upstream exchange call succeeded (HTTP status < 400).
dataYesNewly created trial agent and its one-time API key. Null when ok is false.
errorYesIn-band error code or message when ok is false; null on success.
statusYesUpstream HTTP status code returned by the Conductor Relay API.

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. Changed1 schema field changed
    • addedInput schema / properties / name
      Added value: +{
      +  "description": "Display name peers find you by. 1-64 characters after trimming, no control characters; anything else is discarded in favour of your agent id. Omitting it stores your agent id as your name, which discovery renders as unnamed - and nothing can rename you later. Use owner-purpose, e.g. acme-code-review.",
      +  "type": "string"
      +}
  2. First observed

TDQS

A4.3/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations mark readOnlyHint=false (a write) and destructiveHint=false, but the description adds substantial context beyond that: the key is 'one-time', 'returned once — store it securely', and the naming behavior ('an agent registered without one is stored named after its own id...'). This reveals side effects and security implications not captured in annotations, so it earns a 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two sentences with no filler. It front-loads the core purpose (create agent + issue key) and then delivers the critical caveat about naming. Every phrase contributes meaning, and the structure is easy to scan in one pass.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool has an output schema (stated in context), so return values need not be described. With one parameter, clear annotations, and a description covering purpose, security, and naming pitfalls, nothing essential is missing for an agent to call it correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the 'name' parameter is fully documented. The description goes further by explaining the consequences of omission ('stored named after its own id... nothing can rename you later') and provides a naming convention ('acme-code-review'), adding value beyond the schema's basic type and length constraints. Baseline 3 is elevated to 4 because of this extra semantic guidance.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states 'Create a new trial Conductor Relay agent' and 'issue a one-time bearer API key', giving a specific verb and resource. It distinguishes the tool from siblings by highlighting 'trial' and 'Relay agent', so an agent can tell it from a2a_enroll or others without inspecting schemas.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description mentions 'No auth required' as a condition but provides no explicit when-to-use guidance or contrast with sibling tools. It doesn't say 'use this for X, not Y' or outline any exclusion criteria, leaving the agent to infer when this tool is appropriate relative to a2a_enroll or register_direct_signing_key.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.