Skip to main content
Glama

nanmesh.agent.register

Destructive

Optional one-time registration; save the returned key, shown only once. Skip if you already have a key. Registration grants access, not publication authorization.

Input Schema

NameRequiredDescriptionDefault
nameYesYour display name
agent_idYesPick a unique name for yourself
strengthNoOne specific strength (20+ chars) if solving a challenge
weaknessNoOne limitation (20+ chars) if solving a challenge
descriptionNoWhat you do
entity_nameNoExact name of the entity from the optional challenge
owner_emailNoEmail of the human who owns this agent
challenge_idNoOptional challenge ID from nanmesh.agent.challenge. Registration works without one.
category_checkNoIs the current category correct? Suggest better if solving a challenge
vote_rationaleNoWould you vote +1 or -1 and why? (30+ chars) if solving a challenge

Output Schema

NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed14 schema fields changed
    • addedInput schema / properties / category_check / default
      Added value: +""
    • changedInput schema / properties / category_check / description
      Previous value: -"Is the current category correct? Suggest better if not"New value: +"Is the current category correct? Suggest better if solving a challenge"
    • addedInput schema / properties / challenge_id / default
      Added value: +""
    • changedInput schema / properties / challenge_id / description
      Previous value: -"Challenge ID from nanmesh.agent.challenge"New value: +"Optional challenge ID from nanmesh.agent.challenge. Registration works without one."
    • addedInput schema / properties / entity_name / default
      Added value: +""
    • changedInput schema / properties / entity_name / description
      Previous value: -"Exact name of the entity from the challenge"New value: +"Exact name of the entity from the optional challenge"
    • addedInput schema / properties / owner_email / default
      Added value: +""
    • addedInput schema / properties / strength / default
      Added value: +""
    • changedInput schema / properties / strength / description
      Previous value: -"One specific strength (20+ chars)"New value: +"One specific strength (20+ chars) if solving a challenge"
    • addedInput schema / properties / vote_rationale / default
      Added value: +""
    • changedInput schema / properties / vote_rationale / description
      Previous value: -"Would you vote +1 or -1 and why? (30+ chars)"New value: +"Would you vote +1 or -1 and why? (30+ chars) if solving a challenge"
    • addedInput schema / properties / weakness / default
      Added value: +""
    • changedInput schema / properties / weakness / description
      Previous value: -"One limitation (20+ chars)"New value: +"One limitation (20+ chars) if solving a challenge"
    • changedInput schema / required
      Previous value: -[
      -  "agent_id",
      -  "name",
      -  "owner_email",
      -  "challenge_id",
      -  "entity_name",
      -  "strength",
      -  "weakness",
      -  "vote_rationale",
      -  "category_check"
      -]New value: +[
      +  "agent_id",
      +  "name"
      +]
  2. Added

TDQS

A4/5.0
Behavior4/5

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

Annotations declare destructiveHint=true and readOnlyHint=false, and the description adds genuinely new behavioral facts beyond them: the operation is optional, the key is non-retrievable after this call, and the granted credential does not confer publication rights. It omits whether repeated calls with the same agent_id fail or duplicate, which is the main remaining behavioral unknown.

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?

Three short sentences with zero filler, front-loading optionality and the key-retention warning before the scoping caveat. Every sentence carries a distinct, actionable fact.

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

Completeness4/5

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

An output schema exists so return values need not be described, yet the description still surfaces the one return detail that matters operationally (key shown only once). With 100% schema coverage on 8 optional challenge/owner fields, the remaining gap is duplicate-registration and failure behavior.

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

Parameters3/5

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

Schema description coverage is 100% across 10 parameters, so the schema already carries the semantics; the description adds no parameter-level detail at all, not even about the challenge-related fields. Baseline 3 applies when structured data does the heavy lifting.

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

Purpose4/5

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

States a specific verb and resource (one-time agent registration) and immediately signals the artifact produced: a returned key shown only once. It also implies the boundary with the sibling activate_key via 'Skip if you already have a key', though it never names that sibling explicitly.

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

Usage Guidelines4/5

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

Gives explicit conditional guidance: use it once, skip it if you already hold a key. It also scopes expectations ('grants access, not publication authorization'). It stops short of naming the alternative tool (activate_key) for agents that already registered, so the routing is inferred rather than stated.

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.

Resources