MCP server/cloud

Ploi MCP Server

Integrates Ploi.io API functionality into AI assistants for managing servers

★ 3sudanese/ploi-mcp ↗by sudaneseupdated
Manual setup required. The maintainer's config contains paths only you know - edit the placeholders below before adding it to Claude Code.
1

Prepare the server locally

Run this once before adding it to Claude Code.

npm install -g ploi-mcp
2

Register it in Claude Code

claude mcp add -e "PLOI_API_TOKEN=${PLOI_API_TOKEN}" ploi-mcp -- ploi-mcp --token YOUR_TOKEN

Replace any placeholder paths in the command with the real path on your machine.

Required:PLOI_API_TOKEN
3

Make your agent remember this setup

ploi-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session. 

npx conare@latest

Free · one command · indexes the sessions already on disk. Set up in the browser instead →

What it does

  • One-command deployments with auto-wait functionality
  • Project linking to Ploi sites via .ploi.json
  • Full server management including listing, restarting, and log retrieval
  • Comprehensive site management (deploy, suspend, resume, logs)
  • Database management including listing and creating backups

Tools 16

deploy_projectDeploy current project and wait for completion
init_projectLink project to a Ploi site by domain
get_project_deploy_statusCheck deployment status
list_serversList all servers
get_serverGet server details
restart_serverRestart a server
get_server_logsGet server logs
list_sitesList sites on a server
get_siteGet site details
deploy_siteDeploy a site and wait for completion
get_site_logsGet deployment logs
suspend_siteSuspend a site
resume_siteResume a suspended site
find_site_by_domainSearch for a site by domain
list_databasesList databases on a server
create_database_backupCreate a database backup

Environment Variables

PLOI_API_TOKENrequiredAPI token from ploi.io/profile/api-keys

Try it

→Deploy
→Link this project to mydomain.com
→List my servers
→Restart the server
→Create a backup of the production database
Original README from sudanese/ploi-mcp

Ploi MCP Server

An MCP (Model Context Protocol) server that exposes Ploi.io API functionality as tools for AI assistants like Claude.

Deploy your sites with a simple "deploy" command - no clicking around in dashboards!

Features

  • One-command deployments - Just say "deploy" and watch it happen
  • Auto-wait - Deployments wait for completion and report success/failure
  • Project linking - Link projects to Ploi sites with .ploi.json
  • Full server management - List, restart, view logs
  • Site management - Deploy, suspend, resume, view logs
  • Database management - List databases, create backups

Installation

Option 1: Global Install (Recommended)

npm install -g ploi-mcp

Option 2: No Install (using npx)

Skip installation - npx will download and run it automatically when configured.

Quick Start

Step 1: Get your API token

Get your token from ploi.io/profile/api-keys

Step 2: Configure Claude Code

Add to ~/.claude.json:

If you installed globally:

{
  "mcpServers": {
    "ploi": {
      "type": "stdio",
      "command": "ploi-mcp",
      "args": ["--token", "YOUR_TOKEN"]
    }
  }
}

If using npx (no install):

{
  "mcpServers": {
    "ploi": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "ploi-mcp", "--token", "YOUR_TOKEN"]
    }
  }
}

Step 3: Restart Claude Code

Close and reopen Claude Code for the MCP server to load.

Step 4: Link your project

In Claude Code, say:

"Link this project to mydomain.com"

Step 5: Deploy anytime

Just say:

"deploy"

That's it! The deployment will run and notify you when complete.

Configuration

Claude Code

Add to ~/.claude.json:

{
  "mcpServers": {
    "ploi": {
      "type": "stdio",
      "command": "ploi-mcp",
      "args": ["--token", "YOUR_TOKEN"]
    }
  }
}

Or using environment variable:

{
  "mcpServers": {
    "ploi": {
      "type": "stdio",
      "command": "ploi-mcp",
      "env": {
        "PLOI_API_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Claude Desktop

Add to config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "ploi": {
      "command": "ploi-mcp",
      "args": ["--token", "YOUR_TOKEN"]
    }
  }
}

Usage

Command Line Options

ploi-mcp --token YOUR_TOKEN
ploi-mcp -t YOUR_TOKEN
PLOI_API_TOKEN=YOUR_TOKEN ploi-mcp

Project Setup

Link a project to its Ploi site for one-command deployments:

"Link this project to mydomain.com"

This creates .ploi.json in your project:

{
  "server_id": 12345,
  "site_id": 67890
}

Now just say "deploy" and it will:

  1. Trigger deployment
  2. Wait for completion (polling every 5 seconds)
  3. Report success or failure

Available Tools

Project Tools

Tool Description
deploy_project Deploy current project and wait for completion
init_project Link project to a Ploi site by domain
get_project_deploy_status Check deployment status

Server Management

Tool Description
list_servers List all servers
get_server Get server details
restart_server Restart a server
get_server_logs Get server logs (auth, error, lastlog, syslog)

Site Management

Tool Description
list_sites List sites on a server
get_site Get site details
deploy_site Deploy a site and wait for completion
get_site_logs Get deployment logs
suspend_site Suspend a site
resume_site Resume a suspended site
find_site_by_domain Search for a site by domain

Database Management

Tool Description
list_databases List databases on a server
create_database_backup Create a database backup

Example Commands

"List my servers"
"Deploy"
"Deploy mydomain.com"
"Link this project to staging.mydomain.com"
"Show deployment logs"
"Restart the server"
"Create a backup of the production database"

Development

git clone https://github.com/sudanese/ploi-mcp.git
cd ploi-mcp
npm install
npm run build
npm link

License

MIT

Frequently Asked Questions

What are the key features of Ploi MCP Server?

One-command deployments with auto-wait functionality. Project linking to Ploi sites via .ploi.json. Full server management including listing, restarting, and log retrieval. Comprehensive site management (deploy, suspend, resume, logs). Database management including listing and creating backups.

What can I use Ploi MCP Server for?

Automating deployment workflows directly from the IDE or chat interface. Quickly checking server or deployment logs without switching to a browser. Managing multiple server environments through natural language commands. Triggering database backups before performing maintenance tasks.

How do I install Ploi MCP Server?

Install Ploi MCP Server by running: npm install -g ploi-mcp

What MCP clients work with Ploi MCP Server?

Ploi MCP Server works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Conare · memory for coding agents

Turn this server into reusable context

Keep Ploi MCP Server docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Set up free$npx conare@latest

Related MCP Servers

SSH MCP Server
Execute shell commands on remote Linux and Windows systems via SSH.
cloud655 stars
Remnawave MCP
Manage Remnawave VPN panels with 51 specialized tools for administration.
cloud86 stars
Hono MCP Server
Expose your Hono API endpoints as MCP tools.
cloud86 stars
n8n Manager for AI Agents
Manage n8n workflow automation instances through AI agent tools.
cloud62 stars
App Store Connect MCP
A Model Context Protocol server for the App Store Connect API.
cloud61 stars
Kilntainers
Give Every Agent an Ephemeral Linux Sandbox — via MCP
cloud50 stars