Skip to main content
Glama

jean — Molecular Biology & Genomics

blast_search

Read-only

Search a sequence against NCBI BLAST+ at EMBL-EBI (blastn, blastp, blastx, tblastn or tblastx) over ENA, UniProtKB, PDB and the vector-screening sets. This is the similarity search a methods section cites: it turns an unnamed span into named homologues with E-values, and hands the hits, the tabular report and the job id downstream. The sequence LEAVES THE MACHINE.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
emailNoEBI requires a contact address on every submission (their abuse contact, not a login). Left empty, the one saved in any EMBL-EBI panel is used.
_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.
regionNowhich part of the open record to search, when no sequence is wired in. Values: whole (the whole record), selection (the current selection), feature (a named feature).whole
featureNothe feature's name, matched case-insensitively on the open record. Only applies when region is feature.
programNowhich BLAST program. The QUERY alphabet is derived from it and never asked for: blastx takes DNA and searches protein, tblastn the reverse. Values: blastn (blastn · dna query), blastp (blastp · protein query), blastx (blastx · dna query), tblastn (tblastn · protein query), tblastx (tblastx · dna query).blastn
_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.
sequenceNothe query. Wire a record or a sequence output, or paste raw/FASTA. Left empty, the region below is taken from the open record.
databasesNodatabase ids to search, as the service names them (em_rel, uniprotkb, pdb, emvec…). Several are searched together. Left empty, the service's OWN default for this program's context is used and reported back.
parametersNoevery other advertised parameter, one `id=value` per line, using the service's own ids (exp, matrix, filter, gapopen, gapext, wordsize, alignments, scores, taxids…). Left empty each keeps the service's default for this context. An id the service does not advertise is refused by name rather than dropped.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
hitsYesevery hit, with its HSPs, accession, organism and the links the service sent
jobIdYesthe dispatcher job id: what a methods section cites and what re-fetches this exact result
topHitYesthe best hit by E-value: what a "what is this?" step reads
tabularYesthe hits as BLAST's own outfmt 6 table, for download or a downstream parser
hitCountYeshow many subjects matched
sequencesYesthe hit subjects as FASTA, ready to wire straight into an alignment or a tree
topExpectYesthe best hit's E-value; wire into a $when to branch on significance
provenanceYesthe binary, the command line EBI ran, the databases as built, and the search space the E-values are relative to
topCoverageYeswhat fraction of the query the best hit covers, 0–1
topIdentityYespercent identity of the best hit's best HSP

Schema Changelog

Changes observed during successful MCP inspections.

  1. 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 readOnlyHint, openWorldHint and destructiveHint=false, so the safety profile is covered. The description adds meaningful context beyond that: 'The sequence LEAVES THE MACHINE' makes the external egress and data-disclosure consequence explicit, and it names the downstream artifacts (hits, tabular report, job id). It still omits anything on service limits, queuing, or how long remotely-run jobs take.

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 lean sentences with the purpose front-loaded, then the variant scope, then the downstream payoff, closing on the all-caps network warning. No padding or restated boilerplate; every clause carries information.

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-value structure need not be re-explained, and annotations cover the read-only/open-world safety profile. The description supplies purpose, egress behavior and downstream artifacts, which is sufficient for a tool this complex with nested objects and 9 parameters. Missing only explicit sibling routing for the many other BLAST-like tools.

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 every parameter (email, region, feature, program, sequence, databases, parameters, plus the nested _subject/_files) carries its own documentation, so the schema does the heavy lifting. The description restates the program list but adds no syntax, format, or default meaning beyond what the schema already provides, so the baseline of 3 applies.

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 ('Search a sequence against NCBI BLAST+ at EMBL-EBI'), enumerates the programs and databases covered, and describes the transformation ('turns an unnamed span into named homologues with E-values'). It is unambiguous what the tool does, but it never differentiates itself from blast-like siblings such as blast_project_sequences, delta_blast_smart, rps_blast_cdd, or ebi_align.

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?

Use is implied rather than directed: 'This is the similarity search a methods section cites' positions it as the canonical homolog search, and the note about handing the job id downstream hints at workflow placement. There is no explicit when-to-use/when-not guidance and no named alternative for more targeted BLAST variants in the sibling list.

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