Skip to main content
Glama

Jean — Molecular Biology & Genomics

copy_number_mosaicism

Read-only

Estimate which mosaic fraction class each region of one chromosome is closest to, as Affymetrix Power Tools computes it.

Input Schema

NameRequiredDescriptionDefault
fileNowhich copy-number file in this project, by name. Unset, it is the project's only one — and it refuses rather than guessing when there is more than one.
graphNowhich graph column to read. Unset is the first log2-ratio column, the same rule copy_number_segment applies. A column that is not a log2 ratio is refused rather than smoothed: a copy-number STATE column is already someone's answer.
_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.
_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.
data_setNowhich data set to read, by name. Unset is the file's FIRST, which is what the panel opens on.
chromosomeNowhich chromosome, as the file numbers them (1-22, then 23=X, 24=Y, 25=MT — the file's own convention). Unset is the first the index carries. A chromosome too short for the method is refused with the count it has and the ones that would run.
mosaic_bandwidthNothe smoothing window in markers — APT's own `marker-bandwidth`. A mosaic event is a shallow wide elevation, so this is what decides how wide 'wide' is. The default is the vendor's shipped value.
mosaic_confidence_windowNothe running-median window used to score a segment, in markers — APT's own `confidence-window`. The default is the vendor's shipped value.

Output Schema

NameRequiredDescriptionDefault
calledYesthe subset of segments with call === 1 — the mosaic events themselves, separated out so a pipeline does not have to know the vendor’s clonal test to find them
summaryYeshow many segments the method produced, how many of them it CALLED as mosaic, which classes they fall in, and which chromosome and column answered
segmentsYesevery segment: startPosition and endPosition in bases, startIndex and endIndex in markers, mixture (the class as APT numbers it), mixtureValue (the fraction that class is NAMED for — a label, not a measurement), confidence, and call, which is 1 only for a segment the method calls mosaic. A reader looking for mosaic events wants call === 1
provenanceYeswhich file, data set, chromosome and column answered, how many markers were read, the windows and the eight class boundaries the run used, and the sentence this estimate must be presented with — verbatim from the engine, never paraphrased

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

B3.3/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=true, destructiveHint=false and openWorldHint=false, so safety is covered. The description adds that this is a vendor-algorithm (APT) reimplementation and that output is a class assignment ('closest to'), which is useful behavioral context, but it says nothing about cost, runtime, or what happens when the method cannot run.

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?

A single front-loaded sentence that identifies the operation, the scope (one chromosome), and the reference implementation. Nothing is redundant and nothing needs to be skimmed past.

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?

The tool has 8 parameters including nested _subject/_files objects, but an output schema exists and schema coverage is complete, so the description need not explain returns or defaults. What remains missing is the workflow context — that it operates on a project copy-number file and complements segmentation — leaving the agent to infer positioning.

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 schema itself carries rich prose on file, graph, chromosome, and the two bandwidth/window parameters. The description adds essentially no parameter-level meaning beyond implying that a single chromosome is analysed; baseline 3 applies when the schema 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?

The description states a specific verb ('Estimate') and a precise resource ('which mosaic fraction class each region of one chromosome is closest to'), and anchors the semantics to Affymetrix Power Tools. That is enough to distinguish it from copy_number_segment or copy_number_loh, though it never names those siblings explicitly.

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?

There is no when-to-use guidance, no exclusion of alternatives, and no stated prerequisites. The agent learns what the tool does but not when to reach for it instead of copy_number_segment, copy_number_regions, or copy_number_somatic; the mention of copy_number_segment's column rule lives in the schema, not the description.

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