podfetcher-tools

SDK + CLI + MCP server for the Podfetcher backend data-plane API.

Features

• Shared SDK for API auth, requests, and error handling
• CLI for show search, episode lookup, and transcript fetch
• MCP server exposing the same operations as tools

Requirements

• Node.js 20+
• A valid Podfetcher API key (X-API-Key)

Install

Install globally from npm to use the podfetcher and podfetcher-mcp commands anywhere:

npm install -g podfetcher-tools

Then verify:

podfetcher --help

Configuration

Environment variables:

• PODFETCHER_BASE_URL (default https://api.podfetcher.com)
• PODFETCHER_API_KEY (required, format: pk_live_...)
• PODFETCHER_API_KEY_HEADER (default X-API-Key)

CLI flags can override env values:

• --base-url
• --api-key
• --api-key-header
• --timeout-ms

CLI Usage

Search shows

node src/cli.js shows search --q "ai" --limit 5

List episodes for a show

node src/cli.js shows episodes --show-id pi_1001 --order-by publishedAt --order desc --limit 10

Fetch transcript for an episode

node src/cli.js transcripts fetch --episode-id ep_pi_1001_004

Fetch transcript and wait until READY

node src/cli.js transcripts fetch \
  --episode-id ep_pi_1001_002 \
  --wait \
  --poll-interval-ms 1000 \
  --wait-timeout-ms 60000

Machine-readable JSON output

node src/cli.js shows search --q "ai" --json

MCP Usage

Run the MCP server over stdio:

node src/mcp.js

Available tools:

• search_shows
• list_episodes
• fetch_transcript

Example MCP server config snippet:

{
  "mcpServers": {
    "podfetcher": {
      "command": "node",
      "args": ["/absolute/path/to/clients/podfetcher-tools/src/mcp.js"],
      "env": {
        "PODFETCHER_API_KEY": "pk_live_..."
      }
    }
  }
}