[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [NCBI GEO study details](https://spiral.ai/integrations/claude-code/ncbi-geo-study-details)

# How to Use NCBI GEO study details in Claude Code

Returns a GEO study's summary, overall design, samples, platforms, publication links, and supplementary files. Use it to judge whether an experiment fits your research question and locate its data.

|  |  |
| --- | --- |
| Model | NCBI GEO study details |
| Available through | Alexandria |
| Category | Health |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with NCBI GEO study details in Claude Code

- Use NCBI GEO study details for GSE2034 and create a Markdown study brief containing its summary, overall design, sample accessions, and supplementary file links.
- Use NCBI GEO study details to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from NCBI GEO study details and tell me what changed since last week.
- Check NCBI GEO study details and summarize what you find in three bullet points.
- Pull the newest data from NCBI GEO study details and give me the result as a table.

## How to set up NCBI GEO study details in Claude Code

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the hosted server**: This adds Spiral to the current project. Add `--scope user` to use it in every project.

```bash
claude mcp add --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `claude`, type `/mcp`, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

### Use the Spiral skill

1. **Send Claude Code this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run NCBI GEO study details**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "geo-ncbi-nlm-nih-gov/datasets/series",
    "input": {
      "accession": "<accession>"
    }
  }'
```

Then paste one of the prompts above: Claude Code finds NCBI GEO study details on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/claude-code

## NCBI GEO study details tools and prices

- [NCBI GEO · Series](https://spiral.ai/tools/alexandria/geo-ncbi-nlm-nih-gov/datasets/series) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| url |  | — | GEO accession viewer URL, e.g. `https://www.ncbi.nlm.nih.gov/geo/query/acc.cgi?acc=GSE2034`. Exactly one of `accession` and `url`. |
| accession |  | — | GEO GSE accession, e.g. `GSE2034` (case-insensitive). Exactly one of `accession` and `url`. Pattern: ^\s*[Gg][Ss][Ee][0-9]{1,9}\s*$. |
| sample_limit | 0 to 5000 | 500 | Most samples to list (`samples_truncated` says when more exist). |

## What can you do with NCBI GEO study details in Claude Code?

Build a documented study selection table for a genomics analysis project. A coding agent can turn GEO study descriptions, sample annotations, and platform details into files that explain which experiments the project includes.

### Choose a cohort for reanalysis

Find experiments on a specific disease and organism, inspect study designs, review sample characteristics, and identify measurement platforms. Produce an inclusion table with reasons for accepting or excluding each study.

### Check a paper's deposited experiment

Locate the GEO records behind a research question, inspect the deposited study design, and compare sample protocols and platform descriptions with the paper's methods. List discrepancies for scientific review.

### Screen studies for a meta-analysis

Find candidate studies, compare experimental designs, review tissue and treatment annotations, and separate measurement technologies. Build a study comparison table before deciding which experiments can be analyzed together.

### Document a public benchmark

Select a deposited experiment for a methods benchmark and document its study accession, sample selection, protocols, and platform. Include the available supplementary files so another researcher can inspect the same source material.

### Prepare sample comparison groups

Inspect a study's design, then review sample characteristics and processing protocols against its platform. Draft treatment and control assignments with the supporting annotations beside each decision.

### Maintain a research topic watch

Search regularly for experiments on a defined biological question. Review newly found studies, their sample annotations, and their platforms to prepare a digest explaining which deposits deserve closer inspection.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Claude Code guides](https://spiral.ai/integrations/claude-code)

## NCBI GEO study details in other agents

- [Amp](https://spiral.ai/integrations/amp/ncbi-geo-study-details)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/ncbi-geo-study-details)
- [Claude](https://spiral.ai/integrations/claude-desktop/ncbi-geo-study-details)
- [Cline](https://spiral.ai/integrations/cline/ncbi-geo-study-details)
- [Codex](https://spiral.ai/integrations/codex/ncbi-geo-study-details)
- [Cursor](https://spiral.ai/integrations/cursor/ncbi-geo-study-details)
- [Devin](https://spiral.ai/integrations/devin/ncbi-geo-study-details)
- [dots](https://spiral.ai/integrations/dots/ncbi-geo-study-details)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/ncbi-geo-study-details)
- [Gemini](https://spiral.ai/integrations/gemini/ncbi-geo-study-details)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/ncbi-geo-study-details)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/ncbi-geo-study-details)
- [goose](https://spiral.ai/integrations/goose/ncbi-geo-study-details)
- [Grok](https://spiral.ai/integrations/grok/ncbi-geo-study-details)
- [Grok Build](https://spiral.ai/integrations/grok-build/ncbi-geo-study-details)
- [Hermes](https://spiral.ai/integrations/hermes/ncbi-geo-study-details)
- [Instinct](https://spiral.ai/integrations/instinct/ncbi-geo-study-details)
- [Manus](https://spiral.ai/integrations/manus/ncbi-geo-study-details)
- [Muse](https://spiral.ai/integrations/muse/ncbi-geo-study-details)
- [Muse Code](https://spiral.ai/integrations/muse-code/ncbi-geo-study-details)
- [n8n](https://spiral.ai/integrations/n8n/ncbi-geo-study-details)
- [Notion](https://spiral.ai/integrations/notion/ncbi-geo-study-details)
- [OpenClaw](https://spiral.ai/integrations/openclaw/ncbi-geo-study-details)
- [opencode](https://spiral.ai/integrations/opencode/ncbi-geo-study-details)
- [Perplexity](https://spiral.ai/integrations/perplexity/ncbi-geo-study-details)
- [Raycast](https://spiral.ai/integrations/raycast/ncbi-geo-study-details)
- [VS Code](https://spiral.ai/integrations/vscode/ncbi-geo-study-details)
- [Windsurf](https://spiral.ai/integrations/windsurf/ncbi-geo-study-details)
- [Zapier](https://spiral.ai/integrations/zapier/ncbi-geo-study-details)

## More Claude Code guides

- [NCBI GEO sample details](https://spiral.ai/integrations/claude-code/ncbi-geo-sample-details)
- [NCBI GEO study search](https://spiral.ai/integrations/claude-code/ncbi-geo-study-search)
- [NCBI GEO platform details](https://spiral.ai/integrations/claude-code/ncbi-geo-platform-details)
- [NCBI Gene details](https://spiral.ai/integrations/claude-code/ncbi-gene-details)
- [Medicaid drug utilization and NADAC records](https://spiral.ai/integrations/claude-code/medicaid-drug-utilization-and-nadac-records)
- [NCBI Gene orthologs](https://spiral.ai/integrations/claude-code/ncbi-gene-orthologs)

## Questions about NCBI GEO study details in Claude Code

**Can Claude Code use NCBI GEO study details?**

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run NCBI GEO study details like any built-in tool.

**How much does NCBI GEO study details cost in Claude Code?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.

**Do I need an Alexandria account to use NCBI GEO study details in Claude Code?**

No. Spiral runs NCBI GEO study details on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up NCBI GEO study details in Claude Code?**

About two minutes: add the hosted server, then sign in.

**Does Claude Code wait while NCBI GEO study details runs?**

NCBI GEO study details runs in the background. Claude Code starts the run, checks on it and gives you the json when it's ready.

**What kinds of experiments does GEO cover?**

GEO archives microarray, next-generation sequencing, and other high-throughput functional genomics experiments submitted by researchers. Its coverage includes experimental data across organisms.

**How fresh is GEO's searchable data?**

GEO says its searchable database is updated daily. That describes database updates, not a daily revision of every study, sample, or platform record.

**Why might a GEO accession be unavailable?**

Researchers can receive an accession while records remain private before a manuscript or preprint becomes public. An accession in a draft therefore does not guarantee that its records are publicly accessible.

**Does every study have a curated DataSet?**

No. GEO explicitly says that not all Series have a corresponding curated DataSet, so restricting discovery to DataSet records can exclude submitted studies.

**Does NCBI verify the experimental findings?**

NCBI says it cannot independently verify the validity, quality, or biological significance of submitted GEO data. Study descriptions and sample annotations should be assessed alongside the experiment's methods.

