How to Use NCBI GEO study search in Hermes
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.
Prompts to try with NCBI GEO study search in Hermes
Copy an example into Hermes, or ask in your own words.
Every Monday, use NCBI GEO study search to find human breast cancer sequencing studies made public in the previous week. Report newly found accessions, titles, and summaries.
Every Friday, use NCBI GEO study search to find mouse liver expression studies made public during the previous seven days. Prepare a digest of their accessions, titles, and summaries.
Every Monday at 9am: use NCBI GEO study search to look this up and give me the result as a table.
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 Hermes
Pick the way that suits you. Each takes about two minutes.
Use the Spiral skill
- Send Hermes this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use Spiral's MCP server
- Add the server and sign in
Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? \[Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.
hermes mcp add spiral \ --url https://api.spiral.ai/mcp \ --auth oauth \ --connect-timeout 300
- Check it
In a chat that was already open, run /reload-mcp.
hermes mcp list hermes mcp test spiral
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run NCBI GEO study search
One request; the result comes back by polling or a webhook.
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: Hermes finds NCBI GEO study search on Spiral, shows the price and runs it.
NCBI GEO study search providers and prices
Spiral runs NCBI GEO study search through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Hermes for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Limit | 1 to 50 | 20 | Results per page. |
| Offset | 0 to 1000000 | 0 | Zero-based index of the first result. |
| Entry type | GSE, GDS, GPL, GSM, or all | GSE | Record type: |
Every API field of NCBI GEO · Search is on its tool page: open its card above.
What can you do with NCBI GEO study search in Hermes?
Maintain a digest of GEO experiments relevant to a research topic. A scheduled agent can find newly public studies and revisit selected study, sample, and platform records to report changes in their descriptions.
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.
More on NCBI GEO study search and Hermes
Overview
NCBI GEO study search in other agents
Questions about NCBI GEO study search in Hermes
Can Hermes use NCBI GEO study search?
Yes. Add Spiral to Hermes as an MCP server, and Hermes can find and run NCBI GEO study search like any built-in tool.
How much does NCBI GEO study search cost in Hermes?
$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Hermes plan is separate.
Do I need an Alexandria account to use NCBI GEO study search in Hermes?
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 Hermes?
About two minutes: add the server and sign in, then check it.
Does Hermes wait while NCBI GEO study search runs?
NCBI GEO study search runs in the background. Hermes 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.
Start using NCBI GEO study search in Hermes
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Hermes:
set up https://spiral.ai/SKILL.md


