[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Particle podcast chart directory](https://spiral.ai/integrations/codex/particle-podcast-chart-directory)

# How to Use Particle podcast chart directory in Codex

Fetch the available podcast charts with their current leaders, edition dates, and explanation status. Use it to scan category leaders or find the chart to investigate next.

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

## Prompts to try with Particle podcast chart directory in Codex

- Use Particle podcast chart directory to populate our internal dashboard's entertainment section with current chart names, leaders, and edition dates.
- Use Particle podcast chart directory to add a summary of current sports chart leaders to our internal editorial page.
- Use Particle podcast chart 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 chart directory and tell me what changed since last week.
- Check Particle podcast chart directory and summarize what you find in three bullet points.

## How to set up Particle podcast chart directory in Codex

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

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex 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 chart 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/charts/list",
    "input": {
      "window": "7d"
    }
  }'
```

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

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

## Particle podcast chart directory tools and prices

- [Particle · Entity charts](https://spiral.ai/tools/alexandria/particle/charts/list) (Alexandria): $0.087295 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| window | 7d, 24h | 7d | Measurement window of the edition. Composite charts (all, all-entertainment, all-sports) publish 7d only. |

## What can you do with Particle podcast chart directory in Codex?

Build an internal editorial panel showing which subjects lead Particle's podcast charts. A coding agent can turn directory summaries and detailed standings into views that help editors choose stories.

### Choose an entertainment newsletter lead

Scan the movie, television, and gaming leaders, then examine a promising subject's chart movement and available explanation before choosing an editorial angle.

### Prepare a sports editorial meeting

Review league chart leaders, then investigate the teams, players, and events behind the strongest candidate stories.

### Research public guests for booking

Check who leads the guest chart, then compare public guests by the number of distinct shows on which they appeared.

### Review attention around a game launch

Check the video game chart leader and inspect the detailed standings for a released title. Use its podcast coverage as one input to an internal launch review.

### Maintain an internal daily briefing

Collect category leaders and selected detailed charts for an internal editorial briefing. Compare successive editions to identify changes worth investigating.

### Prioritize publicity research

Find which entertainment categories have relevant leaders, then inspect charted titles and available explanations to choose where a publicity team should investigate further.

## Overview

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

## Particle podcast chart directory in other agents

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

## More Codex guides

- [Particle podcast chart countries](https://spiral.ai/integrations/codex/particle-podcast-chart-countries)
- [Particle podcast chart history](https://spiral.ai/integrations/codex/particle-podcast-chart-history)
- [Particle podcast chart categories](https://spiral.ai/integrations/codex/particle-podcast-chart-categories)
- [Particle podcast chart movers](https://spiral.ai/integrations/codex/particle-podcast-chart-movers)
- [Particle podcast advertising profile](https://spiral.ai/integrations/codex/particle-podcast-advertising-profile)
- [Particle podcast chart presence summary](https://spiral.ai/integrations/codex/particle-podcast-chart-presence-summary)

## Questions about Particle podcast chart directory in Codex

**Can Codex use Particle podcast chart directory?**

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

**How much does Particle podcast chart directory cost in Codex?**

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

**Do I need an Alexandria account to use Particle podcast chart directory in Codex?**

No. Spiral runs Particle podcast chart 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 chart directory in Codex?**

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

**Does Codex wait while Particle podcast chart directory runs?**

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

**How broad is Particle's podcast coverage?**

Particle advertises more than 165,000 searchable podcasts. That corpus size does not establish complete coverage of every show or its historical episodes.

**How often do the podcast charts change?**

Rankings and counts update once a day. Explanations can fill in afterward, so an edition can gain context without changing its positions.

**Does first place mean the most mentions?**

Particle measures unusual increases against each subject's own history, rather than ranking solely by mention totals. The guest chart uses a different measure: distinct shows on which someone appeared.

**Do advertising mentions count?**

Particle's mention charts count organic dialogue outside ad reads. A brand's advertising activity therefore does not directly represent its position in these charts.

**How much detail can I retrieve?**

The directory gives edition summaries and first-place subjects. A detailed chart returns up to 100 entries, and neither response uses cursor pagination.

