# ChatSpatial

> ChatSpatial is an open-source MCP server for health and science. Run spatial transcriptomics analysis from a chat with 20 schema-checked tools. 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://docs.cafferyang.com
- **Repository:** https://github.com/cafferychen777/chatspatial
- **MCP Registry name:** io.github.cafferychen777/chatspatial
- **Categories:** health and science
- **Listing updated:** 2026-11-15

## About

Spatial transcriptomics workflows are usually scripts, and the README argues that having an LLM write ad-hoc code makes results hard to reproduce. ChatSpatial instead has the model choose from a curated registry of 20 schema-validated tools and set their parameters, which then run 67 analysis methods across 13 categories. The same request should therefore run the same way across sessions and clients.

Supported data includes 10x Visium, Xenium, Slide-seq v2, MERFISH and seqFISH. The README's example prompt is to load an .h5ad file and plot gene expression at the spatial coordinates, and the quick start includes a sample and a Leiden clustering workflow that works on the standard install. Other method families are optional: a full extra adds 15 Python families such as CellRank, FastCCC and annotation and enrichment backends, while R bridges, AESTETIK and rctd-py stay separate because of system or size requirements.

It runs over stdio by default and can also serve Streamable HTTP when configured. It implements MCP 2026-07-28 and still serves 2025-11-25 clients. A Docker image is available, mounting data at /data, and the project links a manuscript and a reproduction image that reruns key results without an LLM.

## Features

- **Schema-enforced tools:** Twenty validated tools replace free-form generated code.
- **67 analysis methods:** Covers 13 categories, selected through tool parameters.
- **Many platforms:** Supports Visium, Xenium, Slide-seq v2, MERFISH and seqFISH data.
- **Optional method families:** A full extra adds 15 Python families; R-based ones are installed separately.
- **Docker image:** Runs from a container with host data mounted at /data.
- **Reproduction image:** Reruns the manuscript's key results without an LLM.

## Good for

- Load an h5ad file and plot gene expression in space
- Cluster spots with a Leiden workflow
- Compare methods for spatial domain detection
- Run cell-cell communication analysis on spatial data
- Repeat the same analysis across sessions and clients

## Install

### Claude Code (Terminal)

```sh
claude mcp add chatspatial -- uvx chatspatial
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "chatspatial": {
      "command": "uvx",
      "args": [
        "chatspatial"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "chatspatial": {
      "command": "uvx",
      "args": [
        "chatspatial"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "chatspatial": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "chatspatial"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "chatspatial": {
      "command": "uvx",
      "args": [
        "chatspatial"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "chatspatial": {
      "command": "uvx",
      "args": [
        "chatspatial"
      ]
    }
  }
}
```

## FAQ

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

Run claude mcp add --scope user chatspatial -- uvx --from chatspatial chatspatial server.

### Do I need to write code?

The documentation says no coding is required; you describe analyses in natural language.

### How many tools and methods does it have?

20 MCP tools orchestrating 67 methods in 13 analytical categories.

### Can I use Docker?

Yes. Pull cafferyyang777/chatspatial and mount your data to /data.

### Is ChatSpatial free?

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

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

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

### What are the best alternatives to ChatSpatial?

The closest alternatives to ChatSpatial are Tooluniverse, Oya Browser, Later Stages, MedXpert 标准检索连接器 and MedXpert 全球法规连接器 (reg-connector).

## Alternatives

- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.
- [MedXpert 标准检索连接器](https://ai-powered.com/mcp/medxpert-2): MedXpert 标准检索连接器 is a free MCP server for legal and government.
- [MedXpert 全球法规连接器 (reg-connector)](https://ai-powered.com/mcp/medxpert-reg-connector): MedXpert 全球法规连接器 (reg-connector) is a free MCP server for legal and government.
- [Splyt](https://ai-powered.com/mcp/splyt): Splyt is a free MCP server for health and science.
- [Health Agent](https://ai-powered.com/mcp/health-agent): Health Agent is an MCP server for health and science.
- [Pausila](https://ai-powered.com/mcp/pausila): Pausila is a free MCP server for local services.

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