Spiral gives your agent every tool with one account. Browse the tools →

Cursor · Industry Data

How to Use MorphoSource specimen search in Cursor

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 Cursor

Copy an example into Cursor, 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.

MorphoSource specimen searchCursor
Try asking
  • 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 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):

    {
      "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.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. 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: Cursor 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.

AlexandriaIndustry Data
MorphoSource · Search objects
morphosource-org/specimens/search_objects

Settings you can ask for

Ask Cursor for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Page1 to 100001

1-based page; pass the previous next_page.

Limit1 to 5010

limit

Object typeBiological 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 Cursor?

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.

Questions about MorphoSource specimen search in Cursor

Can Cursor use MorphoSource specimen search?

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

How much does MorphoSource specimen 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 MorphoSource specimen search in Cursor?

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 Cursor?

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

Does Cursor wait while MorphoSource specimen search runs?

MorphoSource specimen search runs in the background. Cursor 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.

Get started

Start using MorphoSource specimen search in Cursor

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Cursor:

Set up Cursor

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options