PhageAgent is an MCP server published by io.github.yiyabo, hosted at phageagent.deepomics.org. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 19 tools, including catalog_overview, search_phages, cohort_report, aggregate_phages, get_phage.
PhageAgent MCP: PhageScope phage database and analysis tasks. Sign up at phageagent.deepomics.org.
1 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Catalog-wide counts (phages, proteins, families, datasets) and the dataset list. Start here.
No parameters.
{
"name": "catalog_overview",
"title": "PhageScope catalog overview",
"description": "Catalog-wide counts (phages, proteins, families, datasets) and the dataset list. Start here.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Find phages matching filters (host, taxonomy, lifestyle, dataset, length, GC, AMR/virulence-free...). Paged rows.
| Parameter | 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). |
{
"name": "search_phages",
"title": "Search phages",
"description": "Find phages matching filters (host, taxonomy, lifestyle, dataset, length, GC, AMR/virulence-free...). Paged rows.",
"inputSchema": {
"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
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Summarise a filtered phage cohort: size, composition breakdowns and a few sample rows.
| Parameter | 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. |
{
"name": "cohort_report",
"title": "Cohort report",
"description": "Summarise a filtered phage cohort: size, composition breakdowns and a few sample rows.",
"inputSchema": {
"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
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Count phages grouped by 1-3 dimensions (dataset, lifestyle, host rank...), optionally filtered.
| Parameter | 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). |
{
"name": "aggregate_phages",
"title": "Aggregate phages",
"description": "Count phages grouped by 1-3 dimensions (dataset, lifestyle, host rank...), optionally filtered.",
"inputSchema": {
"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
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Full metadata for one phage: taxonomy, host lineage, lifestyle, quality, cluster, dataset.
| Parameter | Type | Description |
|---|---|---|
| phage_id | integer | PhageScope numeric phage id. |
| accession | string | Phage accession; used when phage_id is omitted. |
{
"name": "get_phage",
"title": "Get phage",
"description": "Full metadata for one phage: taxonomy, host lineage, lifestyle, quality, cluster, dataset.",
"inputSchema": {
"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
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Genome nucleotide sequence of one phage, capped at max_bases.
| Parameter | 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. |
{
"name": "get_sequence",
"title": "Get genome sequence",
"description": "Genome nucleotide sequence of one phage, capped at max_bases.",
"inputSchema": {
"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
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Proteins of one phage (optionally filtered by product text or function class), or proteins by id. With protein_ids, duplicate ids are collapsed, results keep input order, and missing_ids lists the requested ids that were not found.
| Parameter | 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. |
{
"name": "search_proteins",
"title": "Search proteins",
"description": "Proteins of one phage (optionally filtered by product text or function class), or proteins by id. With protein_ids, duplicate ids are collapsed, results keep input order, and missing_ids lists the requested ids that were not found.",
"inputSchema": {
"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
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Find protein families by keyword (e.g. endolysin, holin), by member protein_id, or by family_id.
| Parameter | 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. |
Member proteins of one family (optionally one subfamily or dataset). Paged.
| Parameter | 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. |
{
"name": "family_members",
"title": "Protein family members",
"description": "Member proteins of one family (optionally one subfamily or dataset). Paged.",
"inputSchema": {
"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
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Annotated features of one type (tRNA, CRISPR, anti-CRISPR, terminator, virulence, AMR, transmembrane).
| Parameter | 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. |
{
"name": "query_features",
"title": "Query genomic features",
"description": "Annotated features of one type (tRNA, CRISPR, anti-CRISPR, terminator, virulence, AMR, transmembrane).",
"inputSchema": {
"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
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Resolve predicted (ESMFold) structure availability and links for protein ids.
| Parameter | Type | Description |
|---|---|---|
| protein_ids * | array | Exact PhageScope protein ids. |
{
"name": "get_structures",
"title": "Get protein structures",
"description": "Resolve predicted (ESMFold) structure availability and links for protein ids.",
"inputSchema": {
"type": "object",
"required": [
"protein_ids"
],
"properties": {
"protein_ids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50,
"minItems": 1,
"description": "Exact PhageScope protein ids."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": 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.
| Parameter | 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. |
Status and paged hits of a similarity_search by its search_id (kept 7 days).
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. |
| pagesize | integer | Rows per page. |
| search_id * | string | The search_id returned by similarity_search. |
{
"name": "get_similarity_result",
"title": "Similarity search result",
"description": "Status and paged hits of a similarity_search by its search_id (kept 7 days).",
"inputSchema": {
"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
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": 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.
| Parameter | 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 |
{
"name": "submit_analysis",
"title": "Submit an analysis task to GAgent",
"description": "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.",
"inputSchema": {
"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
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Status of a task: working, completed, failed or cancelled, with recent progress and when to poll again.
| Parameter | Type | Description |
|---|---|---|
| task_id * | string | The task_id returned by submit_analysis. |
{
"name": "get_analysis_status",
"title": "Check an analysis task",
"description": "Status of a task: working, completed, failed or cancelled, with recent progress and when to poll again.",
"inputSchema": {
"type": "object",
"required": [
"task_id"
],
"properties": {
"task_id": {
"type": "string",
"description": "The task_id returned by submit_analysis."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Summary, deliverables (with short-lived download links) and provenance of a finished task.
| Parameter | Type | Description |
|---|---|---|
| task_id * | string | The task_id returned by submit_analysis. |
{
"name": "get_analysis_result",
"title": "Get an analysis result",
"description": "Summary, deliverables (with short-lived download links) and provenance of a finished task.",
"inputSchema": {
"type": "object",
"required": [
"task_id"
],
"properties": {
"task_id": {
"type": "string",
"description": "The task_id returned by submit_analysis."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": 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.
| Parameter | 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. |
{
"name": "reply_analysis",
"title": "Continue an analysis task",
"description": "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.",
"inputSchema": {
"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
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Stop a working task. Deliverables already published stay available.
| Parameter | Type | Description |
|---|---|---|
| task_id * | string | The task_id returned by submit_analysis. |
{
"name": "cancel_analysis",
"title": "Cancel an analysis task",
"description": "Stop a working task. Deliverables already published stay available.",
"inputSchema": {
"type": "object",
"required": [
"task_id"
],
"properties": {
"task_id": {
"type": "string",
"description": "The task_id returned by submit_analysis."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}This token's recent analysis tasks, newest first.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Maximum number of tasks to return. |
| status | string | Only tasks in this status. |
{
"name": "list_analyses",
"title": "List analysis tasks",
"description": "This token's recent analysis tasks, newest first.",
"inputSchema": {
"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
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}PhageAgent MCP: read-only access to the PhageScope phage database (about 2.6M phage genomes, 131M proteins, 12.6M protein families). Start with catalog_overview, use cohort_report/aggregate_phages for counts, search_phages for rows, then get_phage/get_sequence/search_proteins for detail. Missing values are unknown, not zero. Results are paged and size-capped; page instead of asking for everything.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "search_families",
"title": "Search protein families",
"description": "Find protein families by keyword (e.g. endolysin, holin), by member protein_id, or by family_id.",
"inputSchema": {
"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
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}| exclude_low_quality | boolean | Drop proteins only found in LQ_* datasets. |
{
"name": "similarity_search",
"title": "Protein similarity search",
"description": "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.",
"inputSchema": {
"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
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}