[Integrations](https://spiral.ai/integrations) › [Cursor](https://spiral.ai/integrations/cursor) › [NCBI GEO study search](https://spiral.ai/integrations/cursor/ncbi-geo-study-search)

# How to Use NCBI GEO study search in Cursor

Returns matching GEO records with summaries and accessions for studies, curated DataSets, platforms, or samples. Use it to find experiments relevant to a biological question before inspecting their design.

|  |  |
| --- | --- |
| Model | NCBI GEO study search |
| 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 search in Cursor

- Use NCBI GEO study search to find human breast cancer expression studies released in 2024, then write a candidate study table in this project's research directory.
- Use NCBI GEO study search to find mouse liver expression studies, then create a review table with accession, title, organism, and study summary.
- Use NCBI GEO study search 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 search and tell me what changed since last week.
- Check NCBI GEO study search and summarize what you find in three bullet points.

## How to set up NCBI GEO study search in Cursor

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

### Use Spiral's MCP server

1. **Add the hosted server**: Use Add to Cursor on the console's Agents & MCP page, or add this to `.cursor/mcp.json` (one project) or `~/.cursor/mcp.json` (every project):

```json
{
  "mcpServers": {
    "spiral": { "url": "https://api.spiral.ai/mcp" }
  }
}
```

2. **Sign in**: Open Cursor Settings › MCP, click Connect next to spiral, sign in to Spiral and click Authorize. No API key. Spiral then shows as connected, with its tools listed.

### Use the Spiral skill

1. **Send Cursor 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 search**: 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/search",
    "input": {
      "limit": 20
    }
  }'
```

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

Setup guide in the docs: https://spiral.ai/docs/quickstarts/cursor

## NCBI GEO study search tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| limit | 1 to 50 | 20 | Results per page. |
| query |  | — | Entrez query over GEO DataSets: free text or field-tagged terms such as `brca1[Gene Name]`, `liver[Title]`, `smith j[Author]`, with AND/OR/NOT. Optional when a filter is given. |
| offset | 0 to 1000000 | 0 | Zero-based index of the first result. |
| max_date |  | — | Latest release (public) date, same forms as `min_date`. Pattern: ^[0-9]{4}(/[0-9]{2}(/[0-9]{2})?)?$. |
| min_date |  | — | Earliest release (public) date, `YYYY`, `YYYY/MM` or `YYYY/MM/DD`. Pattern: ^[0-9]{4}(/[0-9]{2}(/[0-9]{2})?)?$. |
| organism |  | — | Organism, scientific or common name (`Homo sapiens`, `mouse`); includes sub-taxa. |

## What can you do with NCBI GEO study search in Cursor?

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.

### 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 Cursor guides](https://spiral.ai/integrations/cursor)

## NCBI GEO study search in other agents

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

## More Cursor guides

- [NCBI GEO study details](https://spiral.ai/integrations/cursor/ncbi-geo-study-details)
- [NCBI Gene details](https://spiral.ai/integrations/cursor/ncbi-gene-details)
- [NCBI GEO sample details](https://spiral.ai/integrations/cursor/ncbi-geo-sample-details)
- [NCBI Gene orthologs](https://spiral.ai/integrations/cursor/ncbi-gene-orthologs)
- [NCBI GEO platform details](https://spiral.ai/integrations/cursor/ncbi-geo-platform-details)
- [NCBI Gene search results](https://spiral.ai/integrations/cursor/ncbi-gene-search-results)

## Questions about NCBI GEO study search in Cursor

**Can Cursor use NCBI GEO study search?**

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

**How much does NCBI GEO study search cost in Cursor?**

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

**Do I need an Alexandria account to use NCBI GEO study search in Cursor?**

No. Spiral runs NCBI GEO study search 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 search in Cursor?**

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

**Does Cursor wait while NCBI GEO study search runs?**

NCBI GEO study search runs in the background. Cursor 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.

