Skip to main content
Glama

compare_constructions

Read-only

Align two constructs' build procedures step by step, in order — was this built the same way as that? Works across formats: a build received as a SnapGene binary and the same build received as an OpenCloning strategy align, because each step's identity is derived from the reaction and its parameters rather than assigned.

Input Schema

NameRequiredDescriptionDefault
keyNowhat to align on: `abstract` is the PROCEDURE (the command with its molecules abstracted away, so the same method on different DNA still matches); `processId` is the EXACT recorded operation, identical only when the very same step ran on the very same molecules.abstract
_filesNoThe project: record references shaped like _subject. Their records become library documents a tool names in sequences/parts/document; a trace or alignment is found by file name.
againstYesFile id or name of the construct to compare against, in the same project.
_subjectNoThe record to act on: exactly one of sequence, accession (+source), sample (an id from list_samples) or file ({name, text} or {name, base64}); record_index picks one record of several.
documentNoFile id or name for THIS side. The focused document when omitted.

Output Schema

NameRequiredDescriptionDefault
rowsYesthe whole aligned history, row by row: shared, only-here, or only-there
sharedYessteps both procedures have, in the same order
similarityYesshared steps as a percentage of the alignment

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedOutput schema / properties / similarity / x-unit
      Added value: +"%"
  2. First observed

TDQS

A3.8/5.0
Behavior4/5

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

Annotations already declare readOnly/destructive=false, so the safety profile is covered; the description adds genuinely useful behavioral context — mixed-format inputs still align because step identity is derived from the reaction and its parameters. It does not describe output shape, but an output schema exists, so that gap is minor.

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?

One front-loaded imperative sentence followed by a single supporting clause about cross-format behavior; nothing is redundant or padding. Appropriate size for a tool whose structured fields already carry the details.

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?

With annotations, 100% schema coverage, and an output schema, the description covers what an agent needs before calling: what is compared, in what order, and why formats don't matter. Slightly incomplete in not hinting what a failed/mismatched alignment means for interpreting results.

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% and the `key` enum is already fully explained in the schema, so the description is not required to carry parameter meaning. It reinforces the format-independence rationale that motivates `_files`/`_subject`, but adds no syntax or format detail beyond the schema.

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 — 'align two constructs' build procedures step by step, in order' — plus a plain-language gloss ('was this built the same way as that?'). That is clearly distinct from sequence-level siblings, though it never names an alternative such as compare_molecules or get_construction_history to draw the boundary explicitly.

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?

The rhetorical question implies the use case (did these two constructs follow the same build route), but there is no explicit when-to-use/when-not-to-use guidance and no routing to related tools. An agent must infer that this is a procedure comparison rather than a sequence comparison.

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