# PhageScope

> PhageScope is a free MCP server for academic research. MCP server giving AI clients access to the PhageScope bacteriophage database and analysis. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, CLI, Self-hosted
- **Repository:** https://github.com/yiyabo/phagescope-mcp
- **MCP Registry name:** io.github.yiyabo/phagescope
- **Categories:** [academic research](https://ai-powered.com/categories/academic-research)
- **Listing updated:** 2026-11-20

## About

The README describes a remote MCP server hosted at phageagent.deepomics.org that connects AI clients to a bacteriophage database. Access uses a bearer token issued after signing up on the hosting site; the README says every token receives the same set of 17 tools.

The tools are split into two groups. Eleven read-only data tools cover catalog overviews, phage and protein searches, protein family lookups, sequence and structure retrieval, and aggregate reports. Six analysis-task tools pass a request to the PhageScope agent and return its output. The README notes a daily cap of 2 GB of data reads per token, and says analysis tasks have no quota during the test phase.

The server suits researchers in phage biology and microbiology who want an assistant to query phage genomes and run comparative analyses. Setup instructions are provided for Claude Code, Codex and Hermes.

## Features

- **Phage catalog search:** Search and retrieve individual phage records, sequences and structures from the database.
- **Protein and family lookup:** Find proteins and protein families and list the members of a given family.
- **Aggregate cohort reports:** Generate overview and aggregate statistics across groups of phages.
- **Analysis task delegation:** Six tools hand analysis requests to the PhageScope agent and return its results.
- **Token-based access:** Each user creates a personal bearer token after signing up on the hosting site.

## Good for

- Querying phage genome and protein records from an AI assistant
- Comparing phage families and their member proteins
- Retrieving sequences and structures for bioinformatics pipelines
- Running phage analysis tasks through an MCP-connected client

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http phagescope https://phageagent.deepomics.org/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://phageagent.deepomics.org/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "phagescope": {
      "url": "https://phageagent.deepomics.org/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "phagescope": {
      "type": "http",
      "url": "https://phageagent.deepomics.org/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "phagescope": {
      "serverUrl": "https://phageagent.deepomics.org/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://phageagent.deepomics.org/mcp
```

Enter a Name (for example "PhageScope"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "phagescope": {
      "type": "http",
      "url": "https://phageagent.deepomics.org/mcp"
    }
  }
}
```

## Tools

16 of 19 tools say they're read-only. 3 of 19 tools say they can delete or change data. From the server's own tool annotations; not verified by us.

- `catalog_overview` (says read-only): Catalog-wide counts (phages, proteins, families, datasets) and the dataset list. Start here.
- `search_phages` (says read-only): Find phages matching filters (host, taxonomy, lifestyle, dataset, length, GC, AMR/virulence-free...). Paged rows.
- `cohort_report` (says read-only): Summarise a filtered phage cohort: size, composition breakdowns and a few sample rows.
- `aggregate_phages` (says read-only): Count phages grouped by 1-3 dimensions (dataset, lifestyle, host rank...), optionally filtered.
- `get_phage` (says read-only): Full metadata for one phage: taxonomy, host lineage, lifestyle, quality, cluster, dataset.
- `get_sequence` (says read-only): Genome nucleotide sequence of one phage, capped at max_bases.
- `search_proteins` (says read-only): Proteins of one phage (optionally filtered by product text or function class), or proteins by id.
- `search_families` (says read-only): Find protein families by keyword (e.g. endolysin, holin), by member protein_id, or by family_id.
- `family_members` (says read-only): Member proteins of one family (optionally one subfamily or dataset). Paged.
- `query_features` (says read-only): Annotated features of one type (tRNA, CRISPR, anti-CRISPR, terminator, virulence, AMR, transmembrane).
- `get_structures` (says read-only): Resolve predicted (ESMFold) structure availability and links for protein ids.
- `similarity_search` (says read-only): 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.
- `get_similarity_result` (says read-only): Status and paged hits of a similarity_search by its search_id (kept 7 days).
- `submit_analysis` (says it can change data): 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.
- `get_analysis_status` (says read-only): Status of a task: working, completed, failed or cancelled, with recent progress and when to poll again.
- `get_analysis_result` (says read-only): Summary, deliverables (with short-lived download links) and provenance of a finished task.
- `reply_analysis` (says it can change data): 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.
- `cancel_analysis` (says it can change data): Stop a working task. Deliverables already published stay available.
- `list_analyses` (says read-only): This token's recent analysis tasks, newest first.

## FAQ

### Is there a cost to use PhageScope MCP?

The README says anyone can sign up for free and create a token. Data reads are capped at 2 GB per token per day, and analysis tasks have no quota during the test phase.

### How do I connect to the server?

Use the streamable HTTP endpoint at https://phageagent.deepomics.org/mcp with a bearer token. The README gives setup steps for Claude Code, Codex and Hermes.

### How many tools does the server expose?

Every token gets 17 tools: 11 read-only data tools and 6 analysis-task tools.

### How do I add PhageScope to Claude Code?

Run this command in your terminal: claude mcp add --transport http phagescope https://phageagent.deepomics.org/mcp

### What are the best alternatives to PhageScope?

The closest alternatives to PhageScope are Pubscope, Web of Science MCP bridge, Research papers, Research Mcp and Research Scope.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 21 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Pubscope](https://ai-powered.com/mcp/pubscope): Pubscope is a freemium MCP server for academic research.
- [Web of Science MCP bridge](https://ai-powered.com/mcp/web-of-science-mcp-bridge): Web of Science MCP bridge is an open-source MCP server for academic research.
- [Research papers](https://ai-powered.com/mcp/research-papers): Research papers is a freemium MCP server for health and science.
- [Research Mcp](https://ai-powered.com/mcp/research-mcp-3): Research Mcp is a freemium MCP server for academic research.
- [Research Scope](https://ai-powered.com/mcp/research-scope): Research Scope is an open-source MCP server for academic research.
- [Science AI Journal MCP Server](https://ai-powered.com/mcp/science-ai-journal-mcp-server): Science AI Journal MCP Server is a freemium MCP server for academic research.
- [Crossref Scholarly Data](https://ai-powered.com/mcp/crossref-scholarly-data): Crossref Scholarly Data is a paid MCP server for academic research.
- [ENCODE Toolkit](https://ai-powered.com/mcp/encode-toolkit): ENCODE Toolkit is an open-source MCP server for academic research.

---
Source: https://ai-powered.com/mcp/phagescope
