# Podcast Robot — the Podcast Index MCP server (proof of concept)

**Connect any MCP client to `https://podcastindexrobot.com/mcp`.** No setup, no key.
Streamable HTTP, stateless. Works today in Claude (all plans, phone too), Le Chat (all plans, phone too), Gemini
(US personal accounts, phone too), Grok (SuperGrok), Perplexity (Pro+, phone too), ChatGPT (Pro read-only or Business/
Enterprise/Edu, Plus unclear, web only), Manus, OpenClaw, Muse Code and any MCP client. Not yet: the Meta Muse app,
consumer Microsoft Copilot. Step-by-step, plans and phone-app support on the landing page.
Claude Code: `claude mcp add --transport http podcast-robot https://podcastindexrobot.com/mcp`.

Podcast Robot makes an AI assistant smart about podcasts: discovery, serendipity, people, places,
podrolls, clips with jump links, "what's new", live streams, Value4Value — on top of
[Podcast Index](https://podcastindex.org) (4+ million feeds), the
[Podcasting 2.0 namespace](https://github.com/Podcastindex-org/podcast-namespace) and
[Podping](https://podping.org). Say **"start here"** to your assistant for a live menu.

## Tools (24)

| Tool | What it does |
|---|---|
| `start_here` | A live menu of things to try right now (live show, trending, fresh clip, near you, newest V4V show, just updated) |
| `search_podcasts` | Find shows by words or title; filter by medium, Value4Value, clean |
| `search_people` | Episodes a person appears in, across the index (person tags + text) |
| `get_podcast` / `get_episodes` / `get_episode` | Show and episode records by id, GUID, URL or iTunes id |
| `trending` / `surprise_me` / `recent` | What is hot, random picks, newest episodes / feeds / value feeds / soundbites |
| `live_now` | Streams live right now |
| `whats_new` | New episodes + live status for the feeds you follow since a time |
| `podping_events` / `feed_activity` | Real-time update / live / liveEnd signals from Podping (last 48 h kept) |
| `feed_tags` | The full Podcasting 2.0 view of a feed: persons, location, podroll, funding, value, live items… |
| `podroll_walk` / `recommendations` / `most_recommended` | Discovery by trust: live podroll walks and the index-wide recommendation graph |
| `podcasts_near` | Shows made in or about a place (18,000 location-tagged feeds; name, radius, country) |
| `get_clips` / `transcript_search` / `make_clip` | Soundbites, chapters, transcript search and shareable clip references with `#t=start,end` links |
| `value_info` | How to support a show: Value4Value splits and funding links |
| `grade_feed` | Ask Engine Optimization report: which tags a feed is missing, what each unlocks, and the adoption percentile |
| `copycat_feeds` / `copycat_hosts` | Copy-cat and lookalike feeds for a show (which side is the original, label, confidence, signals in plain words) and who-copies-whom counts per hosting company, from the Podcast Index lookalike detector's daily export |
| `index_stats` | How big podcasting is: totals, active feeds, Podcasting 2.0 adoption, top hosts |

Prompts (9): Start here, Surprise me, What's new for me, Podcasts near me, Grade my feed, Clip this moment,
Who is this person?, Walk the podroll, Discover a topic. Resources: `pi://categories`, `pi://stats`,
`pi://podping/status`, `pi://datasets/status`.

Every result ends with `hints`: 2-3 follow-up calls that chain into other tools. Errors come back as
`{"error": "..."}` with the cause.

## Preferences and app links (stateless)

Every tool accepts `prefs`: `{"app": "fountain", "city": "Austin", "follows": ["41504"], "topics": [...], "language": "en",
"clean_only": false, "v4v_only": false}`. The agent keeps these in its own memory; the server stores nothing.
`start_here` returns an onboarding checklist until they are set. With `prefs.app`, every show and episode carries
`open.app` (a link in the owner's app), `open.universal` (`/open/<feedId>[/<episodeId>]`, a page offering every app)
and `open.podcastindex`.

| App | Show link | Episode deep link |
|---|---|---|
| Fountain | Podcast Index id | **yes** (Podcast Index episode id) |
| Breez | feed URL | **yes** (feed URL + episode GUID) |
| Podcast Addict | feed URL | **yes** (enclosure URL) |
| Podfriend | Apple id | **yes** (Apple id + GUID) |
| Steno.fm | podcast GUID | **yes** (GUIDs) |
| Castamatic | podcast GUID | no (own ids) |
| Podverse | Podcast Index id | no (own ids) |
| CurioCaster | Podcast Index id | no |
| Podcast Guru | Apple id | no |
| Apple Podcasts | Apple id | no (own ids) |
| Overcast | Apple id | no |
| Pocket Casts | Apple id | no |
| Castro | Apple id | no |
| AntennaPod | feed URL | no |
| TrueFans | podcast GUID | no |
| YouTube Music | feed URL | no |
| Spotify | **none** | none (closed ids) |

Patterns: [Podcastindex-org/podcast-platform-links](https://github.com/Podcastindex-org/podcast-platform-links).

## Fair use

Free during the test, no key. Limit: **60 requests per minute per IP** (burst 30); above that you get HTTP 429
with `Retry-After`. Do not poll in tight loops: Podping events arrive within seconds, so once a minute is plenty.

## Payment

Payment-ready, payment-off. Price table at zero; a rail-neutral HTTP 402 step (x402, Stripe MPP,
Lightning L402 stubs) can gate individual tools later with no client change.

## Run it yourself

```
uv venv && uv pip install -e ".[dev]"
printf 'PODCASTINDEX_API_KEY=...\nPODCASTINDEX_API_SECRET=...\n' > .pi.env && chmod 600 .pi.env
python -m pimcp --http          # http://127.0.0.1:8787/mcp
pytest                          # unit tests offline; live tests need .pi.env
```

Deploy: `deploy/install.sh` (Ubuntu 24.04 + Caddy + systemd). Plan: `PLAN.md`. Demo script: `DEMO.md`.
Steps: `LOG.md`. Tester feedback: `feedback/`.
