PhageAgent MCP: PhageScope phage database and analysis tasks. Sign up at phageagent.deepomics.org.
Maintained by@yiyabo(verified)Also a maintainer?
Call this server's tools from your browser. Nothing to install.
Bearer <PhageAgent MCP token (gpsk_...)>
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Count phages grouped by 1-3 dimensions (dataset, lifestyle, host rank...), optionally filtered.
Dimension, or list of dimensions, to group counts by (see the query-guide resource).
Maximum number of groups to return.
Phage cohort filters; all given filters are combined with AND.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http phageagent https://phageagent.deepomics.org/mcp \ --header 'Authorization: Bearer YOUR_TOKEN'
Headers
Authorization (required): Bearer <PhageAgent MCP token (gpsk_...)>Count phages grouped by 1-3 dimensions (dataset, lifestyle, host rank...), optionally filtered.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of groups to return. |
| filters | object | Phage cohort filters; all given filters are combined with AND. |
| group_by* | any | Dimension, or list of dimensions, to group counts by (see the query-guide resource). |
{
"type": "object",
"required": [
"group_by"
],
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1,
"description": "Maximum number of groups to return."
},
"filters": {
"type": "object",
"properties": {
"host": {
"type": "string",
"description": "Host name, e.g. Salmonella or Escherichia coli."
},
"gc_max": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Maximum GC content in percent."
},
"gc_min": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Minimum GC content in percent."
},
"is_rep": {
"type": "boolean",
"description": "Only cluster representatives."
},
"cluster": {
"type": "string",
"description": "Phage cluster id."
},
"dataset": {
"type": "string",
"description": "Source dataset name, e.g. RefSeq, GenBank, MGV (see catalog_overview)."
},
"amr_free": {
"type": "boolean",
"description": "No annotated antimicrobial-resistance genes (columnar layer)."
},
"datasets": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 30,
"description": "Only these source datasets."
},
"min_trna": {
"type": "integer",
"minimum": 0,
"description": "Minimum number of annotated tRNAs."
},
"taxonomy": {
"type": "string",
"description": "Phage taxonomy name."
},
"accession": {
"type": "string",
"description": "Exact phage accession."
},
"host_name": {
"type": "string",
"description": "Host name at the given host_rank."
},
"host_rank": {
"type": "string",
"description": "Host rank used with host_name, e.g. genus or species."
},
"is_mapped": {
"type": "boolean",
"description": "Filter on the data service's is_mapped flag."
},
"lifestyle": {
"type": "string",
"description": "Predicted lifestyle, e.g. virulent or temperate."
},
"phage_ids": {
"type": "array",
"items": {
"type": "integer"
},
"maxItems": 200,
"description": "PhageScope numeric phage ids."
},
"accessions": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 200,
"description": "Exact phage accessions."
},
"has_crispr": {
"type": "boolean",
"description": "Has annotated CRISPR arrays."
},
"host_match": {
"type": "string",
"description": "How to match host (service default when omitted)."
},
"length_max": {
"type": "integer",
"minimum": 0,
"description": "Maximum genome length in bp."
},
"length_min": {
"type": "integer",
"minimum": 0,
"description": "Minimum genome length in bp."
},
"subcluster": {
"type": "string",
"description": "Phage subcluster id."
},
"completeness": {
"type": "string",
"description": "Genome completeness label, e.g. Complete, High-quality."
},
"has_anticrispr": {
"type": "boolean",
"description": "Has annotated anti-CRISPR proteins."
},
"taxonomy_match": {
"type": "string",
"description": "How to match taxonomy (service default when omitted)."
},
"virulence_free": {
"type": "boolean",
"description": "No annotated virulence factors (columnar layer)."
}
},
"description": "Phage cohort filters; all given filters are combined with AND.",
"additionalProperties": false
},
"group_by": {
"oneOf": [
{
"enum": [
"dataset",
"completeness",
"lifestyle",
"taxonomy",
"cluster",
"host_phylum",
"host_class",
"host_order",
"host_family",
"host_genus",
"host_species"
],
"type": "string"
},
{
"type": "array",
"items": {
"enum": [
"dataset",
"completeness",
"lifestyle",
"taxonomy",
"cluster",
"host_phylum",
"host_class",
"host_order",
"host_family",
"host_genus",
"host_species"
],
"type": "string"
},
"maxItems": 3,
"minItems": 1
}
],
"description": "Dimension, or list of dimensions, to group counts by (see the query-guide resource)."
}
},
"additionalProperties": false
}Stop a working task. Deliverables already published stay available.
| Argument | Type | Description |
|---|---|---|
| task_id* | string | The task_id returned by submit_analysis. |
{
"type": "object",
"required": [
"task_id"
],
"properties": {
"task_id": {
"type": "string",
"description": "The task_id returned by submit_analysis."
}
},
"additionalProperties": false
}Catalog-wide counts (phages, proteins, families, datasets) and the dataset list. Start here.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Summarise a filtered phage cohort: size, composition breakdowns and a few sample rows.
| Argument | Type | Description |
|---|---|---|
| filters* | object | Phage cohort filters; all given filters are combined with AND. |
| sort_by | string | Row order: id, length_desc or length_asc. |
| sample_limit | integer | How many example phages to include in the report. |
{
"type": "object",
"required": [
"filters"
],
"properties": {
"filters": {
"type": "object",
"properties": {
"host": {
"type": "string",
"description": "Host name, e.g. Salmonella or Escherichia coli."
},
"gc_max": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Maximum GC content in percent."
},
"gc_min": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Minimum GC content in percent."
},
"is_rep": {
"type": "boolean",
"description": "Only cluster representatives."
},
"cluster": {
"type": "string",
"description": "Phage cluster id."
},
"dataset": {
"type": "string",
"description": "Source dataset name, e.g. RefSeq, GenBank, MGV (see catalog_overview)."
},
"amr_free": {
"type": "boolean",
"description": "No annotated antimicrobial-resistance genes (columnar layer)."
},
"datasets": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 30,
"description": "Only these source datasets."
},
"min_trna": {
"type": "integer",
"minimum": 0,
"description": "Minimum number of annotated tRNAs."
},
"taxonomy": {
"type": "string",
"description": "Phage taxonomy name."
},
"accession": {
"type": "string",
"description": "Exact phage accession."
},
"host_name": {
"type": "string",
"description": "Host name at the given host_rank."
},
"host_rank": {
"type": "string",
"description": "Host rank used with host_name, e.g. genus or species."
},
"is_mapped": {
"type": "boolean",
"description": "Filter on the data service's is_mapped flag."
},
"lifestyle": {
"type": "string",
"description": "Predicted lifestyle, e.g. virulent or temperate."
},
"phage_ids": {
"type": "array",
"items": {
"type": "integer"
},
"maxItems": 200,
"description": "PhageScope numeric phage ids."
},
"accessions": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 200,
"description": "Exact phage accessions."
},
"has_crispr": {
"type": "boolean",
"description": "Has annotated CRISPR arrays."
},
"host_match": {
"type": "string",
"description": "How to match host (service default when omitted)."
},
"length_max": {
"type": "integer",
"minimum": 0,
"description": "Maximum genome length in bp."
},
"length_min": {
"type": "integer",
"minimum": 0,
"description": "Minimum genome length in bp."
},
"subcluster": {
"type": "string",
"description": "Phage subcluster id."
},
"completeness": {
"type": "string",
"description": "Genome completeness label, e.g. Complete, High-quality."
},
"has_anticrispr": {
"type": "boolean",
"description": "Has annotated anti-CRISPR proteins."
},
"taxonomy_match": {
"type": "string",
"description": "How to match taxonomy (service default when omitted)."
},
"virulence_free": {
"type": "boolean",
"description": "No annotated virulence factors (columnar layer)."
}
},
"description": "Phage cohort filters; all given filters are combined with AND.",
"additionalProperties": false
},
"sort_by": {
"enum": [
"id",
"length_desc",
"length_asc"
],
"type": "string",
"default": "id",
"description": "Row order: id, length_desc or length_asc."
},
"sample_limit": {
"type": "integer",
"default": 5,
"maximum": 20,
"minimum": 1,
"description": "How many example phages to include in the report."
}
},
"additionalProperties": false
}Member proteins of one family (optionally one subfamily or dataset). Paged.
| Argument | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. |
| dataset | string | Source dataset name, e.g. RefSeq or GenBank (see catalog_overview). |
| pagesize | integer | Rows per page. |
| family_id* | string | Protein family id. |
| subfamily_id | string | Subfamily id within the family. |
| include_sequence | boolean | Include amino-acid sequences in each row. |
{
"type": "object",
"required": [
"family_id"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "Page number, starting at 1."
},
"dataset": {
"type": "string",
"description": "Source dataset name, e.g. RefSeq or GenBank (see catalog_overview)."
},
"pagesize": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1,
"description": "Rows per page."
},
"family_id": {
"type": "string",
"description": "Protein family id."
},
"subfamily_id": {
"type": "string",
"description": "Subfamily id within the family."
},
"include_sequence": {
"type": "boolean",
"default": false,
"description": "Include amino-acid sequences in each row."
}
},
"additionalProperties": false
}Summary, deliverables (with short-lived download links) and provenance of a finished task.
| Argument | Type | Description |
|---|---|---|
| task_id* | string | The task_id returned by submit_analysis. |
{
"type": "object",
"required": [
"task_id"
],
"properties": {
"task_id": {
"type": "string",
"description": "The task_id returned by submit_analysis."
}
},
"additionalProperties": false
}Status of a task: working, completed, failed or cancelled, with recent progress and when to poll again.
| Argument | Type | Description |
|---|---|---|
| task_id* | string | The task_id returned by submit_analysis. |
{
"type": "object",
"required": [
"task_id"
],
"properties": {
"task_id": {
"type": "string",
"description": "The task_id returned by submit_analysis."
}
},
"additionalProperties": false
}Full metadata for one phage: taxonomy, host lineage, lifestyle, quality, cluster, dataset.
| Argument | Type | Description |
|---|---|---|
| phage_id | integer | PhageScope numeric phage id. |
| accession | string | Phage accession; used when phage_id is omitted. |
{
"type": "object",
"properties": {
"phage_id": {
"type": "integer",
"minimum": 1,
"description": "PhageScope numeric phage id."
},
"accession": {
"type": "string",
"description": "Phage accession; used when phage_id is omitted."
}
},
"additionalProperties": false
}Genome nucleotide sequence of one phage, capped at max_bases.
| Argument | Type | Description |
|---|---|---|
| phage_id | integer | PhageScope numeric phage id. |
| accession | string | Phage accession; used when phage_id is omitted. |
| max_bases | integer | Maximum number of sequence bases to return. |
{
"type": "object",
"properties": {
"phage_id": {
"type": "integer",
"minimum": 1,
"description": "PhageScope numeric phage id."
},
"accession": {
"type": "string",
"description": "Phage accession; used when phage_id is omitted."
},
"max_bases": {
"type": "integer",
"default": 20000,
"maximum": 200000,
"minimum": 100,
"description": "Maximum number of sequence bases to return."
}
},
"additionalProperties": false
}Status and paged hits of a similarity_search by its search_id (kept 7 days).
| Argument | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. |
| pagesize | integer | Rows per page. |
| search_id* | string | The search_id returned by similarity_search. |
{
"type": "object",
"required": [
"search_id"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "Page number, starting at 1."
},
"pagesize": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1,
"description": "Rows per page."
},
"search_id": {
"type": "string",
"pattern": "^sim_[0-9a-f]{32}$",
"description": "The search_id returned by similarity_search."
}
},
"additionalProperties": false
}Resolve predicted (ESMFold) structure availability and links for protein ids.
| Argument | Type | Description |
|---|---|---|
| protein_ids* | array | Exact PhageScope protein ids. |
{
"type": "object",
"required": [
"protein_ids"
],
"properties": {
"protein_ids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50,
"minItems": 1,
"description": "Exact PhageScope protein ids."
}
},
"additionalProperties": false
}This token's recent analysis tasks, newest first.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of tasks to return. |
| status | string | Only tasks in this status. |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Maximum number of tasks to return."
},
"status": {
"enum": [
"working",
"completed",
"failed",
"cancelled"
],
"type": "string",
"description": "Only tasks in this status."
}
},
"additionalProperties": false
}Annotated features of one type (tRNA, CRISPR, anti-CRISPR, terminator, virulence, AMR, transmembrane).
| Argument | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. |
| dataset | string | Source dataset name, e.g. RefSeq or GenBank (see catalog_overview). |
| keyword | string | Case-insensitive text to match in the annotations. |
| pagesize | integer | Rows per page. |
| phage_id | integer | PhageScope numeric phage id. |
| accession | string | Phage accession; used when phage_id is omitted. |
| feature_type* | string | Feature layer to query. |
{
"type": "object",
"required": [
"feature_type"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "Page number, starting at 1."
},
"dataset": {
"type": "string",
"description": "Source dataset name, e.g. RefSeq or GenBank (see catalog_overview)."
},
"keyword": {
"type": "string",
"description": "Case-insensitive text to match in the annotations."
},
"pagesize": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1,
"description": "Rows per page."
},
"phage_id": {
"type": "integer",
"minimum": 1,
"description": "PhageScope numeric phage id."
},
"accession": {
"type": "string",
"description": "Phage accession; used when phage_id is omitted."
},
"feature_type": {
"enum": [
"trna",
"crispr",
"anticrispr",
"terminator",
"virulence",
"amr",
"transmembrane"
],
"type": "string",
"description": "Feature layer to query."
}
},
"additionalProperties": false
}Send a follow-up instruction to a finished, failed or cancelled task; GAgent continues in the same session with its earlier context and files. Poll get_analysis_status again afterwards.
| Argument | Type | Description |
|---|---|---|
| message* | string | Follow-up message for the task, e.g. an answer to its question or a new instruction. |
| task_id* | string | The task_id returned by submit_analysis. |
| idempotency_key | string | Optional client key; resending the same request with the same key does not start a second task. |
{
"type": "object",
"required": [
"task_id",
"message"
],
"properties": {
"message": {
"type": "string",
"maxLength": 8000,
"description": "Follow-up message for the task, e.g. an answer to its question or a new instruction."
},
"task_id": {
"type": "string",
"description": "The task_id returned by submit_analysis."
},
"idempotency_key": {
"type": "string",
"maxLength": 128,
"description": "Optional client key; resending the same request with the same key does not start a second task."
}
},
"additionalProperties": false
}Find protein families by keyword (e.g. endolysin, holin), by member protein_id, or by family_id.
| Argument | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. |
| keyword | string | Case-insensitive text to match in the annotations. |
| pagesize | integer | Rows per page. |
| family_id | string | Protein family id. |
| protein_id | string | Return the family that contains this protein id. |
| min_members | integer | Minimum number of member proteins. |
| min_datasets | integer | Minimum number of source datasets among the members. |
| dominant_class | string | Dominant function class of the family. |
| non_singleton_only | boolean | Skip families with a single member. |
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "Page number, starting at 1."
},
"keyword": {
"type": "string",
"description": "Case-insensitive text to match in the annotations."
},
"pagesize": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Rows per page."
},
"family_id": {
"type": "string",
"description": "Protein family id."
},
"protein_id": {
"type": "string",
"description": "Return the family that contains this protein id."
},
"min_members": {
"type": "integer",
"minimum": 1,
"description": "Minimum number of member proteins."
},
"min_datasets": {
"type": "integer",
"minimum": 1,
"description": "Minimum number of source datasets among the members."
},
"dominant_class": {
"type": "string",
"description": "Dominant function class of the family."
},
"non_singleton_only": {
"type": "boolean",
"description": "Skip families with a single member."
}
},
"additionalProperties": false
}Find phages matching filters (host, taxonomy, lifestyle, dataset, length, GC, AMR/virulence-free...). Paged rows.
| Argument | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. |
| filters* | object | Phage cohort filters; all given filters are combined with AND. |
| sort_by | string | Row order: id, length_desc or length_asc. |
| pagesize | integer | Rows per page. |
| include_total | boolean | Also return the total number of matches (slower). |
{
"type": "object",
"required": [
"filters"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "Page number, starting at 1."
},
"filters": {
"type": "object",
"properties": {
"host": {
"type": "string",
"description": "Host name, e.g. Salmonella or Escherichia coli."
},
"gc_max": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Maximum GC content in percent."
},
"gc_min": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Minimum GC content in percent."
},
"is_rep": {
"type": "boolean",
"description": "Only cluster representatives."
},
"cluster": {
"type": "string",
"description": "Phage cluster id."
},
"dataset": {
"type": "string",
"description": "Source dataset name, e.g. RefSeq, GenBank, MGV (see catalog_overview)."
},
"amr_free": {
"type": "boolean",
"description": "No annotated antimicrobial-resistance genes (columnar layer)."
},
"datasets": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 30,
"description": "Only these source datasets."
},
"min_trna": {
"type": "integer",
"minimum": 0,
"description": "Minimum number of annotated tRNAs."
},
"taxonomy": {
"type": "string",
"description": "Phage taxonomy name."
},
"accession": {
"type": "string",
"description": "Exact phage accession."
},
"host_name": {
"type": "string",
"description": "Host name at the given host_rank."
},
"host_rank": {
"type": "string",
"description": "Host rank used with host_name, e.g. genus or species."
},
"is_mapped": {
"type": "boolean",
"description": "Filter on the data service's is_mapped flag."
},
"lifestyle": {
"type": "string",
"description": "Predicted lifestyle, e.g. virulent or temperate."
},
"phage_ids": {
"type": "array",
"items": {
"type": "integer"
},
"maxItems": 200,
"description": "PhageScope numeric phage ids."
},
"accessions": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 200,
"description": "Exact phage accessions."
},
"has_crispr": {
"type": "boolean",
"description": "Has annotated CRISPR arrays."
},
"host_match": {
"type": "string",
"description": "How to match host (service default when omitted)."
},
"length_max": {
"type": "integer",
"minimum": 0,
"description": "Maximum genome length in bp."
},
"length_min": {
"type": "integer",
"minimum": 0,
"description": "Minimum genome length in bp."
},
"subcluster": {
"type": "string",
"description": "Phage subcluster id."
},
"completeness": {
"type": "string",
"description": "Genome completeness label, e.g. Complete, High-quality."
},
"has_anticrispr": {
"type": "boolean",
"description": "Has annotated anti-CRISPR proteins."
},
"taxonomy_match": {
"type": "string",
"description": "How to match taxonomy (service default when omitted)."
},
"virulence_free": {
"type": "boolean",
"description": "No annotated virulence factors (columnar layer)."
}
},
"description": "Phage cohort filters; all given filters are combined with AND.",
"additionalProperties": false
},
"sort_by": {
"enum": [
"id",
"length_desc",
"length_asc"
],
"type": "string",
"default": "id",
"description": "Row order: id, length_desc or length_asc."
},
"pagesize": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Rows per page."
},
"include_total": {
"type": "boolean",
"default": false,
"description": "Also return the total number of matches (slower)."
}
},
"additionalProperties": false
}Proteins of one phage (optionally filtered by product text or function class), or proteins by id.
| Argument | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. |
| pagesize | integer | Rows per page. |
| phage_id | integer | PhageScope numeric phage id. |
| accession | string | Phage accession; used when phage_id is omitted. |
| protein_ids | array | Exact PhageScope protein ids. |
| product_query | string | Text to match in the protein product annotation. |
| function_class | string | Protein function class to filter by. |
| include_sequence | boolean | Include amino-acid sequences in each row. |
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "Page number, starting at 1."
},
"pagesize": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1,
"description": "Rows per page."
},
"phage_id": {
"type": "integer",
"minimum": 1,
"description": "PhageScope numeric phage id."
},
"accession": {
"type": "string",
"description": "Phage accession; used when phage_id is omitted."
},
"protein_ids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 100,
"minItems": 1,
"description": "Exact PhageScope protein ids."
},
"product_query": {
"type": "string",
"description": "Text to match in the protein product annotation."
},
"function_class": {
"type": "string",
"description": "Protein function class to filter by."
},
"include_sequence": {
"type": "boolean",
"default": false,
"description": "Include amino-acid sequences in each row."
}
},
"additionalProperties": false
}Find PhageScope proteins similar to 1-50 protein sequences (MMseqs2 over ~45 M unique proteins). Returns hits within wait_seconds, otherwise a search_id for get_similarity_result.
| Argument | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. |
| evalue | number | Maximum E-value of reported hits. |
| datasets | array | Only these source datasets. |
| max_hits | integer | Hits kept per query. |
| pagesize | integer | Rows per page. |
| sequences* | any | Protein FASTA text, or a list of {id, sequence}. 30-10000 aa each, 50000 aa in total. |
| sensitivity | string | MMseqs2 search sensitivity: fast, default or sensitive. |
| min_coverage | number | Minimum of query and target coverage. |
| min_identity | number | Minimum sequence identity of hits, from 0 to 1. |
| wait_seconds | integer | Seconds to wait for the result before returning a search_id to poll. |
| exclude_low_quality | boolean | Drop proteins only found in LQ_* datasets. |
{
"type": "object",
"required": [
"sequences"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "Page number, starting at 1."
},
"evalue": {
"type": "number",
"default": 0.001,
"maximum": 10,
"description": "Maximum E-value of reported hits.",
"exclusiveMinimum": 0
},
"datasets": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 40,
"description": "Only these source datasets."
},
"max_hits": {
"type": "integer",
"default": 50,
"maximum": 500,
"minimum": 1,
"description": "Hits kept per query."
},
"pagesize": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1,
"description": "Rows per page."
},
"sequences": {
"oneOf": [
{
"type": "string",
"maxLength": 120000
},
{
"type": "array",
"items": {
"type": "object",
"required": [
"sequence"
],
"properties": {
"id": {
"type": "string",
"maxLength": 64
},
"sequence": {
"type": "string",
"maxLength": 10000
}
},
"additionalProperties": false
},
"maxItems": 50,
"minItems": 1
}
],
"description": "Protein FASTA text, or a list of {id, sequence}. 30-10000 aa each, 50000 aa in total."
},
"sensitivity": {
"enum": [
"fast",
"default",
"sensitive"
],
"type": "string",
"default": "default",
"description": "MMseqs2 search sensitivity: fast, default or sensitive."
},
"min_coverage": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Minimum of query and target coverage."
},
"min_identity": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Minimum sequence identity of hits, from 0 to 1."
},
"wait_seconds": {
"type": "integer",
"default": 20,
"maximum": 20,
"minimum": 0,
"description": "Seconds to wait for the result before returning a search_id to poll."
},
"exclude_low_quality": {
"type": "boolean",
"default": false,
"description": "Drop proteins only found in LQ_* datasets."
}
},
"additionalProperties": false
}Hand a data-analysis or modelling task to the GAgent research agent, which works on read-only PhageScope data with code execution and bioinformatics tools. Returns a task_id at once; the work takes minutes to hours. Poll get_analysis_status, then read get_analysis_result. Reuse the same idempotency_key when retrying so the task is not submitted twice.
| Argument | Type | Description |
|---|---|---|
| inline_data | string | Optional small CSV/TSV/FASTA text (at most 262144 bytes). |
| instructions* | string | What to analyse or model, and what to report. |
| idempotency_key | string | Optional client key; resending the same request with the same key does not start a second task. |
| phage_accessions | array | Phage accessions to include in the analysis. |
| deliverables_hint | array | e.g. table, figure, model, report |
{
"type": "object",
"required": [
"instructions"
],
"properties": {
"inline_data": {
"type": "string",
"description": "Optional small CSV/TSV/FASTA text (at most 262144 bytes)."
},
"instructions": {
"type": "string",
"maxLength": 8000,
"description": "What to analyse or model, and what to report."
},
"idempotency_key": {
"type": "string",
"maxLength": 128,
"description": "Optional client key; resending the same request with the same key does not start a second task."
},
"phage_accessions": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 200,
"description": "Phage accessions to include in the analysis."
},
"deliverables_hint": {
"type": "array",
"items": {
"type": "string"
},
"description": "e.g. table, figure, model, report"
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 20, 2026.