PhageAgent

● Active

io.github.yiyabo/phageagent

PhageAgent MCP: PhageScope phage database and analysis tasks. Sign up at phageagent.deepomics.org.

Connect this server

One click to install, or copy the config below. Suits: Cursor · HTTP clients.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "phageagent": {
      "url": "https://phageagent.deepomics.org/mcp"
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --transport http phageagent https://phageagent.deepomics.org/mcp
VS Code
code --add-mcp '{"name":"phageagent","type":"http","url":"https://phageagent.deepomics.org/mcp"}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in. Codex takes hosted servers in config.toml ([mcp_servers.<name>] url = …) rather than on the command line.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Productivity
Version
0.2.0
Registry
active
Published
11/20/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Mostly fine: PhageAgent is maintained, hosted endpoint answering without a key.

Maintained
Active
Last commit 2 days ago (Nov 20, 2026), 0 open issues.
Official registry
Active
Published as io.github.yiyabo/phageagent in the official MCP registry, version 0.2.0.
Source
No licence found
Public repository, but GitHub reports no recognised licence (0 stars). Check the README before shipping it in a product.
Runs
Hosted by the publisher
Your client talks to phageagent.deepomics.org: prompts and tool arguments leave your machine for that host.
Credentials
None needed to connect
The hosted endpoint completed the Serverdex initialize + tools/list handshake with no key (checked Nov 22, 2026); individual tools may still ask for one.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself and see the status history.

Live check

checked Nov 22, 2026, 08:07 UTCStatus history & uptime →
● Working515 msprotocol 2025-06-18v1resourcestools

The endpoint answered the MCP handshake as "PhageAgent" and listed 19 tools. Answering since Nov 21, 2026.

Context cost ≈ 5.9k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 19 tools.

Tools (19)

  • catalog_overview

    Catalog-wide counts (phages, proteins, families, datasets) and the dataset list. Start here.

  • search_phages5 params

    Find phages matching filters (host, taxonomy, lifestyle, dataset, length, GC, AMR/virulence-free...). Paged rows.

    Show parameters
    • filtersobjectrequiredPhage cohort filters; all given filters are combined with AND.
    • pageintegerPage number, starting at 1.
    • pagesizeintegerRows per page.
    • include_totalbooleanAlso return the total number of matches (slower).
    • sort_bystringRow order: id, length_desc or length_asc.
  • cohort_report3 params

    Summarise a filtered phage cohort: size, composition breakdowns and a few sample rows.

    Show parameters
    • filtersobjectrequiredPhage cohort filters; all given filters are combined with AND.
    • sample_limitintegerHow many example phages to include in the report.
    • sort_bystringRow order: id, length_desc or length_asc.
  • aggregate_phages3 params

    Count phages grouped by 1-3 dimensions (dataset, lifestyle, host rank...), optionally filtered.

    Show parameters
    • group_byrequiredDimension, or list of dimensions, to group counts by (see the query-guide resource).
    • filtersobjectPhage cohort filters; all given filters are combined with AND.
    • limitintegerMaximum number of groups to return.
  • get_phage2 params

    Full metadata for one phage: taxonomy, host lineage, lifestyle, quality, cluster, dataset.

    Show parameters
    • phage_idintegerPhageScope numeric phage id.
    • accessionstringPhage accession; used when phage_id is omitted.
  • get_sequence3 params

    Genome nucleotide sequence of one phage, capped at max_bases.

    Show parameters
    • phage_idintegerPhageScope numeric phage id.
    • accessionstringPhage accession; used when phage_id is omitted.
    • max_basesintegerMaximum number of sequence bases to return.
  • search_proteins8 params

    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.

    Show parameters
    • phage_idintegerPhageScope numeric phage id.
    • accessionstringPhage accession; used when phage_id is omitted.
    • protein_idsarrayExact PhageScope protein ids.
    • product_querystringText to match in the protein product annotation.
    • function_classstringProtein function class to filter by.
    • include_sequencebooleanInclude amino-acid sequences in each row.
    • pageintegerPage number, starting at 1.
    • pagesizeintegerRows per page.
  • search_families9 params

    Find protein families by keyword (e.g. endolysin, holin), by member protein_id, or by family_id.

    Show parameters
    • keywordstringCase-insensitive text to match in the annotations.
    • protein_idstringReturn the family that contains this protein id.
    • family_idstringProtein family id.
    • dominant_classstringDominant function class of the family.
    • min_membersintegerMinimum number of member proteins.
    • min_datasetsintegerMinimum number of source datasets among the members.
    • non_singleton_onlybooleanSkip families with a single member.
    • pageintegerPage number, starting at 1.
    • pagesizeintegerRows per page.
  • family_members6 params

    Member proteins of one family (optionally one subfamily or dataset). Paged.

    Show parameters
    • family_idstringrequiredProtein family id.
    • subfamily_idstringSubfamily id within the family.
    • datasetstringSource dataset name, e.g. RefSeq or GenBank (see catalog_overview).
    • include_sequencebooleanInclude amino-acid sequences in each row.
    • pageintegerPage number, starting at 1.
    • pagesizeintegerRows per page.
  • query_features7 params

    Annotated features of one type (tRNA, CRISPR, anti-CRISPR, terminator, virulence, AMR, transmembrane).

    Show parameters
    • feature_typestringrequiredFeature layer to query.
    • phage_idintegerPhageScope numeric phage id.
    • accessionstringPhage accession; used when phage_id is omitted.
    • datasetstringSource dataset name, e.g. RefSeq or GenBank (see catalog_overview).
    • keywordstringCase-insensitive text to match in the annotations.
    • pageintegerPage number, starting at 1.
    • pagesizeintegerRows per page.
  • get_structures1 param

    Resolve structure records for protein ids: experimental (PDB) or predicted (ESMFold, ColabFold, AlphaFold and other models), labelled per record by its source and method, with pLDDT where reported.

    Show parameters
    • protein_idsarrayrequiredExact PhageScope protein ids.
  • similarity_search11 params

    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. status is queued, running, done or failed; outcome is pending, hits, no_hits or failed. count is null until status=done. timings gives queued_seconds and run_seconds.

    Show parameters
    • sequencesrequiredProtein FASTA text, or a list of {id, sequence}. 30-10000 aa each, 50000 aa in total.
    • sensitivitystringMMseqs2 search sensitivity: fast, default or sensitive.
    • max_hitsintegerHits kept per query.
    • evaluenumberMaximum E-value of reported hits.
    • min_identitynumberMinimum sequence identity of hits, from 0 to 1.
    • min_coveragenumberMinimum of query and target coverage.
    • exclude_low_qualitybooleanDrop proteins only found in LQ_* datasets.
    • datasetsarrayOnly these source datasets.
    • wait_secondsintegerSeconds to wait for the result before returning a search_id to poll.
    • pageintegerPage number, starting at 1.
    • pagesizeintegerRows per page.
  • get_similarity_result3 params

    Status, outcome (pending, hits, no_hits or failed), timings and paged hits of a similarity_search by its search_id (kept 7 days). count is null until status=done.

    Show parameters
    • search_idstringrequiredThe search_id returned by similarity_search.
    • pageintegerPage number, starting at 1.
    • pagesizeintegerRows per page.
  • submit_analysis5 params

    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.

    Show parameters
    • instructionsstringrequiredWhat to analyse or model, and what to report.
    • phage_accessionsarrayPhage accessions to include in the analysis.
    • inline_datastringOptional small CSV/TSV/FASTA text (at most 262144 bytes).
    • deliverables_hintarraye.g. table, figure, model, report
    • idempotency_keystringOptional client key; resending the same request with the same key does not start a second task.
  • get_analysis_status1 param

    Status of a task: working, completed, failed or cancelled, with recent progress and when to poll again.

    Show parameters
    • task_idstringrequiredThe task_id returned by submit_analysis.
  • get_analysis_result1 param

    Summary, deliverables (with short-lived download links) and provenance of a finished task.

    Show parameters
    • task_idstringrequiredThe task_id returned by submit_analysis.
  • reply_analysis3 params

    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.

    Show parameters
    • task_idstringrequiredThe task_id returned by submit_analysis.
    • messagestringrequiredFollow-up message for the task, e.g. an answer to its question or a new instruction.
    • idempotency_keystringOptional client key; resending the same request with the same key does not start a second task.
  • cancel_analysis1 param

    Stop a working task. Deliverables already published stay available.

    Show parameters
    • task_idstringrequiredThe task_id returned by submit_analysis.
  • list_analyses2 params

    This token's recent analysis tasks, newest first.

    Show parameters
    • limitintegerMaximum number of tasks to return.
    • statusstringOnly tasks in this status.

Checked by Serverdex with a plain initialize + tools/list call to phageagent.deepomics.org/mcp, no credentials, about once a day. A failed check is never a removal.

On GitHub

read Nov 21, 2026
Stars
0
Forks
0
Last push
Nov 20, 2026
License
—

From the README

PhageAgent MCP — client packages and directory listings Source of the public repo https://github.com/yiyabo/phageagent-mcp (this folder becomes its root). Remote MCP server: https://phageagent.deepomics.org/mcp (Streamable HTTP, bearer token gpsk_...). Server code and access settings: app/services/phagescope_mcp/README.md. Every self-issued token gets all 17 tools: 11 read-only data tools (catalogoverview, searchphages, cohortreport, aggregatephages, getphage, getsequence, searchproteins, searchfamilies, familymembers, queryfeatures, get_structures) and 6 analysis-task tools that hand a request to PhageAgent and return its results. Data reads are capped at 2 GB per token per day; analysis tasks have no quota during the test phase. Access Anyone can use it: sign up at https://phageagent.deepomics.org, then create a token yourself (see "Get a token" below). Questions: xxwang5587@gmail.com. Layout Install Sign up or sign in at https://phageagent.deepomics.org and POST /phagescope-mcp/tokens {"name": " "}. Claude Code: Codex: Hermes (until the catalog entry is accepted): Checks • claude plugin validate . and claude plugin validate ./claude/phageagent • codex plugin marketplace add "$PWD" && codex plugin add phageagent@phageagent && codex mcp list • HERMESOPTIONALMCPS= hermes mcp catalog • registry/server.json against https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json

Read the full README on GitHub →

Remotes

  • streamable-httphttps://phageagent.deepomics.org/mcp

The most-starred Productivity servers in the index, with their live-check result.

ServerStarsLast pushLive check
Front-End Checklist74,746Oct 2026Working
Windmill18,600Nov 2026Needs sign-in
Agent-Native Content7,735Nov 2026Needs sign-in
Agent-Native Calendar7,735Nov 2026Needs sign-in
Agent-Native Plan7,735Nov 2026Needs sign-in

PhageAgent: questions people ask

Is PhageAgent a remote or a local MCP server?
According to its entry in the official MCP registry, PhageAgent ships as a hosted endpoint (streamable-http) that your client connects to by URL.
Does PhageAgent need an API key?
Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 22, 2026. Individual tools may still ask for a key when called.
Is PhageAgent safe to use?
Mostly fine: PhageAgent is maintained, hosted endpoint answering without a key. In detail — maintained: Active; official registry: Active; source: No licence found; runs: Hosted by the publisher; credentials: None needed to connect. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is PhageAgent still maintained?
Active: the repository's last commit 2 days ago. Last push Nov 20, 2026, 0 GitHub stars. Read from GitHub on Nov 21, 2026.
What tools does PhageAgent expose?
19 tools as listed by the server itself during the live check, including catalog_overview, search_phages, cohort_report, aggregate_phages, get_phage. The full list with parameters is in the Live check section above.
How do I add PhageAgent to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all Productivity →

Add the badge to your site

Show visitors that PhageAgent is listed here — it’s also the link we check for a free listing.

PhageAgent — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-yiyabo-phageagent?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="PhageAgent — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![PhageAgent — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-yiyabo-phageagent?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-yiyabo-phageagent) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-yiyabo-phageagent) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/io-github-yiyabo-phageagent)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/io-github-yiyabo-phageagent"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-yiyabo-phageagent"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-yiyabo-phageagent"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).