{ "markdown": "\"\"\n\n# PodMule plugin\n\nConnect your agent to your own [PodMule](https://podmule.com) podcast workspace — shows, episodes, transcripts, the knowledge base built from your back catalogue, clips, guest CRM and interview bookings.\n\nThe plugin bundles two things: a reference to PodMule's remote MCP server, and five skills that tell your agent when to use which part of it. Connecting without the skills gives you three tools and no idea how to drive them.\n\n**You need a PodMule workspace.** This plugin talks to your data; it does nothing on its own. You sign in with your normal PodMule account the first time your agent connects — there is no API key to copy. If you don't have an account yet, start at [podmule.com](https://podmule.com).\n\nConnector URL: `https://app.podmule.com/mcp` · Full setup guide: [app.podmule.com/mcp-setup](https://app.podmule.com/mcp-setup)\n\n## Install\n\nEverywhere except Claude Code, the whole install is the repo name — `Squared-Lemons-Ltd/podmule-plugin` — pasted into a Plugins settings screen.\n\n### Claude Code\n\n```\n/plugin marketplace add Squared-Lemons-Ltd/podmule-plugin\n/plugin install podmule@podmule\n```\n\nThen `/mcp` and sign in. A browser window opens for PodMule's consent screen; if you belong to more than one workspace you pick which one the connection uses.\n\n> Non-interactive sessions (`claude -p`, the Agent SDK) cannot complete the OAuth flow and will report the tools as unavailable. Authorise once from an interactive session first.\n\n### Claude Desktop, ChatGPT and Codex\n\nAll three take the repo name directly. Open the **Plugins** section, choose **Add custom**, and enter:\n\n```\nSquared-Lemons-Ltd/podmule-plugin\n```\n\nThen install **PodMule** and sign in. One package, read by all of them.\n\n> The ChatGPT **chat** surface is a separate thing and is not reachable this way — it needs a connector ID minted by your own developer-mode registration, which no distributable package can carry.\n\n### One click, other surfaces\n\n[![Add to Cursor](https://img.shields.io/badge/Cursor-Add_PodMule-000000?style=flat-square&logo=cursor&logoColor=white)](cursor://anysphere.cursor-deeplink/mcp/install?name=podmule&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYXBwLnBvZG11bGUuY29tL21jcCJ9)\n[![Add to VS Code](https://img.shields.io/badge/VS_Code-Add_PodMule-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=podmule&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapp.podmule.com%2Fmcp%22%7D)\n[![Add to VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Add_PodMule-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=podmule&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapp.podmule.com%2Fmcp%22%7D&quality=insiders)\n[![Add to LM Studio](https://files.lmstudio.ai/deeplink/mcp-install-light.svg)](lmstudio://add_mcp?name=podmule&config=eyJ1cmwiOiJodHRwczovL2FwcC5wb2RtdWxlLmNvbS9tY3AifQ==)\n[![Add to Replit](https://img.shields.io/badge/Replit-Add_PodMule-F26207?style=flat-square&logo=replit&logoColor=white)](https://replit.com/integrations?mcp=eyJkaXNwbGF5TmFtZSI6IlBvZE11bGUiLCJiYXNlVXJsIjoiaHR0cHM6Ly9hcHAucG9kbXVsZS5jb20vbWNwIn0=)\n[![Add to Goose](https://img.shields.io/badge/Goose-Add_PodMule-2D8C7F?style=flat-square)](goose://extension?url=https%3A%2F%2Fapp.podmule.com%2Fmcp&type=streamable_http&id=podmule&name=PodMule&description=Search%2C%20draft%20and%20manage%20your%20podcast%20workspace.)\n\nThese add the MCP connection only — the skills come with the plugin package, so Claude Code and ChatGPT desktop get more out of it.\n\n### Anything else\n\nAny MCP client that speaks Streamable HTTP with OAuth can point at the URL directly:\n\n```json\n{\n \"mcpServers\": {\n \"podmule\": {\n \"type\": \"http\",\n \"url\": \"https://app.podmule.com/mcp\"\n }\n }\n}\n```\n\n`\"type\"` is not optional. Claude Code reads a `url` entry without it as a stdio server, skips it, and errors.\n\n## What the skills do\n\n| Skill | Ask it |\n|---|---|\n| `find-in-back-catalogue` | \"Which episodes discuss burnout?\" · \"Find the exact quote and timestamp.\" |\n| `draft-clips` | \"Draft clips from Tuesday's episode.\" |\n| `interview-brief` | \"Brief me on my next guest.\" |\n| `episode-writeup` | \"Generate show notes and titles for episode 42.\" |\n| `workspace-triage` | \"What needs my attention today?\" |\n\n`find-in-back-catalogue` is read-only and the best first thing to try. The clip and write-up skills change your workspace, so they ask before doing so.\n\n## Repo layout\n\n```\n.claude-plugin/marketplace.json the catalog, read by both Claude and ChatGPT desktop\nplugins/podmule/\n .claude-plugin/plugin.json Claude manifest\n .codex-plugin/plugin.json Codex/ChatGPT manifest\n .mcp.json the connector declaration, shared by both\n skills/ five skills, shared by both\n assets/ brand mark, taken from the PodMule marketing site\nserver.json the official MCP registry entry\nscripts/check-manifests.mjs structural checks on the manifests\nscripts/check-capability-drift.mjs fails when a skill names a capability that no longer exists\n```\n\nBoth manifests point at one skills directory and one `.mcp.json`, so the two ecosystems can never drift apart in content — only in the presentation fields each one reads.\n\n## Checks\n\n```\nnode scripts/check-manifests.mjs\nnode scripts/check-capability-drift.mjs\n```\n\nThe drift check reads PodMule's public capability list and fails if a skill mentions something the server no longer registers. It needs no credentials, and runs in CI on every push and pull request. Renaming a capability in the product is exactly the kind of change that otherwise breaks installed guidance silently.\n\n## Licence\n\nMIT — see [LICENSE](LICENSE).\n", "bytes": 5976, "sha": "b813f0f4947a2026d3f06e0265c4fd68f80ed7b630cbabdc63f7d732ae897949", "repo_slug": "squared-lemons-ltd/podmule-plugin", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_com_podmule_podmule_6de72de1/readme" }