ChatSpatial
Schema-enforced spatial transcriptomics analysis with 20 tools and 67 methods.
Connector by cafferychen777 · GitHub account verified by the MCP Registry
Chalk Labs
Need help deploying ChatSpatial?
Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/cafferychen777-chatspatial
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.
- Tools
- 13 read · 3 write · 0 delete · 4 not yet classified
- Secrets
- None asked for
- Install scripts
- None found
- Runs as
- Python package
Tools by what they do 20
Read from the source code; the running server may list different tools.
Read 13 · Look things up without changing anything.
analyze_cell_communicationanalyze_cnvanalyze_enrichmentanalyze_spatial_statisticsanalyze_trajectory_dataanalyze_velocity_datacompare_conditionscompute_embeddingsfind_markersfind_spatial_genesidentify_spatial_domainsintegrate_samples
Show 1 more tools
visualize_data
Write 3 · Create, change, send or run things.
annotate_cell_typespreprocess_dataregister_spatial_data
Not yet classified 4 · We could not tell from the name and description.
deconvolve_dataexport_dataload_datareload_data
Network hosts it talks to 15
::1· found in codeapi.anthropic.com· found in codecran.r-project.org· found in codedocs.cafferyang.com· found in codedoi.org· found in codeensembl.org· found in codeftp.ensembl.org· found in codegenerativelanguage.googleapis.com· found in codegeodacenter.github.io· found in codegithub.com· found in codemaayanlab.cloud· found in codepysal.org· found in coder-project.org· found in coderaw.githubusercontent.com· found in codescvi-tools.org· found in code
Files it touches
/dev/null/tmp/my_outputs/Users/me/chatspatial/chatspatial/Users/me/data- Your home directory (~)
~/.chatspatial/results/my_data/differential_expression/wilcoxon_rank_genes_groups.csv- Any path the agent passes to its tools
Tools (20)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
analyze_cell_communicationAnalyze cell-cell communication and ligand-receptor interaction patterns. Args: data_id: Dataset ID params: Required - species, cell_type_key, and method. For mouse with liana, set liana_resource='mouseconsensus'. subset_key + subset_categories restrict the analysis to those observations (e.g. tc_le_region in ['TC', 'LE']).
analyze_cnvAnalyze copy number variations (CNVs) in spatial transcriptomics data. Args: data_id: Dataset identifier params: Required - reference_key, reference_categories, and optional method/thresholds. Gene positions missing from adata.var are annotated from bundled Ensembl 110 tables (species: human GRCh38 or mouse GRCm39). exclude_gene_classes removes immunoglobulin, ribosomal, mitochondrial or HLA genes from the CNV input; query_categories restricts CNV clustering to those reference_key categories.
analyze_enrichmentPerform gene set enrichment analysis. Args: data_id: Dataset ID params: Required - species must be specified. See EnrichmentParameters for methods and gene_set_database options.
analyze_spatial_statisticsAnalyze spatial statistics and autocorrelation patterns. Args: data_id: Dataset ID params: Analysis parameters (analysis_type, cluster_key, genes). See SpatialStatisticsParameters for all types. gene_selection='all' computes moran/geary for every gene; the full per-gene table (rank, statistic, p, FDR) is stored at results_key, only top genes are returned.
analyze_trajectory_dataInfer cellular trajectories and pseudotime ordering. Args: data_id: Dataset ID params: Trajectory parameters (method, root_cell, spatial_weight, etc.)
analyze_velocity_dataAnalyze RNA velocity to understand cellular dynamics. Requires 'spliced' and 'unspliced' layers. Args: data_id: Dataset ID params: Velocity parameters (method, scvelo_mode, etc.)
annotate_cell_typesAnnotate cell types in spatial transcriptomics data. Args: data_id: Dataset ID params: Annotation parameters (method, reference_data_id, cell_type_key, etc.) Note: Reference methods (tangram, scanvi) require reference_data_id to be preprocessed first. Rule-based methods: marker_score labels the groups of cluster_label (e.g. spatial domains) by mean log-normalized marker expression; threshold labels observations by a cutoff on a numeric obs column (e.g. deconvolution_rctd_<cell type>). Both write to output_key.
compare_conditionsCompare experimental conditions using pseudobulk differential expression (DESeq2). Args: data_id: Dataset ID params: Required - condition_key, condition1, condition2, sample_key, etc.
compute_embeddingsCompute dimensionality reduction (PCA, UMAP), clustering, and neighbor graphs. Args: data_id: Dataset ID params: Embedding parameters (PCA, UMAP, clustering, etc.)
deconvolve_dataDeconvolve spatial spots to estimate cell type proportions. Args: data_id: Dataset ID params: Required - method, cell_type_key, reference_data_id. See DeconvolutionParameters for all methods and options.
export_dataExport dataset to disk for external script access. Args: data_id: Dataset ID to export path: Custom path (default: ~/.chatspatial/active/{data_id}.h5ad) Returns: Absolute path where data was exported
find_markersFind differentially expressed genes between groups. Args: data_id: Dataset ID params: Required - group_key and optional method, group1/group2, n_top_genes, etc.
find_spatial_genesIdentify spatially variable genes. Args: data_id: Dataset ID params: Spatial variable gene parameters (method, n_top_genes, etc.)
identify_spatial_domainsIdentify spatial domains and tissue architecture. Args: data_id: Dataset ID params: Spatial domain parameters (method, n_domains, resolution, etc.)
integrate_samplesIntegrate multiple spatial transcriptomics samples into a unified dataset. Args: data_ids: List of dataset IDs to integrate params: Integration parameters (method, batch_key, n_pcs, etc.) batch_correction=False pools the samples without correction (shared genes, counts in layers['counts'], obs and coordinates kept), e.g. to pool sections for analyze_cell_communication.
Show 5 more tools
load_dataLoad spatial transcriptomics data with comprehensive metadata profile. Args: data_path: Path to data file or directory data_type: 'visium', 'xenium', 'slide_seq', 'merfish', 'seqfish', or 'generic' name: Optional dataset name Returns: SpatialDataset with cell/gene counts and metadata profiles
preprocess_dataRun QC, filtering, normalization, and highly variable gene selection. This tool does not compute PCA, UMAP, clustering, or neighbor graphs. Run compute_embeddings() afterward when downstream tools require those artifacts. Args: data_id: Dataset ID params: Preprocessing parameters (all have sensible defaults)
register_spatial_dataRegister/align spatial transcriptomics data across sections Args: source_id: Source dataset ID target_id: Target dataset ID to align to params: Registration parameters (method, alignment settings, etc.) Returns: Registration result with method, dataset IDs, spot counts, and registered spatial key
reload_dataReload dataset from disk after external script modifications. Args: data_id: Dataset ID to reload (must exist in MCP memory) path: Custom path (default: ~/.chatspatial/active/{data_id}.h5ad) Returns: Summary of reloaded dataset
visualize_dataVisualize spatial transcriptomics data. Set plot_type and subtype in params; see VisualizationParameters schema for all options. Args: data_id: Dataset ID params: Visualization parameters (plot_type, subtype, genes, output_format, dpi, etc.)
Signals
- Stars
- 45
- Forks
- 14
- Open issues
- 4
- Weekly downloads
- 311
- Last commit
- Oct 20, 2026 (19 days ago)
- Last release
- Oct 20, 2026 (19 days ago)
- Last package publish
- Oct 20, 2026 (19 days ago)
From GitHub (fetched Oct 24, 2026) and the package registry.
Details
- Registry name
io.github.cafferychen777/chatspatial- Version
- 1.6.0
- Auth
- No auth
- Packages
- pypi chatspatial
- License
- MIT
- Repository
- github.com/cafferychen777/ChatSpatial
- Website
- docs.cafferyang.com/
- First seen
- Oct 24, 2026
- Last checked
- Nov 1, 2026
Done for you
Rather not set it up yourself?
Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.
See how we build AI agents →Read the case studies
Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.
- launches shipped
- 50+
- launches shipped
- media placements
- 500+
- media placements
- founders on every account
- 2
- founders on every account
Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block
Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.
Get ChatSpatial running in your business
Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.
Cite this page
ChatSpatial MCP server. Agent Mart. https://agentmart.dev/connectors/cafferychen777-chatspatial (last updated 2026-11-01)