Skip to content
MCP server

ChatSpatial

Run spatial transcriptomics analysis from a chat with 20 schema-checked tools

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
1.6.0
Listing updated
2 days ago

About ChatSpatial

ChatSpatial is an open-source MCP server for health and science. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add chatspatial -- uvx chatspatial

Add to claude_desktop_config.json

{
  "mcpServers": {
    "chatspatial": {
      "command": "uvx",
      "args": [
        "chatspatial"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "chatspatial": {
      "command": "uvx",
      "args": [
        "chatspatial"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

What it does

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

Pricing

Open source

Prices change. Check docs.cafferyang.com before you buy.

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 to ChatSpatial

  1. Tooluniverse

    MCP server

    MCP server giving AI agents access to thousands of scientific research tools

    Runs locally
    • Open source
    • 1.8K GitHub stars
    • Health and science
  2. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  3. Later Stages

    MCP server

    California senior living and care provider records from state licensing and Medicare

    • 6 tools
    • Remote
    • Free
    • Health and science
  4. Read-only local index of medical-device standards with official links, no standard text

    Runs locally
    • 4 tools
    • Free
    • Legal and government
  5. Splyt

    MCP server

    Let Claude or ChatGPT read your Splyt workouts, records, plan, habits and sleep

    • Remote
    • Free
    • Health and science