Use Pyplex from AI assistants (MCP)
Connect Claude, ChatGPT, Cursor and other AI tools to Pyplex — ask in chat, see the price, approve, and get your image, video or audio right in the conversation.
Pyplex has an MCP server and a ready-made skill, so AI assistants can work with Pyplex for you. Ask in your own words — "put a red car behind me in this photo", then "now make a video of me opening the door" — and the assistant picks the model, writes the prompt, shows the exact price and starts only after you say yes. For a bigger job, like a whole video, it shows one plan with every paid step and the total — you say yes once, and it makes all of it. It can also edit your clips into one video, or make an animated graphic, and open it in the Pyplex Editor for you.
| Address (the same for every app) | https://pyplex.com/api/mcp/account |
| Sign-in | Once, when you add Pyplex — sign in to Pyplex and press Allow |
| Transport | Streamable HTTP |
Connect
- Claude (web, desktop, mobile): Customize → Connectors → Add custom connector. Use the settings in the table below, press Add, then sign in to Pyplex and press Allow. That's the only time you sign in.
- Claude Code: run claude mcp add --transport http pyplex https://pyplex.com/api/mcp/account then /mcp to sign in.
- ChatGPT (where custom connectors are available on your plan): add a custom connector with https://pyplex.com/api/mcp/account → sign in → Allow.
- Codex: run codex mcp add pyplex --url https://pyplex.com/api/mcp/account then codex mcp login pyplex (a browser opens — sign in and press Allow).
- Cursor, VS Code and other MCP apps: add a server of type "http" with https://pyplex.com/api/mcp/account, and sign in to Pyplex once when the app asks.
Claude: which settings to pick
| Setting | Pick | Why |
|---|---|---|
| MCP server URL | https://pyplex.com/api/mcp/account | Asks you to sign in once, while you add Pyplex. |
| Authentication | Sign in now | Claude usually picks it by itself for this address. Don't pick "No sign-in" — your balance, generations and edits won't work. |
| OAuth client | Register automatically | Pyplex registers Claude by itself. "Use Claude's published identity" and "Use your own OAuth client" aren't supported by Pyplex yet. |
| Request headers | Leave empty | Pyplex uses sign-in, not an API key. |
You connect once. Claude keeps you signed in and renews access by itself, so you won't be asked again — unless you press Disconnect (Dashboard → Connected apps), remove the connector, or don't use it for 30 days. ChatGPT and Claude Code work the same way. Codex normally renews by itself too, but some Codex versions forget to — if Codex says Pyplex needs sign-in, run codex mcp login pyplex again and press Allow.
Install the Pyplex skill (optional, recommended)
The skill teaches your assistant the Pyplex way of working: which model fits which job, how to write good prompts, how to chain a photo into a video, and the price-and-yes rule — and how to plan and edit a whole video like a professional editor (the hook, the story, shots and camera moves, pacing, transitions, text, music), with step-by-step playbooks for Reels, product ads, short stories, music videos, explainers, slideshows and "a video like this one". It comes with the connector in one plugin.
Download it from pyplex.com/downloads/pyplex-plugin.zip, or get it on GitHub: github.com/Pyplex-com/pyplex-skill.
- Claude (web, desktop): Customize → Plugins → Add → Upload plugin, pick pyplex-plugin.zip, then connect Pyplex on the plugin's Connectors tab.
- Claude Code: run claude plugin marketplace add Pyplex-com/pyplex-skill then claude plugin install pyplex@pyplex and /mcp to sign in. (From the zip: unzip it and use claude plugin marketplace add ./pyplex-plugin instead.)
- Codex: unzip it to a folder, run codex plugin marketplace add ./pyplex-plugin then codex plugin add pyplex@pyplex and codex mcp login pyplex.
- Cursor and other agents with skills: unzip it and add the skills/pyplex folder to your agent's skills folder.
What the assistant can do
| Tool | What it does | Needs sign-in |
|---|---|---|
| search_models / get_model | Find a model and read all its settings. | No |
| get_price | The exact price for chosen settings. | No |
| search_templates / get_template | Find templates and what they need. | No |
| read_docs | Read these docs. | No |
| get_balance | Your balance, money on hold and earnings. | Yes |
| list_my_generations | Your latest results, to show or reuse. | Yes |
| request_upload_link / check_upload | A link where you add your own photo, video or audio on pyplex.com. | Yes |
| quote_generation | Checks the settings and gives the exact price. Nothing is charged. | Yes |
| start_generation | Starts it and charges the quoted price — only after your yes, to that price or to a plan that lists it. | Yes |
| get_generation | Progress and the finished file. Failed ones are refunded. | Yes |
| create_video_edit | Puts your clips together into one video — order, cuts, text on screen, music, transitions — and gives you an Open in Editor link. Free; exporting in the Editor costs $0.10. | Yes |
| create_motion_design | Makes an animated graphic — title card, ad, lower third, logo reveal, social hook — from a template or from layers, and gives you an Open in Motion Design link. Free; exporting costs $0.10. | Yes |
| get_preview_link | Gives the assistant a view-only link to one of your edits or motion designs, so it can look at its own work without signing in. Only your own designs; the link lasts as long as the design (30 days). Free. | Yes |
How a paid generation works
- You ask for something. The assistant picks a model and writes the prompt.
- It checks the price with quote_generation. You see the model and the exact price in a Pyplex card in the chat. Nothing is charged yet.
- You say yes, or press Generate on the card. For a bigger job, one yes to the assistant's plan covers every step on it, as long as no step costs more than the plan said. The assistant must send the quoted price exactly, or Pyplex refuses to start.
- The price is held from your balance, the same as on the website. The card shows progress and then your image, video or audio, with Download.
- Everything is saved in your Library. If a generation fails you are not charged.
Edit a video with the assistant
- Make the clips first (photos, videos, music) — or use ones you already have in your Library or added with an upload link.
- Tell the assistant what you want: the order, how long each part is, the words on screen, the music, the transitions, the shape (for example 9:16 for Reels).
- It builds the edit with create_video_edit. This is free. A Pyplex card in the chat shows the clips and an Open in Editor button (or the assistant gives you the link).
- The Pyplex Editor opens with everything on the timeline. Watch it, change anything you like, then Export — $0.10, made in your browser.
- Want changes? Ask the assistant — it makes a new version with a new link.
Edit links open only for the Pyplex account you connected, and work for 30 days. Files you added with an upload link are kept for 30 days.
Make a motion graphic with the assistant
Ask for an animated title, ad, lower third, logo reveal or social-media hook. The assistant either fills one of the Motion Design templates with your words and brand colour, or builds it from layers — text, shapes, lines and your photos or videos — with entrance, exit and looping animations. It can also move things along keyframes, draw a line on screen, count a number up (0 → 12,500), move the camera and add music. When you ask for a whole video, the assistant can put these animated graphics — a title, a counting stat, an end card — straight onto the same video timeline, so you get one project with everything in it. It makes the design with create_motion_design (free) and gives you an Open in Motion Design link. Watch it, change anything, and export it there ($0.10).
Your own photos and videos
A file you attach in the chat can't be passed to Pyplex. The assistant gives you an upload link instead: open it, add the file (you're signed in to your own account), and come back — the card notices by itself, or just say "done". The assistant can also use a public https link, or any earlier Pyplex result as the input for the next step (for example a photo into a video).
If your balance is low
The price check tells the assistant your balance isn't enough. It tells you and gives you a link to your Pyplex wallet with the amount already filled in (minimum top-up $10). After you add money, ask again.
Safety
- The assistant never sees your password, email or payment details. It can't top up, withdraw or change your account.
- Nothing is charged without your yes — to one price, or to a plan that lists every paid step and the total. Daily spending limits from the website apply here too.
- See and disconnect apps any time: Dashboard → Connected apps. It stops working at once.
- Only allow apps you trust. The Allow page shows which site you'll be sent back to, and warns you about apps that run on your own computer.
Prompts of templates are never shared. A plain-text version of all docs is at pyplex.com/llms.txt.