[Integrations](https://spiral.ai/integrations) › [Muse Code](https://spiral.ai/integrations/muse-code) › [ccMixter music search](https://spiral.ai/integrations/muse-code/ccmixter-music-search)

# How to Use ccMixter music search in Muse Code

Find ccMixter music, vocals, samples, and stems with attribution, audio details, and file links. Use it to compare candidates for a soundtrack or remix before choosing a specific upload.

|  |  |
| --- | --- |
| Model | ccMixter music search |
| 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 ccMixter music search in Muse Code

- Use ccMixter music search to find five ambient instrumental candidates for the forest scene described in this project's design document. Add their source links, licenses, durations, and attribution to a review table.
- Use ccMixter music search to find vocals by snowflake for a remix prototype. Create a table of titles, reported BPM, available file formats, and licenses.
- Use ccMixter music search to find instrumental hip-hop candidates for this game's menu. Include only licenses that allow commercial use and add the returned credits to the soundtrack proposal.
- Use ccMixter music search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from ccMixter music search and tell me what changed since last week.

## How to set up ccMixter music search in Muse Code

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

### Use Spiral's MCP server

1. **Install Muse Code**

```bash
curl -fsSL https://dev.meta.ai/install.sh | bash
```

2. **Ask Muse to add the server**: Start `muse` and ask:

```text
Add the Spiral MCP server at https://api.spiral.ai/mcp
```

3. **Sign in**: In your terminal, run:

```bash
muse mcp login spiral
```

### Use the Spiral skill

1. **Send Muse 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 ccMixter music 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": "ccmixter-org/audio-assets/search_uploads",
    "input": {
      "url": "<url>"
    }
  }'
```

Then paste one of the prompts above: Muse Code finds ccMixter music search on Spiral, shows the price and runs it.

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

## ccMixter music search tools and prices

- [ccMixter · Search uploads](https://spiral.ai/tools/alexandria/ccmixter-org/audio-assets/search_uploads) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| url |  | — | A ccmixter.org/api/query URL; its tags, reqtags, type, lic, search, user, sort, ord, limit and offset are read. Explicit inputs override it. |
| sort | newest, oldest, rank, score, num_scores, remixes, num_playlists, name | — | newest (default), oldest, rank (ccMixter's popularity rank), score (ratings), num_scores (number of ratings), remixes (most remixed), num_playlists or name (A to Z). |
| tags |  | — | Tags every result must have, e.g. ["acappella"], ["stem", "instrumental"], ["sample"] or a tempo bucket such as ["bpm_110_115"] (5-BPM buckets, three digits below 100: bpm_090_095). |
| user |  | — | Only uploads by this ccMixter login name, e.g. JeffSpeed68. |
| limit | 1 to 10 | — | Uploads per page, 1 to 10 (default 10). ccMixter fails on larger pages; an oversized page is retried at half size. |
| query |  | — | Words to search for in titles, artists and descriptions (all words must match). |

## What can you do with ccMixter music search in Muse Code?

Build a music selection table with ccMixter file links, durations, BPM, and credits. A coding agent can put those details into the project's asset list and attribution file.

### Choose music for a podcast

Find instrumental candidates, compare their durations and licenses, and prepare attribution for the selected intro or background track.

### Prepare a game soundtrack

Compare ambient or electronic music for a game scene, then inspect the chosen upload's files and credit requirements.

### Find material for a remix

Locate vocals, samples, or stems, then inspect the available file formats, BPM, and attribution before planning the arrangement.

### Build a documentary music shortlist

Collect candidate tracks with durations, source links, and licenses so an editor can audition them and prepare credits.

### Replace music restricted to noncommercial use

Check a selected track's license and compare replacements whose licenses permit the intended commercial project.

### Prepare music credits

Collect attribution and license links for tracks under consideration, then assemble the credits for the final selections.

### Plan a tempo-matched arrangement

Compare reported BPM values and available files when selecting vocals or instrumental material for a remix.

## Overview

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

## ccMixter music search in other agents

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

## More Muse Code guides

- [ambientCG asset search](https://spiral.ai/integrations/muse-code/ambientcg-asset-search)
- [ccMixter track details](https://spiral.ai/integrations/muse-code/ccmixter-track-details)
- [ambientCG asset details](https://spiral.ai/integrations/muse-code/ambientcg-asset-details)
- [gob.mx agency directory](https://spiral.ai/integrations/muse-code/gob-mx-agency-directory)
- [ambientCG asset collections](https://spiral.ai/integrations/muse-code/ambientcg-asset-collections)
- [gob.mx articles and documents](https://spiral.ai/integrations/muse-code/gob-mx-articles-and-documents)

## Questions about ccMixter music search in Muse Code

**Can Muse Code use ccMixter music search?**

Yes. Add Spiral to Muse Code as an MCP server, and Muse Code can find and run ccMixter music search like any built-in tool.

**How much does ccMixter music search cost in Muse 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 Muse Code plan is separate.

**Do I need an Alexandria account to use ccMixter music search in Muse Code?**

No. Spiral runs ccMixter music 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 ccMixter music search in Muse Code?**

About two minutes: install Muse Code, then ask Muse to add the server, then sign in.

**Does Muse Code wait while ccMixter music search runs?**

ccMixter music search runs in the background. Muse Code starts the run, checks on it and gives you the json when it's ready.

**What music does ccMixter cover?**

ccMixter is a community remixing catalog containing Creative Commons remixes and samples. Its coverage centers on music contributed to that community.

**Does a ccMixter listing guarantee that all rights are cleared?**

No. ccMixter's terms explicitly decline to guarantee that uploaded content does not infringe third-party rights.

**Does ccMixter include older recordings?**

Yes. For example, grapes' 'I dunno' remains listed as a 2008 work under Attribution 3.0.

**Why might a returned download link fail?**

The provider warns that ccMixter protects file links against hotlinking. A direct request without a ccmixter.org referrer can return HTTP 403; use the track page to access its download.

