Skip to content
Back to search

ppl-xyz

MarketplaceWorks with Claude CodeGitHub

PPL for AI assistants: the PPL connector (MCP), skill and Claude Code plugin. Make AI series and videos with your own characters.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 21 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/pplxyz/ppl-mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/pplxyz/ppl-mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/pplxyz--ppl-mcp/badge.svg)](/listings/pplxyz--ppl-mcp)

HTML

<a href="/listings/pplxyz--ppl-mcp"><img src="/api/listings/pplxyz--ppl-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 17 lines
  1. {
  2. "name": "ppl-xyz",
  3. "owner": {
  4. "name": "PPL",
  5. "url": "https://ppl.xyz"
  6. },
  7. "metadata": {
  8. "description": "PPL for AI assistants: the PPL connector and skill."
  9. },
  10. "plugins": [
  11. {
  12. "name": "ppl",
  13. "source": "./plugins/ppl",
  14. "description": "Create and manage AI series and videos on PPL (ppl.xyz) with your own characters: the PPL connector and the skill that teaches an assistant to use it."
  15. }
  16. ]
  17. }
README.md · README · 68 lines
  1. # PPL for AI assistants
  2. Connect an AI assistant to your PPL account so it can create and manage your
  3. series and videos with you. This folder holds what an assistant needs:
  4. - the PPL connector's address: `https://api.ppl.xyz/mcp`
  5. - the official MCP Registry entry (`server.json`)
  6. - the PPL skill (`plugins/ppl/skills/ppl/`), which teaches an assistant how
  7. PPL works: reading a series, writing a prompt, pricing it, rendering a
  8. draft, and what needs your say-so
  9. - a Claude Code plugin and marketplace entry that install both together
  10. - a Cursor configuration file
  11. You approve each assistant in the PPL app, choose what it may do and how many
  12. gems it may spend a day, and can disconnect it at any time in PPL › Settings ›
  13. Connected Apps.
  14. The skill and its tool list are generated from the PPL server
  15. (`pnpm run build:connected-apps-skill` in ppl-backend). Do not edit them by
  16. hand.
  17. ## Claude (claude.ai, desktop and mobile)
  18. **[Add PPL to Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=PPL&connectorUrl=https%3A%2F%2Fapi.ppl.xyz%2Fmcp%3Fref%3Dgithub)**:
  19. the link opens Claude's "Add custom connector" dialog with PPL filled in.
  20. Choose Add, sign in when asked, and approve the connection in the PPL app
  21. (or on ppl.xyz with Google). Works on every Claude plan; the Free plan
  22. allows one custom connector.
  23. By hand: Customize › Connectors › "+ Add" › "Add custom connector", name
  24. `PPL`, address `https://api.ppl.xyz/mcp`.
  25. On a Team or Enterprise plan an owner adds it under Organization settings ›
  26. Connectors.
  27. Add the skill (optional, recommended): zip the `plugins/ppl/skills/ppl`
  28. folder and upload it under Customize › Skills › "+" › "Create skill" ›
  29. "Upload a skill", or install it with `npx skills add pplxyz/ppl-mcp`.
  30. ## Claude Code
  31. ```
  32. /plugin marketplace add pplxyz/ppl-mcp
  33. /plugin install ppl@ppl-xyz
  34. ```
  35. The plugin adds the connector and the skill. Once connected, PPL's
  36. workflows show up as slash commands named after the server, for example
  37. `/mcp__ppl__next_episode`, `start_series`, `pilot_week`, `whats_working`
  38. and `find_crossover`. Sign in from `/mcp` if Claude Code does not ask on
  39. its own.
  40. ## Cursor
  41. Copy `cursor/mcp.json` to `.cursor/mcp.json` in a project, or to
  42. `~/.cursor/mcp.json` to use it everywhere, then sign in when Cursor asks.
  43. ## ChatGPT
  44. In ChatGPT, add a custom MCP server with the address
  45. `https://api.ppl.xyz/mcp` and sign in with OAuth. Where this setting lives
  46. depends on your plan and may require developer mode.
  47. ## License
  48. The files in this folder (the skill, the plugin and the configuration) are
  49. MIT licensed: see `LICENSE`. The PPL service they connect to is not; using
  50. it is subject to PPL's Terms (https://ppl.xyz/terms).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.