How to Use MorphoSource specimen search in Claude Code
Finds MorphoSource physical object records for specimens and cultural heritage objects. Use it to build a candidate list by taxon, catalog reference, or institution before examining individual records.
Prompts to try with MorphoSource specimen search in Claude Code
Copy an example into Claude Code, or ask in your own words.
Use MorphoSource specimen search to find Fruitadens records and create a CSV in this project with the returned object identifiers and specimen titles.
Use MorphoSource specimen search for Chamaeleo calyptratus and compare the returned specimen identities with this project's sample spreadsheet.
Use MorphoSource specimen search for Puma concolor and build a table of returned specimens and holding organizations for our anatomy study.
Use MorphoSource specimen search to look this up and give me the result as a table. Save the result in ./assets.
Pull the latest numbers from MorphoSource specimen search and tell me what changed since last week.
How to set up MorphoSource specimen search in Claude Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
This adds Spiral to the current project. Add --scope user to use it in every project.
claude mcp add --transport http spiral https://api.spiral.ai/mcp
- 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
- Send Claude Code 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 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 MorphoSource specimen 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": "morphosource-org/specimens/search_objects", "input": { "page": 1 } }'
Then paste one of the prompts above: Claude Code finds MorphoSource specimen search on Spiral, shows the price and runs it.
MorphoSource specimen search providers and prices
Spiral runs MorphoSource specimen search through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Claude Code for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Page | 1 to 10000 | 1 | 1-based page; pass the previous next_page. |
| Limit | 1 to 50 | 10 | limit |
| Object type | Biological Specimen or Cultural Heritage Object | object_type |
Every API field of MorphoSource · Search objects is on its tool page: open its card above.
What can you do with MorphoSource specimen search in Claude Code?
Create a specimen reference table for a research project from MorphoSource identities, taxonomy, and holding organizations. Compare those records with the project's sample spreadsheet to flag mismatches before analysis.
Build a comparative anatomy sample list
Find candidate Puma concolor specimens, then inspect their taxonomy and holding organizations to prepare a sample list for an anatomy study.
Check specimen references in a manuscript
Resolve catalog references against MorphoSource and compare the resulting specimen identities with a manuscript's materials table.
Prepare a museum teaching shortlist
Find Chamaeleo calyptratus records and prepare specimen identity cards with taxonomy and holding institutions before choosing teaching media.
Reconcile a collection spreadsheet
Compare institutional catalog references with MorphoSource specimen records and flag identity discrepancies for collection staff to review.
Review taxonomy changes
Compare a saved Fruitadens specimen list with current MorphoSource records to identify changes in recorded taxonomy.
Separate specimens from scan inventories
Resolve the physical object identities behind a scan inventory so a research report can distinguish specimen counts from media counts.
More on MorphoSource specimen search and Claude Code
Overview
MorphoSource specimen search in other agents
Questions about MorphoSource specimen search in Claude Code
Can Claude Code use MorphoSource specimen search?
Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run MorphoSource specimen search like any built-in tool.
How much does MorphoSource specimen search 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 MorphoSource specimen search in Claude Code?
No. Spiral runs MorphoSource specimen 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 MorphoSource specimen search in Claude Code?
About two minutes: add the hosted server, then sign in.
Does Claude Code wait while MorphoSource specimen search runs?
MorphoSource specimen search runs in the background. Claude Code starts the run, checks on it and gives you the json when it's ready.
Does MorphoSource cover cultural heritage objects as well as biological specimens?
Yes. MorphoSource separates physical objects into biological specimens and cultural heritage objects, so a search across physical objects can include either category.
Does one specimen record mean one scan?
No. A single physical object can have several media records, including scans of different body parts. Count physical objects when you need a specimen count.
Where does the specimen metadata come from?
MorphoSource recommends importing specimen metadata from iDigBio or GBIF. Contributors can supply the information when importing is not possible, so records can have different provenance.
How do museum records reach MorphoSource after a specimen was added manually?
MorphoSource periodically links user-created records to museum-authored records when museums publish new records in iDigBio. This is a periodic reconciliation process.
Will every specimen have a catalog number and occurrence ID?
Neither identifier is guaranteed. MorphoSource does not require catalog numbers, and its occurrence ID documentation explicitly allows that value to be absent.
Start using MorphoSource specimen search in Claude Code
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Claude Code:
set up https://spiral.ai/SKILL.md


