[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [Particle podcast episode directory](https://spiral.ai/integrations/claude-code/particle-podcast-episode-directory)

# How to Use Particle podcast episode directory in Claude Code

Returns episode metadata, including publication dates, durations, speakers, and indicators of available analysis. Use it to find episodes by show or subject when you need a reading list rather than matching dialogue.

|  |  |
| --- | --- |
| Model | Particle podcast episode directory |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Particle podcast episode directory in Claude Code

- Use Particle podcast episode directory to fetch recent Pivot episodes and adapt our existing results component to show titles, publication dates, and durations.
- Use Particle podcast episode directory to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Particle podcast episode directory and tell me what changed since last week.
- Check Particle podcast episode directory and summarize what you find in three bullet points.
- Pull the newest data from Particle podcast episode directory and give me the result as a table.

## How to set up Particle podcast episode directory 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 Particle podcast episode directory**: 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": "particle/podcasts/episodes/list",
    "input": {
      "role": "guest"
    }
  }'
```

Then paste one of the prompts above: Claude Code finds Particle podcast episode directory on Spiral, shows the price and runs it.

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

## Particle podcast episode directory tools and prices

- [Particle · Episode directory](https://spiral.ai/tools/alexandria/particle/podcasts/episodes/list) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| role | guest, host, panelist, correspondent, speaker, mention | — | How the entity must relate to the episode: a speaking role, speaker for any speaking role, or mention for being talked about. |
| limit | 1 to 100 | 25 | Maximum records to return. |
| cursor |  | — | Opaque cursor from a previous page. Omit for the first page; send the same filters with it. |
| language |  | — | ISO 639-1 language code, for example en or fr. Matches the primary subtag, so fr covers fr-CA. |
| entity_id |  | — | Episodes featuring this entity as a speaker or a mention, by slug (elon-musk, openai) or id. |
| person_id |  | — | Episodes where this person speaks, by person slug, entity slug or id. Works when the speaker has no knowledge-graph entity. |

## What can you do with Particle podcast episode directory in Claude Code?

Build a podcast research view that connects show identities, episode records, dialogue, and publisher context. Use Particle data to populate the project's research screens and distinguish newly processed material from historical publication activity.

### Prepare a topic desk briefing

Build a climate-policy show shortlist, inspect relevant episodes and publishers, follow newly processed releases, and compare episode volume with matching discussions.

### Review a company's public podcast coverage

For a company such as NVIDIA, find relevant episodes, read the surrounding discussion, compare mention volume, and identify the publishers behind the coverage.

### Create a current episode reading queue

Choose shows by topic and format, resolve supplied show and episode links, inspect episode metadata, and check for newly processed additions.

### Verify podcast references in a research brief

Resolve supplied platform links, confirm episode and show identities, inspect publication metadata, and establish the publisher behind each source.

## Overview

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

## Particle podcast episode directory in other agents

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

## More Claude Code guides

- [Particle podcast episode details](https://spiral.ai/integrations/claude-code/particle-podcast-episode-details)
- [Particle podcast episode entities](https://spiral.ai/integrations/claude-code/particle-podcast-episode-entities)
- [Particle podcast episode clips](https://spiral.ai/integrations/claude-code/particle-podcast-episode-clips)
- [Particle podcast episode lookup](https://spiral.ai/integrations/claude-code/particle-podcast-episode-lookup)
- [Particle podcast episode ads](https://spiral.ai/integrations/claude-code/particle-podcast-episode-ads)
- [Particle podcast episode segments](https://spiral.ai/integrations/claude-code/particle-podcast-episode-segments)

## Questions about Particle podcast episode directory in Claude Code

**Can Claude Code use Particle podcast episode directory?**

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Particle podcast episode directory like any built-in tool.

**How much does Particle podcast episode directory 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 Particle podcast episode directory in Claude Code?**

No. Spiral runs Particle podcast episode directory on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Particle podcast episode directory in Claude Code?**

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

**Does Claude Code wait while Particle podcast episode directory runs?**

Particle podcast episode directory runs in the background. Claude Code starts the run, checks on it and gives you the json when it's ready.

**Does Particle cover every podcast?**

Particle describes coverage of the Apple Podcasts Top 200 across more than 130 English-language verticals, plus independent shows. That coverage statement does not establish complete coverage of every podcast or language.

**How quickly does new podcast data appear?**

Every tracked show's feed is checked at least every two days. After discovery, transcription and enrichment take minutes to hours, so publication and searchable availability can differ.

**How far back does the data go?**

Particle's transcribed episode history reaches back to 2017. Coverage varies by show, and an older episode discovered in a feed may still lack a transcript.

**Does an episode record guarantee that its dialogue is searchable?**

No. Particle also holds discovered episodes without transcripts; those records have no transcript-derived speakers, entities, segments, or clips.

**Will following new episodes also retrieve a show's complete archive?**

No. Particle excludes bulk historical imports from its episode feed, while keeping those episodes available through search and episode listings.

