io.github.plyo-dev/plyo-mcp
Save, publish, restore and back up AI-built projects on Plyo, for people who build with AI.
Open source Open in the app JSON README (API)
About
Save, publish, restore and back up AI-built projects on Plyo, for people who build with AI.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- plyo-dev
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.4.3
- Last push
- 2026-09-01T07:36:00Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 20:00:32
- Updated
- 2026-08-29 20:00:32
- Origin id
io.github.plyo-dev/plyo-mcp
README
# plyo-mcp
MCP server for [Plyo](https://plyo.dev) — the home for AI-built projects. Every version saved, one click to undo, one click to publish, plus a security check before going live, visitor stats, health monitoring and database backups. Built for people who build with AI and don't code; this server is how their AI does the technical part.
## Setup
Claude Code, one line:
```bash
claude mcp add plyo -e PLYO_TOKEN=plyo_xxx -- npx plyo-mcp
```
Any other MCP client:
```json
{
"mcpServers": {
"plyo": {
"command": "npx",
"args": ["plyo-mcp"],
"env": { "PLYO_TOKEN": "plyo_xxx" }
}
}
}
```
`PLYO_TOKEN` is an AI key from the Plyo dashboard (Settings → AI keys → "Give your AI a key"). New here? Plyo is free to start. [plyo.dev](https://plyo.dev/?utm_source=mcp-readme&utm_medium=agent&utm_campaign=mcp-dir) has the full picture; setup lives at [plyo.dev/connect.html](https://plyo.dev/connect.html).
After setup, the user says: **"I've added Plyo. Save this project there and keep saving as we go."** That's the whole integration.
## Tools
| Tool | What it does |
|---|---|
| `create_project` | Create a Plyo project and link the current folder to it |
| `link_project` | Link the current folder to an existing project by slug |
| `save_checkpoint` | Save the current state to the project's timeline (pass `intent`: one sentence on what the user asked for; it powers timeline search) |
| `publish` | Publish the latest checkpoint to the live URL; on failure returns a plain-English cause and a fix you can act on |
| `get_build_error` | Latest build status; if it failed, the translated error and fix guidance |
| `start_draft` | Safe copy of the project to try changes without touching the live version |
| `restore` | Return to an earlier checkpoint; never destructive, history is kept |
| `get_timeline` | Recent checkpoints with what changed in each |
| `backup_data` | Snapshot the project's database and storage files before risky data changes |
| `list_projects` | The user's projects with names, slugs and live URLs |
## Notes for agents
- Call `save_checkpoint` after each completed piece of work, with a one-sentence `intent`.
- Call `backup_data` before schema migrations, bulk updates or deletions.
- Errors come back plain and actionable: publish and build failures include what went wrong and what to change.
- Under the hood every project is a real git repository; Plyo also accepts plain `git push` at `https://git.plyo.dev/{slug}.git` (username `plyo`, the AI key as password).
- A failed publish never takes a live site down.
MIT · [plyo.dev](https://plyo.dev) · hello@plyo.dev
mcp-name: io.github.plyo-dev/plyo-mcp