Podwise README

Podwise Plugin

Turn podcast episodes into AI-powered insights from inside Claude Code, Cursor, Codex and ChatGPT. This plugin bundles the Podwise Agent Skill with the remote Podwise MCP server (https://mcp.podwise.ai/mcp), so installing the plugin wires everything up.

In short: a podcast MCP server for AI agents. Point any MCP client at https://mcp.podwise.ai/mcp and it can search podcasts and episodes, pull a full transcript, read the AI summary, chapters, highlights, Q&A and mind map, ask questions across transcripts, translate an episode, clip key moments, and export notes as Markdown or SRT. The skill teaches your agent how to combine those tools into repeatable workflows.

What's included

Workflows

The skill routes your intent automatically:

MCP server and tools

Endpoint: https://mcp.podwise.ai/mcp — Streamable HTTP, OAuth 2.0. No API key lives in this repository. Listed on the official MCP Registry as io.github.hardhackerlabs/podwise (see server.json).

38 tools, grouped:

Full parameter reference: skills/podwise/references/mcp.md.

Install

Claude Code

/plugin marketplace add hardhackerlabs/podwise-plugin
/plugin install podwise@podwise

Then authenticate the MCP server when prompted (OAuth runs in your browser via /mcp).

Cursor

Open Customize → Plugins → Add → From GitHub Repository and import this repository as a marketplace (use the full URL):

https://github.com/hardhackerlabs/podwise-plugin

Then click Add on podwise and authenticate the MCP server when prompted (Customize → Plugins → podwise → Authenticate).

Once Podwise is listed in the Cursor Marketplace, you can also install it from any agent chat:

/add-plugin podwise

The MCP server alone is also available as a one-click install from cursor.directory.

Codex / ChatGPT

codex plugin marketplace add hardhackerlabs/podwise-plugin
codex plugin add podwise@podwise

Then complete the OAuth flow when prompted.

Other agents (skills only)

If your agent reads skills directly but does not install plugins, install the skill and add the MCP server manually:

npx skills add hardhackerlabs/podwise-plugin

Then add the server to your MCP configuration. Use the transport name your client expects — http for Claude Code-style clients (as in .mcp.json), streamable-http for Agent Plugins clients (as in mcp.json):

{ "mcpServers": { "podwise": { "type": "http", "url": "https://mcp.podwise.ai/mcp" } } }

Usage

Once the plugin is installed and authenticated, just ask. For example:

• "Catch me up on this week's podcast episodes"
• "Summarize this podcast episode: "
• "Research what podcasts say about "
• "Write my weekly listening recap"
• "Make language-learning cards from this episode's transcript"

The skill checks the connection with get_me first, then routes the request to the matching workflow.

Requirements

• A Podwise account. The MCP server uses OAuth 2.0; no API key is stored in this repository.
• Network access to https://mcp.podwise.ai/mcp.
• Some capabilities require a Podwise Pro or Enterprise plan; the enterprise_* tools are for Enterprise-plan API usage. See podwise.ai for plans.

Remote / SSH note: the host's HTTP MCP OAuth uses a loopback callback, which does not work when the host runs on a machine different from your browser. Use a connection method supported by your host, or see the troubleshooting docs at https://docs.podwise.ai. Do not run third-party proxy commands to work around authentication.

Repository layout

podwise-plugin/                            # this repository is the plugin (source: "./")
├── .claude-plugin/
│   ├── marketplace.json                   # Claude Code marketplace
│   └── plugin.json                        # Claude Code plugin manifest
├── .codex-plugin/plugin.json              # Codex / ChatGPT client manifest
├── .cursor-plugin/
│   ├── marketplace.json                   # Cursor marketplace
│   └── plugin.json                        # Cursor plugin manifest
├── .agents/plugins/marketplace.json       # Codex marketplace
├── plugin.json                            # Portable Agent Plugins manifest
├── mcp.json                               # Remote MCP server config (Agent Plugins, streamable-http)
├── .mcp.json                              # Remote MCP server config (Claude Code and Codex, http)
├── server.json                            # MCP registry manifest (official registry, aggregators)
├── skills/podwise/                        # The Podwise skill
│   ├── SKILL.md
│   ├── references/
│   ├── workflows/
│   └── agents/openai.yaml
└── assets/

The MCP definition is duplicated as mcp.json (portable Agent Plugins, streamable-http) and .mcp.json (referenced by the Claude Code and Codex manifests, http). Keep the transport type matching each platform.

Brand assets

Brand color is #7948E8.

Privacy and support

• Privacy policy: https://podwise.ai/privacy
• Terms of service: https://podwise.ai/terms
• Support and docs: https://docs.podwise.ai

License

MIT © Podwise