scan_motif_sites
Find every place a transcription-factor binding motif (a position-frequency matrix, such as a JASPAR matrix's counts) matches a DNA sequence, on both strands, at a threshold set per motif as a fraction of that matrix's own score range.
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": {
"motifs": "<motifs>"
},
"name": "scan_motif_sites"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| _files | No | The 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. | |
| motifs | Yes | the matrices, each {name, counts: {A, C, G, T} per position, relativeThreshold (0-1 of the matrix's score range) or threshold (absolute log-odds)}. Pseudocounts are JASPAR's sqrt(N) by default. | |
| _subject | No | The 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. | |
| sequence | No | the DNA to scan - leave unset to use the open record. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | how many matches in total | |
| sites | Yes | every match, by position: motif name, start and end (0-based, end exclusive), strand, log-odds score and its fraction of the matrix's range | |
| perMotif | Yes | the number of matches for each motif, by name |