[Integrations](https://spiral.ai/integrations) › [Windsurf](https://spiral.ai/integrations/windsurf) › [Discogs artist discography](https://spiral.ai/integrations/windsurf/discogs-artist-discography)

# How to Use Discogs artist discography in Windsurf

Returns paginated releases and master records associated with a Discogs artist, including titles, years, and credit roles. Use it to explore an artist’s catalog before opening individual editions.

|  |  |
| --- | --- |
| Model | Discogs artist discography |
| Available through | Alexandria |
| Category | E-commerce |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Discogs artist discography in Windsurf

- Use Discogs artist discography for Daft Punk and compare the returned titles and years with our discography JSON. Report unmatched titles and distinguish master records from individual releases.
- Use Discogs artist discography to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Discogs artist discography and tell me what changed since last week.
- Check Discogs artist discography and summarize what you find in three bullet points.
- Pull the newest data from Discogs artist discography and give me the result as a table.

## How to set up Discogs artist discography in Windsurf

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

### Use Spiral's MCP server

1. **Add the server**: Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: `~/.config/devin/mcp_config.json` on macOS and Linux, `%APPDATA%\devin\mcp_config.json` on Windows. Add this:

```json
{
  "mcpServers": {
    "spiral": {
      "url": "https://api.spiral.ai/mcp"
    }
  }
}
```

2. **Sign in**: Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

```bash
devin mcp login spiral
```

3. **Check it**: Spiral is listed under This computer in Customize › MCPs. From the terminal:

```bash
devin mcp list
```

### Use the Spiral skill

1. **Send Windsurf 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 Discogs artist discography**: 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": "discogs-com/releases/artist_releases",
    "input": {
      "artist_id": 1
    }
  }'
```

Then paste one of the prompts above: Windsurf finds Discogs artist discography on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/windsurf

## Discogs artist discography tools and prices

- [Discogs · Artist releases](https://spiral.ai/tools/alexandria/discogs-com/releases/artist_releases) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| page | 1 to 10000 | 1 | Result page, 1-based. |
| sort | year, title, format | — | Sort field. |
| per_page | 1 to 100 | 25 | Results per page, 1 to 100. |
| sort_order | asc, desc | — | sort_order |

## What can you do with Discogs artist discography in Windsurf?

Build a music catalog checker that separates artist identities, label identities, master records, and individual editions. A coding agent can compare Discogs metadata with project files and flag ambiguous matches for review.

### Research an artist’s discography

Check the artist’s identity and aliases, work through their catalog, and separate master records from individual editions. Use release details to investigate titles that need closer inspection.

### Check an album research brief

Cross-check artist and label identities against their catalogs, then use the master overview and an individual release’s tracklist to support the brief. Keep edition-specific details attached to the edition that supplied them.

### Explain the differences in a reissue

Place a reissue in the artist’s and label’s catalogs, inspect the master overview, and compare edition records. Draft a comparison using documented formats, release markets, tracklists, and notes.

### Review artist and label identity matches

Check whether catalog entries point to the intended artist and imprint. Compare profiles, aliases, label relationships, and associated releases to flag matches that need manual review.

### Prepare a catalog update digest

Recheck selected public artists, labels, and albums and summarize relevant catalog changes. Describe newly discovered Discogs entries separately from their recorded release dates.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Windsurf guides](https://spiral.ai/integrations/windsurf)

## Discogs artist discography in other agents

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

## More Windsurf guides

- [Dell support product search](https://spiral.ai/integrations/windsurf/dell-support-product-search)
- [Discogs artist profile](https://spiral.ai/integrations/windsurf/discogs-artist-profile)
- [Dell support documents](https://spiral.ai/integrations/windsurf/dell-support-documents)
- [Discogs database search](https://spiral.ai/integrations/windsurf/discogs-database-search)
- [Dell product search](https://spiral.ai/integrations/windsurf/dell-product-search)
- [Discogs label catalog](https://spiral.ai/integrations/windsurf/discogs-label-catalog)

## Questions about Discogs artist discography in Windsurf

**Can Windsurf use Discogs artist discography?**

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Discogs artist discography like any built-in tool.

**How much does Discogs artist discography cost in Windsurf?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Windsurf plan is separate.

**Do I need an Alexandria account to use Discogs artist discography in Windsurf?**

No. Spiral runs Discogs artist discography on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Discogs artist discography in Windsurf?**

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

**Does Windsurf wait while Discogs artist discography runs?**

Discogs artist discography runs in the background. Windsurf starts the run, checks on it and gives you the json when it's ready.

**What kinds of recordings does Discogs cover?**

Discogs catalogs audio releases made available to the general public, including commercially sold releases and free giveaways. That is its submission boundary, rather than a promise that every eligible release has been entered.

**How quickly can Discogs information change?**

Submitted information goes live immediately. A newly appearing catalog entry can therefore be an older recording that someone has just documented.

**Does Discogs include artists and labels without cataloged releases?**

Artists and labels are created through release submissions and cannot be added directly. Discogs is therefore tied to documented releases rather than a standalone directory of every artist or music business.

**What does a release’s country mean?**

Discogs uses country for the market where a release was sold and distributed. It does not necessarily identify where the record was manufactured.

**Does a master record describe one exact pressing?**

A master collects two or more matching releases. Its displayed tracklist comes from a selected key release, so consult an individual release record when checking an edition’s tracks.

