How to Use Particle podcast episode directory in Codex
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.
Prompts to try with Particle podcast episode directory in Codex
Copy an example into Codex, or ask in your own words.
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 Codex
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
codex mcp add spiral --url https://api.spiral.ai/mcp
- Sign in
Codex opens the browser: sign in to Spiral and click Authorize. No API key. codex mcp list then shows Spiral.
codex mcp login spiral
Use the Spiral skill
- Send Codex this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Particle podcast episode directory
One request; the result comes back by polling or a webhook.
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: Codex finds Particle podcast episode directory on Spiral, shows the price and runs it.
Particle podcast episode directory providers and prices
Spiral runs Particle podcast episode directory through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Codex for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Role | guest, host, panelist, correspondent, speaker, or 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. |
| Max duration | 0 to 9223372036 | Maximum length in seconds. | |
| Min duration | 0 to 9223372036 | Minimum length in seconds. | |
| Fully ingested | on or off | Only episodes that reached the terminal ingestion milestone. | |
| Has transcript | on or off | Only episodes with a completed transcript. |
Every API field of Particle · Episode directory is on its tool page: open its card above.
What can you do with Particle podcast episode directory in Codex?
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.
More on Particle podcast episode directory and Codex
Overview
Particle podcast episode directory in other agents
Questions about Particle podcast episode directory in Codex
Can Codex use Particle podcast episode directory?
Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Particle podcast episode directory like any built-in tool.
How much does Particle podcast episode directory cost in Codex?
$0.00873 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 episode directory in Codex?
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 Codex?
About two minutes: add the hosted server, then sign in.
Does Codex wait while Particle podcast episode directory runs?
Particle podcast episode directory runs in the background. Codex 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.
Start using Particle podcast episode directory in Codex
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Codex:
set up https://spiral.ai/SKILL.md


