[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [Openverse related audio](https://spiral.ai/integrations/claude-code/openverse-related-audio)

# How to Use Openverse related audio in Claude Code

Openverse related audio returns suggested recordings for a selected audio track, with their metadata and source links. Use it to explore alternatives after finding a promising clip.

|  |  |
| --- | --- |
| Model | Openverse related audio |
| Available through | Alexandria |
| Category | News & Media |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Openverse related audio in Claude Code

- Use Openverse related audio for https://openverse.org/audio/8624ba61-57f1-4f98-8a85-ece206c319cf/ and add suggested alternatives to this project’s audio review table with their source links and listed licenses.
- Use Openverse related audio to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Openverse related audio and tell me what changed since last week.
- Check Openverse related audio and summarize what you find in three bullet points.
- Pull the newest data from Openverse related audio and give me the result as a table.

## How to set up Openverse related audio 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 Openverse related audio**: 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": "openverse-org/audio-assets/related_audio",
    "input": {
      "id": "<id>"
    }
  }'
```

Then paste one of the prompts above: Claude Code finds Openverse related audio on Spiral, shows the price and runs it.

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

## Openverse related audio tools and prices

- [Openverse · Related audio](https://spiral.ai/tools/alexandria/openverse-org/audio-assets/related_audio) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| id |  | — | Openverse audio UUID, e.g. eab8a6e2-0ac8-4615-9e0d-ebde30523783. |
| url |  | — | An openverse.org/audio/<id> page or api.openverse.org/v1/audio/<id>/ URL, used when id is absent. |

## What can you do with Openverse related audio in Claude Code?

Build an audio candidate list for your project with recording links, creators, and draft credits. A coding agent can turn Openverse records into a review screen or an asset manifest tied to the scenes that need sound.

### Build a podcast sound shortlist

Compare indexed collections, search for rain and station ambience, explore suggestions from a promising recording, and inspect the selected clips’ source links and attribution for production review.

### Choose sounds for a game prototype

Review available collections, find footsteps and door sounds, explore related recordings, and assemble a candidate list with file links, creators, and licenses for review.

### Prepare audio for a classroom lesson

Compare collection coverage, search for birdsong and ocean recordings, inspect related suggestions, and prepare a listening list with original source pages and draft credits.

### Research a documentary sound palette

Review indexed collections, search for train and harbor sounds, explore alternatives from selected tracks, and inspect recording metadata before sending candidates to an editor.

### Find replacement audio candidates

Explore suggestions from a previously selected track and run a fresh descriptive search. Inspect each candidate’s source and license before approving a replacement.

## Overview

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

## Openverse related audio in other agents

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

## More Claude Code guides

- [Openverse audio sources](https://spiral.ai/integrations/claude-code/openverse-audio-sources)
- [Poly Haven asset categories](https://spiral.ai/integrations/claude-code/poly-haven-asset-categories)
- [Openverse audio search](https://spiral.ai/integrations/claude-code/openverse-audio-search)
- [Poly Haven asset downloads](https://spiral.ai/integrations/claude-code/poly-haven-asset-downloads)
- [Openverse audio details](https://spiral.ai/integrations/claude-code/openverse-audio-details)
- [Poly Haven asset search](https://spiral.ai/integrations/claude-code/poly-haven-asset-search)

## Questions about Openverse related audio in Claude Code

**Can Claude Code use Openverse related audio?**

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Openverse related audio like any built-in tool.

**How much does Openverse related audio 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 Openverse related audio in Claude Code?**

No. Spiral runs Openverse related audio on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Openverse related audio in Claude Code?**

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

**Does Claude Code wait while Openverse related audio runs?**

Openverse related audio runs in the background. Claude Code starts the run, checks on it and gives you the json when it's ready.

**Does Openverse host the original recordings?**

Openverse aggregates metadata for recordings hosted on third-party websites. Its audio records include the original landing page and a file URL.

**Does an Openverse listing prove that I can reuse a recording?**

No. Openverse explicitly says it does not verify licensing status, so the listed license must be checked against the original source before reuse.

**What do the collection totals measure?**

They count media items indexed by Openverse from each source. They are catalog counts, so they do not establish the complete size of a source website’s audio collection.

**Can I copy the entire catalog through repeated requests?**

Openverse’s terms prohibit scraping the catalog. Use the data to find and inspect recordings for a specific project.

**Does the timestamp tell me when a recording was published?**

The indexing timestamp tells you when Openverse indexed the media. It does not establish the recording’s original publication date.

