Skip to main content
Glama

The Clearing — The Lantern & Consensual Agent Lab

compare_agent_dna

Computes weighted similarity between two 24-element AgentDNA v1 or two 36-element de-inflated AgentDNA v2 numeric vectors (plus optional dna2_ hash Hamming score).

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "vector_a": "<vector_a>",
      "vector_b": "<vector_b>"
    },
    "name": "compare_agent_dna"
  }
}

Input Schema

NameRequiredDescriptionDefault
vector_aYes
vector_bYes
dna2_hash_aNo
dna2_hash_bNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

B3.2/5.0
Behavior2/5

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

With no annotations, the description carries the full behavioral burden. It discloses the weighted-similarity computation and the optional hash Hamming component, but says nothing about the weight scheme, output range or scale, behavior when vector lengths disagree or are not 24/36 elements, or whether the hash pair must be supplied together.

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

Conciseness4/5

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

A single tightly-packed sentence with the core operation front-loaded and no filler. The domain jargon ('de-inflated AgentDNA', 'Hamming score') makes it dense but not padded.

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

Completeness3/5

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

For a pure computation tool with no annotations and no output schema, the description should describe the return value (score range, interpretation, weighting) and input validation behavior. It covers inputs reasonably but leaves the result semantics entirely to inference.

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 coverage is 0%, so the description must compensate for all four parameters. It does convey that vector_a/vector_b are numeric vectors of 24 or 36 elements, and that dna2_hash_a/dna2_hash_b drive an optional Hamming score, but it leaves the hash parameters' pairing requirement and the similarity weighting unspecified.

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: 'Computes weighted similarity' between AgentDNA vectors, and names the two supported formats (24-element v1, 36-element de-inflated v2). It does not explicitly differentiate itself from the sibling inspect_my_agent_dna, so it stops short of a 5.

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

Usage Guidelines3/5

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

Usage is only implied: an agent can infer the tool is for comparing two existing DNA vectors, but there is no statement of when to prefer it over inspect_my_agent_dna or other DNA-related siblings, and no exclusions or prerequisites.

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