strand-mcp 0.1.0

MCP server for the Strand Platform — exposes upload / predict / job lifecycle to Claude, Cursor, and any other MCP-aware agent.

strand-mcp

MCP server for the Strand Platform. Exposes upload / estimate / predict / job-lifecycle as MCP tools so any agent (Claude Code, Cursor, etc.) can run H&E → spatial-proteomics inference end-to-end.

Install

pip install strand-mcp

Or from this repo:

cd sdks/mcp-server
pip install -e .

Auth

Generate an API key at https://app.strandai.com/settings/api-keys and export it:

export STRAND_API_KEY=sk-strand-...

The server also reads STRAND_BASE_URL (defaults to https://app.strandai.com) if you need to point at staging.

Wire into Claude Code

Add to ~/.claude/mcp.json (or your project's .mcp.json):

{
  "mcpServers": {
    "strand": {
      "command": "strand-mcp",
      "env": {
        "STRAND_API_KEY": "sk-strand-..."
      }
    }
  }
}

Then in Claude Code you can ask things like:

Upload ~/slides/biopsy.svs to Strand, run prediction for CD3, CD8, and Ki67, wait for the job, and download results into ~/results/.

Claude calls the tools in sequence — no glue code needed.

Tools

Tool	Purpose
upload_slide	Upload a local WSI; returns upload_id + dimensions
estimate_run	Patch count + credit cost for a (upload_id, markers) pair
set_sample_mpp	Set user-reported slide microns per pixel before inference
submit_run	Kick off a Lattice inference job; returns job_id
get_job	Point-in-time status snapshot
cancel_job	Cancel an in-flight job and refund its reserved credits
wait_for_job	Block until terminal state (uses SSE under the hood)
download_results	Pull OME-Zarr results into a local directory
download_ome_tiff	Render and download a completed job as a single OME-TIFF file

Smoke test

STRAND_API_KEY=sk-strand-... strand-mcp

The server listens on stdio and waits for an MCP client to attach.

Dev

cd sdks/mcp-server
pip install -e ".[dev]" || pip install -e .
python -m strand_mcp