PhageAgent
● Activeio.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.
Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):
{
"mcpServers": {
"phageagent": {
"url": "https://phageagent.deepomics.org/mcp"
}
}
}claude mcp add --transport http phageagent https://phageagent.deepomics.org/mcpcode --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
Is it safe? Is it maintained?
Serverdex check: Nov 22, 2026Mostly 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 →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_overviewCatalog-wide counts (phages, proteins, families, datasets) and the dataset list. Start here.
search_phages5 paramsFind phages matching filters (host, taxonomy, lifestyle, dataset, length, GC, AMR/virulence-free...). Paged rows.
Show parametersHide 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 paramsSummarise a filtered phage cohort: size, composition breakdowns and a few sample rows.
Show parametersHide 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 paramsCount phages grouped by 1-3 dimensions (dataset, lifestyle, host rank...), optionally filtered.
Show parametersHide 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 paramsFull metadata for one phage: taxonomy, host lineage, lifestyle, quality, cluster, dataset.
Show parametersHide parameters
phage_idintegerPhageScope numeric phage id.accessionstringPhage accession; used when phage_id is omitted.
get_sequence3 paramsGenome nucleotide sequence of one phage, capped at max_bases.
Show parametersHide parameters
phage_idintegerPhageScope numeric phage id.accessionstringPhage accession; used when phage_id is omitted.max_basesintegerMaximum number of sequence bases to return.
search_proteins8 paramsProteins 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 parametersHide 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 paramsFind protein families by keyword (e.g. endolysin, holin), by member protein_id, or by family_id.
Show parametersHide 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 paramsMember proteins of one family (optionally one subfamily or dataset). Paged.
Show parametersHide 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 paramsAnnotated features of one type (tRNA, CRISPR, anti-CRISPR, terminator, virulence, AMR, transmembrane).
Show parametersHide 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 paramResolve 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 parametersHide parameters
protein_idsarrayrequiredExact PhageScope protein ids.
similarity_search11 paramsFind 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 parametersHide 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 paramsStatus, 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 parametersHide parameters
search_idstringrequiredThe search_id returned by similarity_search.pageintegerPage number, starting at 1.pagesizeintegerRows per page.
submit_analysis5 paramsHand 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 parametersHide 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, reportidempotency_keystringOptional client key; resending the same request with the same key does not start a second task.
get_analysis_status1 paramStatus of a task: working, completed, failed or cancelled, with recent progress and when to poll again.
Show parametersHide parameters
task_idstringrequiredThe task_id returned by submit_analysis.
get_analysis_result1 paramSummary, deliverables (with short-lived download links) and provenance of a finished task.
Show parametersHide parameters
task_idstringrequiredThe task_id returned by submit_analysis.
reply_analysis3 paramsSend 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 parametersHide 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 paramStop a working task. Deliverables already published stay available.
Show parametersHide parameters
task_idstringrequiredThe task_id returned by submit_analysis.
list_analyses2 paramsThis token's recent analysis tasks, newest first.
Show parametersHide 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-http
https://phageagent.deepomics.org/mcp
Alternatives to PhageAgent
All PhageAgent alternatives →Best Productivity servers →The most-starred Productivity servers in the index, with their live-check result.
| Server | Stars | Last push | Live check |
|---|---|---|---|
| Front-End Checklist | 74,746 | Oct 2026 | Working |
| Windmill | 18,600 | Nov 2026 | Needs sign-in |
| Agent-Native Content | 7,735 | Nov 2026 | Needs sign-in |
| Agent-Native Calendar | 7,735 | Nov 2026 | Needs sign-in |
| Agent-Native Plan | 7,735 | Nov 2026 | Needs 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.
More Productivity servers
Browse all Productivity →Reeling
yomariano
Social publishing, scheduling and delivery-status tools for Reeling accounts.
HackMD
yuna0x0
A Model Context Protocol server for integrating HackMD's note-taking platform with AI assistants.
Claudia
yuvalsuede
Task management for AI agents with hierarchical tasks, dependencies, sprints, and coordination.
multi-mail
yybd
Several Gmail accounts: search, read, draft, send, labels and Google Calendar. Own OAuth client.
Obelisk
zachhannum
Comment on a passage of an Obsidian note, and propose suggested edits.
SynomosAI Governance MCP
zhaoxinghua09-cell
AI governance assessment: A³ scorecard, ISO 42001 evidence chain, compliance checklist, PII scan.
Add the badge to your site
Show visitors that PhageAgent is listed here — it’s also the link we check for a free listing.
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
[](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.
Install buttons — for your README
[](https://serverdex.io/install/cursor/io-github-yiyabo-phageagent) [](https://serverdex.io/install/vscode/io-github-yiyabo-phageagent) [](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).