# Piaso MCP

> Piaso MCP is an open-source MCP server for health and science. Docs for the PIASO single-cell omics toolkit and its companion packages, plus marker DB. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://piaso.org
- **Repository:** https://github.com/genecell/piaso-for-agents
- **MCP Registry name:** io.github.genecell/piaso-mcp
- **Categories:** health and science, developer tools
- **Listing updated:** 2026-11-16

## About

This server serves documentation for the PIASO ecosystem, built from a single agent-neutral knowledge pack kept by the Fishell Laboratory at Harvard Medical School and the Broad Institute. It also reaches the live PIASOmarkerDB. The registry entry names PIASO, COSG, cytome, LARIS and cytorete as covered components.

The README explains how the pieces fit: piaso-tools for analysis, cytome for single-file SQLite storage, COSG for marker genes, LARIS for spatial ligand-receptor analysis, and cytorete for gene regulatory networks. It also covers choices such as SCALAR versus LARIS, and AnnData versus .cytome. The docs are tested against pinned component versions on every push.

It is for bioinformaticians who want a coding agent to write correct single-cell analysis code. It runs over stdio from a PyPI package.

## Features

- **Ecosystem documentation:** Guides for PIASO, COSG, cytome, LARIS and cytorete.
- **Live marker database:** Connects to PIASOmarkerDB for annotation.
- **Tested guidance:** Code blocks run against pinned versions in CI.
- **Agent-neutral pack:** Same knowledge generated for Claude, Cursor, Codex and others.
- **Composition advice:** Explains choosing between tools such as SCALAR and LARIS.

## Good for

- Ask an agent to write a PIASO analysis pipeline
- Choose between COSG and cytorete for a question
- Look up marker genes for annotating cell types
- Set up spatial ligand-receptor analysis

## Install

### Claude Code (Terminal)

```sh
claude mcp add piaso-mcp -- uvx piaso-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "piaso-mcp": {
      "command": "uvx",
      "args": [
        "piaso-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "piaso-mcp": {
      "command": "uvx",
      "args": [
        "piaso-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "piaso-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "piaso-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "piaso-mcp": {
      "command": "uvx",
      "args": [
        "piaso-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "piaso-mcp": {
      "command": "uvx",
      "args": [
        "piaso-mcp"
      ]
    }
  }
}
```

## FAQ

### How is it installed?

As the piaso-mcp package from PyPI, over stdio.

### Who maintains it?

The Fishell Laboratory at Harvard Medical School and the Broad Institute.

### Which versions is it tested against?

The README lists piaso-tools 1.2.6, cosg 1.2.0, cytome 0.3.6, laris 0.14.0 and others.

### Is Piaso MCP free?

Yes. Piaso MCP is open source, so you can use and self-host it for free.

### How do I add Piaso MCP to Claude Code?

Run this command in your terminal: claude mcp add piaso-mcp -- uvx piaso-mcp

### What are the best alternatives to Piaso MCP?

The closest alternatives to Piaso MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.

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